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

NAME

9       kubectl  auth  reconcile - Reconciles rules for RBAC Role, RoleBinding,
10       ClusterRole, and ClusterRoleBinding objects
11
12
13

SYNOPSIS

15       kubectl auth reconcile [OPTIONS]
16
17
18

DESCRIPTION

20       Reconciles rules for RBAC Role, RoleBinding, ClusterRole, and  Cluster‐
21       RoleBinding objects.
22
23
24       Missing  objects  are  created, and the containing namespace is created
25       for namespaced objects, if required.
26
27
28       Existing roles are updated to include the permissions in the input  ob‐
29       jects,  and  remove  extra permissions if --remove-extra-permissions is
30       specified.
31
32
33       Existing bindings are updated to include the subjects in the input  ob‐
34       jects,  and  remove extra subjects if --remove-extra-subjects is speci‐
35       fied.
36
37
38       This is preferred to  'apply'  for  RBAC  resources  so  that  semanti‐
39       cally-aware merging of rules and subjects is done.
40
41
42

OPTIONS

44       --allow-missing-template-keys=true       If  true, ignore any errors in
45       templates when a field or map key is missing in the template. Only  ap‐
46       plies to golang and jsonpath output formats.
47
48
49       --dry-run="none"       Must be "none", "server", or "client". If client
50       strategy, only print the object that would be sent, without sending it.
51       If  server  strategy, submit server-side request without persisting the
52       resource.
53
54
55       -f, --filename=[]      Filename, directory, or URL to files identifying
56       the resource to reconcile.
57
58
59       -k,  --kustomize=""      Process the kustomization directory. This flag
60       can't be used together with -f or -R.
61
62
63       -o, --output=""       Output  format.  One  of:  json|yaml|name|go-tem‐
64       plate|go-template-file|template|templatefile|jsonpath|json‐
65       path-as-json|jsonpath-file.
66
67
68       -R, --recursive=false      Process the directory used in -f, --filename
69       recursively. Useful when you want to manage related manifests organized
70       within the same directory.
71
72
73       --remove-extra-permissions=false      If true,  removes  extra  permis‐
74       sions added to roles
75
76
77       --remove-extra-subjects=false       If  true,  removes  extra  subjects
78       added to rolebindings
79
80
81       --show-managed-fields=false      If true, keep the  managedFields  when
82       printing objects in JSON or YAML format.
83
84
85       --template=""      Template string or path to template file to use when
86       -o=go-template, -o=go-template-file. The template format is golang tem‐
87       plates [http://golang.org/pkg/text/template/#pkg-overview].
88
89
90

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

370                # Reconcile rbac resources from a file
371                kubectl auth reconcile -f my-rbac-rules.yaml
372
373
374
375

SEE ALSO

377       kubectl-auth(1),
378
379
380

HISTORY

382       January  2015,  Originally compiled by Eric Paris (eparis at redhat dot
383       com) based on the kubernetes source material, but hopefully  they  have
384       been automatically generated since!
385
386
387
388Manuals                              User            KUBERNETES(1)(kubernetes)
Impressum