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

NAME

9       kubectl  config  rename-context - Renames a context from the kubeconfig
10       file.
11
12
13

SYNOPSIS

15       kubectl config rename-context [OPTIONS]
16
17
18

DESCRIPTION

20       Renames a context from the kubeconfig file.
21
22
23       CONTEXT_NAME is the context name that you wish to change.
24
25
26       NEW_NAME is the new name you wish to set.
27
28
29       Note: In case the context being renamed is the 'current-context',  this
30       field will also be updated.
31
32
33

OPTIONS INHERITED FROM PARENT COMMANDS

35       --add-dir-header=false       If  true,  adds  the file directory to the
36       header of the log messages
37
38
39       --alsologtostderr=false      log to standard error as well as files
40
41
42       --application-metrics-count-limit=100      Max  number  of  application
43       metrics to store (per container)
44
45
46       --as=""      Username to impersonate for the operation
47
48
49       --as-group=[]       Group  to  impersonate for the operation, this flag
50       can be repeated to specify multiple groups.
51
52
53       --azure-container-registry-config=""      Path to the  file  containing
54       Azure container registry configuration information.
55
56
57       --boot-id-file="/proc/sys/kernel/random/boot_id"        Comma-separated
58       list of files to check for boot-id. Use the first one that exists.
59
60
61       --cache-dir="/builddir/.kube/cache"      Default cache directory
62
63
64       --certificate-authority=""      Path to a cert file for the certificate
65       authority
66
67
68       --client-certificate=""      Path to a client certificate file for TLS
69
70
71       --client-key=""      Path to a client key file for TLS
72
73
74       --cloud-provider-gce-l7lb-src-cidrs=130.211.0.0/22,35.191.0.0/16
75            CIDRs opened in GCE firewall for  L7  LB  traffic  proxy    health
76       checks
77
78
79       --cloud-provider-gce-lb-src-cidrs=130.211.0.0/22,209.85.152.0/22,209.85.204.0/22,35.191.0.0/16
80            CIDRs opened in GCE firewall for  L4  LB  traffic  proxy    health
81       checks
82
83
84       --cluster=""      The name of the kubeconfig cluster to use
85
86
87       --container-hints="/etc/cadvisor/container_hints.json"      location of
88       the container hints file
89
90
91       --containerd="/run/containerd/containerd.sock"      containerd endpoint
92
93
94       --containerd-namespace="k8s.io"      containerd namespace
95
96
97       --context=""      The name of the kubeconfig context to use
98
99
100       --default-not-ready-toleration-seconds=300      Indicates  the  tolera‐
101       tionSeconds  of  the toleration for notReady:NoExecute that is added by
102       default to every pod that does not already have such a toleration.
103
104
105       --default-unreachable-toleration-seconds=300      Indicates the tolera‐
106       tionSeconds  of  the toleration for unreachable:NoExecute that is added
107       by default to every pod that does not already have such a toleration.
108
109
110       --disable-root-cgroup-stats=false      Disable collecting  root  Cgroup
111       stats
112
113
114       --docker="unix:///var/run/docker.sock"      docker endpoint
115
116
117       --docker-env-metadata-whitelist=""      a comma-separated list of envi‐
118       ronment variable keys matched with specified prefix that  needs  to  be
119       collected for docker containers
120
121
122       --docker-only=false       Only  report docker containers in addition to
123       root stats
124
125
126       --docker-root="/var/lib/docker"      DEPRECATED: docker  root  is  read
127       from docker info (this is a fallback, default: /var/lib/docker)
128
129
130       --docker-tls=false      use TLS to connect to docker
131
132
133       --docker-tls-ca="ca.pem"      path to trusted CA
134
135
136       --docker-tls-cert="cert.pem"      path to client certificate
137
138
139       --docker-tls-key="key.pem"      path to private key
140
141
142       --enable-load-reader=false      Whether to enable cpu load reader
143
144
145       --event-storage-age-limit="default=0"      Max length of time for which
146       to store events (per type). Value is a comma separated list of key val‐
147       ues,  where the keys are event types (e.g.: creation, oom) or "default"
148       and the value is a duration. Default is applied  to  all  non-specified
149       event types
150
151
152       --event-storage-event-limit="default=0"       Max  number  of events to
153       store (per type). Value is a comma separated list of key values,  where
154       the  keys  are  event  types (e.g.: creation, oom) or "default" and the
155       value is an integer. Default is  applied  to  all  non-specified  event
156       types
157
158
159       --global-housekeeping-interval=1m0s      Interval between global house‐
160       keepings
161
162
163       --housekeeping-interval=10s      Interval between container  housekeep‐
164       ings
165
166
167       --insecure-skip-tls-verify=false      If true, the server's certificate
168       will not be checked for validity. This will make your HTTPS connections
169       insecure
170
171
172       --kubeconfig=""      use a particular kubeconfig file
173
174
175       --log-backtrace-at=:0       when logging hits line file:N, emit a stack
176       trace
177
178
179       --log-cadvisor-usage=false      Whether to log the usage of the  cAdvi‐
180       sor container
181
182
183       --log-dir=""      If non-empty, write log files in this directory
184
185
186       --log-file=""      If non-empty, use this log file
187
188
189       --log-file-max-size=1800       Defines  the maximum size a log file can
190       grow to. Unit is megabytes. If the value is 0, the maximum file size is
191       unlimited.
192
193
194       --log-flush-frequency=5s       Maximum  number  of  seconds between log
195       flushes
196
197
198       --logtostderr=true      log to standard error instead of files
199
200
201       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
202            Comma-separated  list  of  files  to check for machine-id. Use the
203       first one that exists.
204
205
206       --match-server-version=false       Require  server  version  to   match
207       client version
208
209
210       -n,  --namespace=""       If  present, the namespace scope for this CLI
211       request
212
213
214       --one-output=false      If true, only write logs to their native sever‐
215       ity level (vs also writing to each lower severity level)
216
217
218       --password=""      Password for basic authentication to the API server
219
220
221       --profile="none"         Name   of   profile   to   capture.   One   of
222       (none|cpu|heap|goroutine|threadcreate|block|mutex)
223
224
225       --profile-output="profile.pprof"      Name of the  file  to  write  the
226       profile to
227
228
229       --referenced-reset-interval=0       Reset interval for referenced bytes
230       (container_referenced_bytes metric), number of measurement cycles after
231       which  referenced  bytes  are cleared, if set to 0 referenced bytes are
232       never cleared (default: 0)
233
234
235       --request-timeout="0"      The length of time to wait before giving  up
236       on  a  single  server  request. Non-zero values should contain a corre‐
237       sponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't time‐
238       out requests.
239
240
241       -s, --server=""      The address and port of the Kubernetes API server
242
243
244       --skip-headers=false       If  true,  avoid  header prefixes in the log
245       messages
246
247
248       --skip-log-headers=false      If true, avoid headers when  opening  log
249       files
250
251
252       --stderrthreshold=2      logs at or above this threshold go to stderr
253
254
255       --storage-driver-buffer-duration=1m0s      Writes in the storage driver
256       will be buffered for this duration, and committed  to  the  non  memory
257       backends as a single transaction
258
259
260       --storage-driver-db="cadvisor"      database name
261
262
263       --storage-driver-host="localhost:8086"      database host:port
264
265
266       --storage-driver-password="root"      database password
267
268
269       --storage-driver-secure=false      use secure connection with database
270
271
272       --storage-driver-table="stats"      table name
273
274
275       --storage-driver-user="root"      database username
276
277
278       --tls-server-name=""       Server  name  to  use for server certificate
279       validation. If it is not provided, the hostname  used  to  contact  the
280       server is used
281
282
283       --token=""      Bearer token for authentication to the API server
284
285
286       --update-machine-info-interval=5m0s       Interval between machine info
287       updates.
288
289
290       --user=""      The name of the kubeconfig user to use
291
292
293       --username=""      Username for basic authentication to the API server
294
295
296       -v, --v=0      number for the log level verbosity
297
298
299       --version=false      Print version information and quit
300
301
302       --vmodule=       comma-separated  list  of   pattern=N   settings   for
303       file-filtered logging
304
305
306       --warnings-as-errors=false      Treat warnings received from the server
307       as errors and exit with a non-zero exit code
308
309
310

EXAMPLE

312                # Rename the context 'old-name' to 'new-name' in your kubeconfig file
313                kubectl config rename-context old-name new-name
314
315
316
317

SEE ALSO

319       kubectl-config(1),
320
321
322

HISTORY

324       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
325       com)  based  on the kubernetes source material, but hopefully they have
326       been automatically generated since!
327
328
329
330Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum