Join our Discord Server
Tanvir Kour Tanvir Kour is a passionate technical blogger and open source enthusiast. She is a graduate in Computer Science and Engineering and has 4 years of experience in providing IT solutions. She is well-versed with Linux, Docker and Cloud-Native application. You can connect to her via Twitter https://x.com/tanvirkour

Kubernetes Service Account: What It Is and How to Use It

3 min read

Hey there, Kubernetes enthusiasts! 🎉 Let’s dive into something that often flies under the radar until you’re knee-deep in configuring RBAC or securing your pods — Kubernetes Service Accounts. Whether you’re just exploring Kubernetes or deploying complex workloads, understanding service accounts is vital. So, grab a cup of coffee (or tea ☕), and let’s break it down together.


Wait, What’s a Service Account Anyway? 🤔

Imagine you have a pod in Kubernetes, and it needs to talk to the Kubernetes API to fetch secrets, create resources, or do some heavy lifting. How does it authenticate itself? That’s where Service Accounts come in.

In simple terms, a service account is like a user account, but it’s for your pods. Instead of human users typing passwords, service accounts let your pods and controllers securely interact with the Kubernetes API. Think of it as the pod’s ID card in the Kubernetes world.


How Are Service Accounts Different from User Accounts?

Good question! Let’s keep it simple:

  • User Accounts: For people (admins, developers) accessing the cluster.
  • Service Accounts: For applications (pods, controllers) running inside the cluster.

Kubernetes treats them differently because, well, humans and apps have different needs. A service account doesn’t have a password or SSH key but instead uses a token to authenticate.


The Default Service Account: Your Cluster’s Wingman 🚀

Every namespace in Kubernetes comes with a default service account, ready to be your pod’s best buddy. If you don’t explicitly assign a service account to a pod, Kubernetes automatically gives it the default one from the pod’s namespace.

Here’s a fun fact: This is fine for quick-and-dirty setups, but relying on the default service account for production workloads? Not a great idea. You don’t want your pods running around with more permissions than they need. (We’ll talk about that in a bit.)


How to Create Your Own Service Account (Because You Should!)

Creating a service account is as simple as writing a YAML file. Let’s do this step by step.

1. Create a Service Account

Here’s a quick YAML file to define a new service account:

apiVersion: v1
kind: ServiceAccount
metadata:
name: my-service-account
namespace: my-namespace

Save it as service-account.yaml, and create it using:

kubectl apply -f service-account.yaml

Boom! 🎉 You’ve just created a service account.


2. Assign It to a Pod

Now, let’s tie this service account to a pod. Here’s an example:

apiVersion: v1
kind: Pod
metadata:
name: my-pod
namespace: my-namespace
spec:
serviceAccountName: my-service-account
containers:
- name: my-container
image: nginx

Notice the serviceAccountName field? That’s where the magic happens. When this pod spins up, it will use the my-service-account instead of the default one.


Why You Need to Care About Permissions (RBAC to the Rescue!) 🔒

By default, service accounts don’t have permissions to do much. This is a good thing because you don’t want every pod running around your cluster with admin-level access. You can define what a service account is allowed to do using Role-Based Access Control (RBAC).

Here’s how you can give your service account specific permissions:

Step 1: Create a Role

Let’s say you want your service account to list pods in a namespace:

apiVersion: rbac.authorization.k8s.io/v1
kind: Role
metadata:
namespace: my-namespace
name: pod-reader
rules:
- apiGroups: [""]
resources: ["pods"]
verbs: ["get", "list", "watch"]

Step 2: Bind the Role to the Service Account

Use a RoleBinding to connect your service account with the role:

apiVersion: rbac.authorization.k8s.io/v1
kind: RoleBinding
metadata:
name: read-pods-binding
namespace: my-namespace
subjects:
- kind: ServiceAccount
name: my-service-account
namespace: my-namespace
roleRef:
kind: Role
name: pod-reader
apiGroup: rbac.authorization.k8s.io

Apply these files with kubectl apply -f and voilà! Your service account now has the exact permissions it needs — no more, no less.


A Quick Peek Under the Hood 🔍

When a pod uses a service account, Kubernetes mounts a token in the pod’s filesystem (usually under /var/run/secrets/kubernetes.io/serviceaccount). This token is how the pod authenticates with the API server.

Want to see it in action? Try this in your pod:

cat /var/run/secrets/kubernetes.io/serviceaccount/token

Don’t worry — it’s a JWT, and it’s securely verified by Kubernetes.


Pro Tips for Using Service Accounts Like a Pro 💡

  1. Minimize Permissions: Use the principle of least privilege. Only grant the permissions your pod absolutely needs.
  2. Namespace Isolation: Keep service accounts specific to namespaces for better security.
  3. Rotate Tokens: Kubernetes automatically rotates tokens, so you don’t have to worry about token expiration.
  4. Audit Your Roles: Periodically review the permissions you’ve granted to ensure they’re still needed.

When to Use Service Accounts

Here are a few common scenarios where service accounts shine:

  • Pods interacting with the Kubernetes API (e.g., fetching secrets or creating resources).
  • Controllers or operators managing other Kubernetes objects.
  • CI/CD pipelines needing access to deploy or update resources in the cluster.

Wrapping It Up

Service accounts are a powerful, yet often overlooked, feature of Kubernetes. They give your pods a secure way to interact with the Kubernetes API, and with RBAC, you have fine-grained control over what they can do.

So next time you’re deploying a pod that needs access to cluster resources, remember to create a dedicated service account. Your cluster security will thank you! 🛡️

Have questions or tips to share about service accounts? Drop them in the comments — let’s keep the conversation going! 🚀

Have Queries? Join https://launchpass.com/collabnix

Tanvir Kour Tanvir Kour is a passionate technical blogger and open source enthusiast. She is a graduate in Computer Science and Engineering and has 4 years of experience in providing IT solutions. She is well-versed with Linux, Docker and Cloud-Native application. You can connect to her via Twitter https://x.com/tanvirkour
Join our Discord Server
Index