Skip to content

Latest commit

 

History

History
134 lines (98 loc) · 4.54 KB

service-accounts.md

File metadata and controls

134 lines (98 loc) · 4.54 KB

WARNING WARNING WARNING WARNING WARNING

PLEASE NOTE: This document applies to the HEAD of the source tree

If you are using a released version of Kubernetes, you should refer to the docs that go with that version.

The latest 1.0.x release of this document can be found [here](http://releases.k8s.io/release-1.0/docs/user-guide/service-accounts.md).

Documentation for other releases can be found at releases.k8s.io.

Service Accounts

A service account provides an identity for processes that run in a Pod.

This is a user introduction to Service Accounts. See also the Cluster Admin Guide to Service Accounts.

Note: This document describes how service accounts behave in a cluster set up as recommended by the Kubernetes project. Your cluster administrator may have customized the behavior in your cluster, in which case this documentation may not apply.

When you (a human) access the cluster (e.g. using kubectl), you are authenticated by the apiserver as a particular User Account (currently this is usually "admin", unless your cluster administrator has customized your cluster). Processes in containers inside pods can also contact the apiserver. When they do, they are authenticated as a particular Service Account (e.g. "default").

Using the Default Service Account to access the API server.

When you create a pod, you do not need to specify a service account. It is automatically assigned the default service account of the same namespace. If you get the raw json or yaml for a pod you have created (e.g. kubectl get pods/podname -o yaml), you can see the spec.serviceAccount field has been automatically set.

You can access the API using a proxy or with a client library, as described in Accessing the Cluster.

Using Multiple Service Accounts

Every namespace has a default service account resource called "default". You can list this and any other serviceAccount resources in the namespace with this command:

$ kubectl get serviceAccounts
NAME      SECRETS
default   1

You can create additional serviceAccounts like this:

$ cat > /tmp/serviceaccount.yaml <<EOF
apiVersion: v1
kind: ServiceAccount
metadata:
  name: build-robot
EOF
$ kubectl create -f /tmp/serviceaccount.json
serviceacccounts/build-robot

If you get a complete dump of the service account object, like this:

$ kubectl get serviceacccounts/build-robot -o yaml
apiVersion: v1
kind: ServiceAccount
metadata:
  creationTimestamp: 2015-06-16T00:12:59Z
  name: build-robot
  namespace: default
  resourceVersion: "272500"
  selfLink: /api/v1/namespaces/default/serviceaccounts/build-robot
  uid: 721ab723-13bc-11e5-aec2-42010af0021e
secrets:
- name: build-robot-token-bvbk5

then you will see that a token has automatically been created and is referenced by the service account.

In the future, you will be able to configure different access policies for each service account.

To use a non-default service account, simply set the spec.serviceAccount field of a pod to the name of the service account you wish to use.

The service account has to exist at the time the pod is created, or it will be rejected.

You cannot update the service account of an already created pod.

You can clean up the service account from this example like this:

$ kubectl delete serviceaccount/build-robot

Adding Secrets to a service account.

TODO: Test and explain how to use additional non-K8s secrets with an existing service account.

TODO explain:

  • The token goes to: "/var/run/secrets/kubernetes.io/serviceaccount/$WHATFILENAME"

Analytics