1KUBERNETES(1)(kubernetes)                            KUBERNETES(1)(kubernetes)
2
3
4
5Eric Paris Jan 2015
6
7

NAME

9       kubectl config - Modify kubeconfig files
10
11
12

SYNOPSIS

14       kubectl config [OPTIONS]
15
16
17

DESCRIPTION

19       Modify kubeconfig files using subcommands like "kubectl config set cur‐
20       rent-context my-context"
21
22
23       The loading order follows these rules:
24
25
26                1. If the --kubeconfig flag is set, then  only  that  file  is
27                   loaded.  The flag may only be set once and no merging takes
28                   place.
29
30                2. If $KUBECONFIG environment variable is set, then it is used
31                   as  a  list of paths (normal path delimiting rules for your
32                   system). These paths are merged. When a value is  modified,
33                   it  is modified in the file that defines the stanza. When a
34                   value is created, it is created in the first file that  ex‐
35                   ists.  If  no files in the chain exist, then it creates the
36                   last file in the list.
37
38                3. Otherwise, ${HOME}/.kube/config  is  used  and  no  merging
39                   takes place.
40
41
42
43

OPTIONS INHERITED FROM PARENT COMMANDS

45       --as=""      Username to impersonate for the operation. User could be a
46       regular user or a service account in a namespace.
47
48
49       --as-group=[]      Group to impersonate for the  operation,  this  flag
50       can be repeated to specify multiple groups.
51
52
53       --as-uid=""      UID to impersonate for the operation.
54
55
56       --azure-container-registry-config=""       Path  to the file containing
57       Azure container registry configuration information.
58
59
60       --cache-dir="/builddir/.kube/cache"      Default cache directory
61
62
63       --certificate-authority=""      Path to a cert file for the certificate
64       authority
65
66
67       --client-certificate=""      Path to a client certificate file for TLS
68
69
70       --client-key=""      Path to a client key file for TLS
71
72
73       --cluster=""      The name of the kubeconfig cluster to use
74
75
76       --context=""      The name of the kubeconfig context to use
77
78
79       --insecure-skip-tls-verify=false      If true, the server's certificate
80       will not be checked for validity. This will make your HTTPS connections
81       insecure
82
83
84       --kubeconfig=""       Path  to  the  kubeconfig file to use for CLI re‐
85       quests.
86
87
88       --match-server-version=false       Require  server  version  to   match
89       client version
90
91
92       -n,  --namespace=""       If  present, the namespace scope for this CLI
93       request
94
95
96       --password=""      Password for basic authentication to the API server
97
98
99       --profile="none"        Name   of   profile   to   capture.   One    of
100       (none|cpu|heap|goroutine|threadcreate|block|mutex)
101
102
103       --profile-output="profile.pprof"       Name  of  the  file to write the
104       profile to
105
106
107       --request-timeout="0"      The length of time to wait before giving  up
108       on  a  single  server  request. Non-zero values should contain a corre‐
109       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
110       out requests.
111
112
113       -s, --server=""      The address and port of the Kubernetes API server
114
115
116       --tls-server-name=""       Server  name  to  use for server certificate
117       validation. If it is not provided, the hostname  used  to  contact  the
118       server is used
119
120
121       --token=""      Bearer token for authentication to the API server
122
123
124       --user=""      The name of the kubeconfig user to use
125
126
127       --username=""      Username for basic authentication to the API server
128
129
130       --version=false      Print version information and quit
131
132
133       --warnings-as-errors=false      Treat warnings received from the server
134       as errors and exit with a non-zero exit code
135
136
137

SEE ALSO

139       kubectl(1),  kubectl-config-current-context(1),  kubectl-config-delete-
140       cluster(1),   kubectl-config-delete-context(1),  kubectl-config-delete-
141       user(1),    kubectl-config-get-clusters(1),     kubectl-config-get-con‐
142       texts(1),    kubectl-config-get-users(1),    kubectl-config-rename-con‐
143       text(1), kubectl-config-set(1), kubectl-config-set-cluster(1), kubectl-
144       config-set-context(1),  kubectl-config-set-credentials(1), kubectl-con‐
145       fig-unset(1), kubectl-config-use-context(1), kubectl-config-view(1),
146
147
148

HISTORY

150       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
151       com)  based  on the kubernetes source material, but hopefully they have
152       been automatically generated since!
153
154
155
156Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum