1KUBERNETES(1)                      Jan 2015                      KUBERNETES(1)
2
3
4

NAME

6       kubectl create rolebinding - Create a RoleBinding for a particular Role
7       or ClusterRole
8
9
10

SYNOPSIS

12       kubectl create rolebinding [OPTIONS]
13
14
15

DESCRIPTION

17       Create a RoleBinding for a particular Role or ClusterRole.
18
19
20

OPTIONS

22       --allow-missing-template-keys=true
23           If true, ignore any errors in templates when a field or map key  is
24       missing  in  the  template.  Only applies to golang and jsonpath output
25       formats.
26
27
28       --clusterrole=""
29           ClusterRole this RoleBinding should reference
30
31
32       --dry-run=false
33           If true, only print the object that would be sent, without  sending
34       it.
35
36
37       --generator="rolebinding.rbac.authorization.k8s.io/v1alpha1"
38           The name of the API generator to use.
39
40
41       --group=[]
42           Groups to bind to the role
43
44
45       -o, --output=""
46           Output  format.  One  of: json|yaml|name|go-template-file|template‐
47       file|template|go-template|jsonpath|jsonpath-file.
48
49
50       --role=""
51           Role this RoleBinding should reference
52
53
54       --save-config=false
55           If true, the configuration of current object will be saved  in  its
56       annotation.  Otherwise,  the annotation will be unchanged. This flag is
57       useful when you want to perform kubectl apply on  this  object  in  the
58       future.
59
60
61       --serviceaccount=[]
62           Service  accounts  to  bind  to  the  role,  in  the format <names‐
63       pace>:<name>
64
65
66       --template=""
67           Template string or path to template file  to  use  when  -o=go-tem‐
68       plate,  -o=go-template-file.  The template format is golang templates [
69http://golang.org/pkg/text/template/#pkg-overview⟩].
70
71
72       --validate=true
73           If true, use a schema to validate the input before sending it
74
75
76

OPTIONS INHERITED FROM PARENT COMMANDS

78       --allow-verification-with-non-compliant-keys=false
79           Allow  a  SignatureVerifier  to  use  keys  which  are  technically
80       non-compliant with RFC6962.
81
82
83       --alsologtostderr=false
84           log to standard error as well as files
85
86
87       --application-metrics-count-limit=100
88           Max number of application metrics to store (per container)
89
90
91       --as=""
92           Username to impersonate for the operation
93
94
95       --as-group=[]
96           Group  to  impersonate for the operation, this flag can be repeated
97       to specify multiple groups.
98
99
100       --azure-container-registry-config=""
101           Path to the file containing Azure container registry  configuration
102       information.
103
104
105       --boot-id-file="/proc/sys/kernel/random/boot_id"
106           Comma-separated  list  of files to check for boot-id. Use the first
107       one that exists.
108
109
110       --cache-dir="/builddir/.kube/http-cache"
111           Default HTTP cache directory
112
113
114       --certificate-authority=""
115           Path to a cert file for the certificate authority
116
117
118       --client-certificate=""
119           Path to a client certificate file for TLS
120
121
122       --client-key=""
123           Path to a client key file for TLS
124
125
126       --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
127           CIDRs opened in GCE firewall for LB traffic proxy  health checks
128
129
130       --cluster=""
131           The name of the kubeconfig cluster to use
132
133
134       --container-hints="/etc/cadvisor/container_hints.json"
135           location of the container hints file
136
137
138       --containerd="unix:///var/run/containerd.sock"
139           containerd endpoint
140
141
142       --context=""
143           The name of the kubeconfig context to use
144
145
146       --default-not-ready-toleration-seconds=300
147           Indicates    the    tolerationSeconds   of   the   toleration   for
148       notReady:NoExecute that is added by default to every pod that does  not
149       already have such a toleration.
150
151
152       --default-unreachable-toleration-seconds=300
153           Indicates  the  tolerationSeconds  of  the  toleration for unreach‐
154       able:NoExecute that is added by default to  every  pod  that  does  not
155       already have such a toleration.
156
157
158       --docker="unix:///var/run/docker.sock"
159           docker endpoint
160
161
162       --docker-env-metadata-whitelist=""
163           a  comma-separated  list of environment variable keys that needs to
164       be collected for docker containers
165
166
167       --docker-only=false
168           Only report docker containers in addition to root stats
169
170
171       --docker-root="/var/lib/docker"
172           DEPRECATED: docker root is read from docker info (this is  a  fall‐
173       back, default: /var/lib/docker)
174
175
176       --docker-tls=false
177           use TLS to connect to docker
178
179
180       --docker-tls-ca="ca.pem"
181           path to trusted CA
182
183
184       --docker-tls-cert="cert.pem"
185           path to client certificate
186
187
188       --docker-tls-key="key.pem"
189           path to private key
190
191
192       --enable-load-reader=false
193           Whether to enable cpu load reader
194
195
196       --event-storage-age-limit="default=0"
197           Max length of time for which to store events (per type). Value is a
198       comma separated list of key values, where  the  keys  are  event  types
199       (e.g.: creation, oom) or "default" and the value is a duration. Default
200       is applied to all non-specified event types
201
202
203       --event-storage-event-limit="default=0"
204           Max number of events to store (per type). Value is  a  comma  sepa‐
205       rated  list  of  key values, where the keys are event types (e.g.: cre‐
206       ation, oom) or "default" and  the  value  is  an  integer.  Default  is
207       applied to all non-specified event types
208
209
210       --global-housekeeping-interval=1m0s
211           Interval between global housekeepings
212
213
214       --google-json-key=""
215           The  Google  Cloud  Platform  Service  Account  JSON Key to use for
216       authentication.
217
218
219       --housekeeping-interval=10s
220           Interval between container housekeepings
221
222
223       --insecure-skip-tls-verify=false
224           If true, the server's certificate will not be checked for validity.
225       This will make your HTTPS connections insecure
226
227
228       --kubeconfig=""
229           Path to the kubeconfig file to use for CLI requests.
230
231
232       --log-backtrace-at=:0
233           when logging hits line file:N, emit a stack trace
234
235
236       --log-cadvisor-usage=false
237           Whether to log the usage of the cAdvisor container
238
239
240       --log-dir=""
241           If non-empty, write log files in this directory
242
243
244       --log-flush-frequency=5s
245           Maximum number of seconds between log flushes
246
247
248       --logtostderr=true
249           log to standard error instead of files
250
251
252       --machine-id-file="/etc/machine-id,/var/lib/dbus/machine-id"
253           Comma-separated  list  of  files  to  check for machine-id. Use the
254       first one that exists.
255
256
257       --match-server-version=false
258           Require server version to match client version
259
260
261       --mesos-agent="127.0.0.1:5051"
262           Mesos agent address
263
264
265       --mesos-agent-timeout=10s
266           Mesos agent timeout
267
268
269       -n, --namespace=""
270           If present, the namespace scope for this CLI request
271
272
273       --request-timeout="0"
274           The length of time to wait before giving  up  on  a  single  server
275       request. Non-zero values should contain a corresponding time unit (e.g.
276       1s, 2m, 3h). A value of zero means don't timeout requests.
277
278
279       -s, --server=""
280           The address and port of the Kubernetes API server
281
282
283       --stderrthreshold=2
284           logs at or above this threshold go to stderr
285
286
287       --storage-driver-buffer-duration=1m0s
288           Writes in the storage driver will be buffered  for  this  duration,
289       and committed to the non memory backends as a single transaction
290
291
292       --storage-driver-db="cadvisor"
293           database name
294
295
296       --storage-driver-host="localhost:8086"
297           database host:port
298
299
300       --storage-driver-password="root"
301           database password
302
303
304       --storage-driver-secure=false
305           use secure connection with database
306
307
308       --storage-driver-table="stats"
309           table name
310
311
312       --storage-driver-user="root"
313           database username
314
315
316       --token=""
317           Bearer token for authentication to the API server
318
319
320       --user=""
321           The name of the kubeconfig user to use
322
323
324       -v, --v=0
325           log level for V logs
326
327
328       --version=false
329           Print version information and quit
330
331
332       --vmodule=
333           comma-separated  list  of pattern=N settings for file-filtered log‐
334       ging
335
336
337

EXAMPLE

339                # Create a RoleBinding for user1, user2, and group1 using the admin ClusterRole
340                kubectl create rolebinding admin --clusterrole=admin --user=user1 --user=user2 --group=group1
341
342
343
344

SEE ALSO

346       kubectl-create(1),
347
348
349

HISTORY

351       January 2015, Originally compiled by Eric Paris (eparis at  redhat  dot
352       com)  based  on the kubernetes source material, but hopefully they have
353       been automatically generated since!
354
355
356
357Eric Paris                  kubernetes User Manuals              KUBERNETES(1)
Impressum