gcloud_container_clusters_get-credentials (1)
NAME
- gcloud container clusters get-credentials - fetch credentials for a running cluster
SYNOPSIS
-
gcloud container clusters get-credentials NAME [--internal-ip] [--region=REGION | --zone=ZONE, -z ZONE] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
It takes a project and a zone as parameters, passed through by set defaults or flags. By default, credentials are written to HOME/.kube/config. You can provide an alternate path by setting the KUBECONFIG environment variable. If KUBECONFIG contains multiple paths, the first one is used.
This command enables switching to a specific cluster, when working with multiple clusters. It can also be used to access a previously created cluster from a new workstation.
By default, gcloud container clusters get-credentials will configure kubectl to automatically refresh its credentials using the same identity as gcloud. If you are running kubectl as part of an application, it is recommended to use application default credentials (cloud.google.com/docs/authentication/production To configure a kubeconfig file to use application default credentials, set the container/use_application_default_credentials Cloud SDK property (cloud.google.com/sdk/docs/properties to true before running gcloud container clusters get-credentials
See cloud.google.com/kubernetes-engine/docs/kubectl for kubectl documentation.
POSITIONAL ARGUMENTS
-
- NAME
-
Name of the cluster to get credentials for. Overrides the default
container/cluster property value for this command invocation.
FLAGS
-
- --internal-ip
-
Whether to use the internal IP address of the cluster endpoint.
-
At most one of these may be specified:
-
- --region=REGION
-
Compute region (e.g. us-central1) for the cluster.
- --zone=ZONE, -z ZONE
-
Compute zone (e.g. us-central1-a) for the cluster. Overrides the default
compute/zone property value for this command invocation.
-
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
EXAMPLES
To switch to working on your cluster 'testcluster1', run:
-
$ gcloud container clusters get-credentials testcluster1 \
--zone=us-central1-f
NOTES
These variants are also available:
- $ gcloud alpha container clusters get-credentials $ gcloud beta container clusters get-credentials