glab-cluster-agent-update-kubeconfig - Man Page

Update your kubeconfig for use with a GitLab Agent for Kubernetes.

Synopsis

glab cluster agent update-kubeconfig [flags]

Description

Configures kubectl to authenticate through the GitLab Agent for Kubernetes using an exec credential plugin.

Options

-a, --agent=0 The numeric agent ID to create the kubeconfig entry for.

-c, --cache-mode="force-keyring" Mode to use for caching the token. Allowed values: keyring-filesystem-fallback, force-keyring, force-filesystem, no.

--check-revoked[=false] Check if a cached token is revoked. Requires an API call to GitLab, which adds latency every time a cached token is accessed.

--kubeconfig="" Use a particular kubeconfig file.

--token-expiry-duration=24h0m0s Duration for generated token's validity. Minimum is 1 day. Expires at end of day, and ignores time.

-u, --use-context[=false] Use as default context.

Options Inherited from Parent Commands

-h, --help[=false] Show help for this command.

-R, --repo="" Select another repository. You can use either OWNER/REPO or GROUP/NAMESPACE/REPO. The full URL or Git URL is also accepted.

Example

# Update kubeconfig for agent 123
glab cluster agent update-kubeconfig --agent 123

# Update kubeconfig and set as the default context
glab cluster agent update-kubeconfig --agent 123 --use-context

See Also

glab-cluster-agent(1)

Referenced By

glab-cluster-agent(1).

Jun 2026 Auto generated by spf13/cobra