.nh
.TH "glab" "1" "Sep 2026" "Auto generated by spf13/cobra" ""

.SH NAME
glab-cluster-agent-update-kubeconfig - Update your kubeconfig for use with a GitLab Agent for Kubernetes.


.SH SYNOPSIS
\fBglab cluster agent update-kubeconfig [flags]\fP


.SH DESCRIPTION
Configures \fBkubectl\fR to authenticate through the GitLab Agent for Kubernetes
using an exec credential plugin.
.IP \(bu 2
Use \fB--agent\fR to specify the agent by its numeric ID.
.IP \(bu 2
Use \fB--use-context\fR to set the agent as the default \fBkubectl\fR context.
.IP \(bu 2
Use \fB--token-expiry-duration\fR to control how long the generated token is valid.
.IP \(bu 2
Use \fB--cache-mode\fR to control how generated tokens are cached.


.SH OPTIONS
\fB-a\fP, \fB--agent\fP=0
	The numeric agent ID to create the kubeconfig entry for.

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

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

.PP
\fB--kubeconfig\fP=""
	Use a particular kubeconfig file.

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

.PP
\fB-u\fP, \fB--use-context\fP[=false]
	Use as default context.


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB-h\fP, \fB--help\fP[=false]
	Show help for this command.

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


.SH EXAMPLE
.EX
# 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
.EE


.SH SEE ALSO
\fBglab-cluster-agent(1)\fP