- NAME
-
- gcloud alpha container clusters get-credentials - fetch credentials for a running cluster
- SYNOPSIS
-
-
gcloud alpha container clusters get-credentials
NAME
[--dns-endpoint
] [--internal-ip
] [--location
=LOCATION
|--region
=REGION
|--zone
=ZONE
,-z
ZONE
] [GCLOUD_WIDE_FLAG …
]
-
- DESCRIPTION
-
(ALPHA)
gcloud alpha container clusters get-credentials updates akubeconfig
file with appropriate credentials and endpoint information to pointkubectl
at a specific cluster in Google Kubernetes Engine.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 theKUBECONFIG
environment variable. IfKUBECONFIG
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 alpha 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. To configure a
kubeconfig
file to use application default credentials, set the container/use_application_default_credentials Cloud SDK property to true before running gcloud alpha container clusters get-credentialsSee https://cloud.google.com/kubernetes-engine/docs/kubectl for kubectl documentation.
- EXAMPLES
-
To switch to working on your cluster 'sample-cluster', run:
gcloud alpha container clusters get-credentials sample-cluster --location=us-central1-f
- POSITIONAL ARGUMENTS
-
NAME
-
Name of the cluster to get credentials for. Overrides the default
container/cluster
property value for this command invocation.
- FLAGS
-
--dns-endpoint
- Whether to use the DNS-based endpoint for the cluster address.
--internal-ip
- Whether to use the internal IP address of the cluster endpoint.
-
At most one of these can be specified:
--location
=LOCATION
- Compute zone or region (e.g. us-central1-a or us-central1) for the cluster. Overrides the default compute/region or compute/zone value for this command invocation. Prefer using this flag over the --region or --zone flags.
--region
=REGION
- Compute region (e.g. us-central1) for a regional cluster. Overrides the default compute/region property value for this command invocation.
--zone
=ZONE
,-z
ZONE
- Compute zone (e.g. us-central1-a) for a zonal cluster. Overrides the default compute/zone property value for this command invocation.
- GCLOUD WIDE FLAGS
-
These flags are available to all commands:
--access-token-file
,--account
,--billing-project
,--configuration
,--flags-file
,--flatten
,--format
,--help
,--impersonate-service-account
,--log-http
,--project
,--quiet
,--trace-token
,--user-output-enabled
,--verbosity
.Run
$ gcloud help
for details. - NOTES
-
This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation-only early access
allowlist. These variants are also available:
gcloud container clusters get-credentials
gcloud beta container clusters get-credentials
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-08 UTC.