kubectl config set-credentials

Synopsis

Set a user entry in kubeconfig.

Specifying a name that already exists will merge new fields on top of existing values.

  1. Client-certificate flags:
  2. --client-certificate=certfile --client-key=keyfile
  3. Bearer token flags:
  4. --token=bearer_token
  5. Basic auth flags:
  6. --username=basic_user --password=basic_password

Bearer token and basic auth are mutually exclusive.

  1. kubectl config set-credentials NAME [--client-certificate=path/to/certfile] [--client-key=path/to/keyfile] [--token=bearer_token] [--username=basic_user] [--password=basic_password] [--auth-provider=provider_name] [--auth-provider-arg=key=value] [--exec-command=exec_command] [--exec-api-version=exec_api_version] [--exec-arg=arg] [--exec-env=key=value]

Examples

  1. # Set only the "client-key" field on the "cluster-admin"
  2. # entry, without touching other values
  3. kubectl config set-credentials cluster-admin --client-key=~/.kube/admin.key
  4. # Set basic auth for the "cluster-admin" entry
  5. kubectl config set-credentials cluster-admin --username=admin --password=uXFGweU9l35qcif
  6. # Embed client certificate data in the "cluster-admin" entry
  7. kubectl config set-credentials cluster-admin --client-certificate=~/.kube/admin.crt --embed-certs=true
  8. # Enable the Google Compute Platform auth provider for the "cluster-admin" entry
  9. kubectl config set-credentials cluster-admin --auth-provider=gcp
  10. # Enable the OpenID Connect auth provider for the "cluster-admin" entry with additional arguments
  11. kubectl config set-credentials cluster-admin --auth-provider=oidc --auth-provider-arg=client-id=foo --auth-provider-arg=client-secret=bar
  12. # Remove the "client-secret" config value for the OpenID Connect auth provider for the "cluster-admin" entry
  13. kubectl config set-credentials cluster-admin --auth-provider=oidc --auth-provider-arg=client-secret-
  14. # Enable new exec auth plugin for the "cluster-admin" entry
  15. kubectl config set-credentials cluster-admin --exec-command=/path/to/the/executable --exec-api-version=client.authentication.k8s.io/v1beta1
  16. # Enable new exec auth plugin for the "cluster-admin" entry with interactive mode
  17. kubectl config set-credentials cluster-admin --exec-command=/path/to/the/executable --exec-api-version=client.authentication.k8s.io/v1beta1 --exec-interactive-mode=Never
  18. # Define new exec auth plugin arguments for the "cluster-admin" entry
  19. kubectl config set-credentials cluster-admin --exec-arg=arg1 --exec-arg=arg2
  20. # Create or update exec auth plugin environment variables for the "cluster-admin" entry
  21. kubectl config set-credentials cluster-admin --exec-env=key1=val1 --exec-env=key2=val2
  22. # Remove exec auth plugin environment variables for the "cluster-admin" entry
  23. kubectl config set-credentials cluster-admin --exec-env=var-to-remove-

Options

—auth-provider string

Auth provider for the user entry in kubeconfig

—auth-provider-arg strings

‘key=value’ arguments for the auth provider

—client-certificate string

Path to client-certificate file for the user entry in kubeconfig

—client-key string

Path to client-key file for the user entry in kubeconfig

—embed-certs tristate[=true]

Embed client cert/key for the user entry in kubeconfig

—exec-api-version string

API version of the exec credential plugin for the user entry in kubeconfig

—exec-arg strings

New arguments for the exec credential plugin command for the user entry in kubeconfig

—exec-command string

Command for the exec credential plugin for the user entry in kubeconfig

—exec-env strings

‘key=value’ environment values for the exec credential plugin

—exec-interactive-mode string

InteractiveMode of the exec credentials plugin for the user entry in kubeconfig

—exec-provide-cluster-info tristate[=true]

ProvideClusterInfo of the exec credentials plugin for the user entry in kubeconfig

-h, —help

help for set-credentials

—password string

password for the user entry in kubeconfig

—token string

token for the user entry in kubeconfig

—username string

username for the user entry in kubeconfig

—as string

Username to impersonate for the operation. User could be a regular user or a service account in a namespace.

—as-group strings

Group to impersonate for the operation, this flag can be repeated to specify multiple groups.

—as-uid string

UID to impersonate for the operation.

—cache-dir string     Default: “$HOME/.kube/cache”

Default cache directory

—certificate-authority string

Path to a cert file for the certificate authority

—cluster string

The name of the kubeconfig cluster to use

—context string

The name of the kubeconfig context to use

—default-not-ready-toleration-seconds int     Default: 300

Indicates the tolerationSeconds of the toleration for notReady:NoExecute that is added by default to every pod that does not already have such a toleration.

—default-unreachable-toleration-seconds int     Default: 300

Indicates the tolerationSeconds of the toleration for unreachable:NoExecute that is added by default to every pod that does not already have such a toleration.

—disable-compression

If true, opt-out of response compression for all requests to the server

—insecure-skip-tls-verify

If true, the server’s certificate will not be checked for validity. This will make your HTTPS connections insecure

—kubeconfig string

use a particular kubeconfig file

—match-server-version

Require server version to match client version

-n, —namespace string

If present, the namespace scope for this CLI request

—profile string     Default: “none”

Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex)

—profile-output string     Default: “profile.pprof”

Name of the file to write the profile to

—request-timeout string     Default: “0”

The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don’t timeout requests.

-s, —server string

The address and port of the Kubernetes API server

—storage-driver-buffer-duration duration     Default: 1m0s

Writes in the storage driver will be buffered for this duration, and committed to the non memory backends as a single transaction

—storage-driver-db string     Default: “cadvisor”

database name

—storage-driver-host string     Default: “localhost:8086”

database host:port

—storage-driver-password string     Default: “root”

database password

—storage-driver-secure

use secure connection with database

—storage-driver-table string     Default: “stats”

table name

—storage-driver-user string     Default: “root”

database username

—tls-server-name string

Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used

—user string

The name of the kubeconfig user to use

—version version[=true]

—version, —version=raw prints version information and quits; —version=vX.Y.Z… sets the reported version

—warnings-as-errors

Treat warnings received from the server as errors and exit with a non-zero exit code

See Also