1OC ADM GROUPS(1)                   June 2016                  OC ADM GROUPS(1)
2
3
4

NAME

6       oc adm groups new - Create a new group
7
8
9

SYNOPSIS

11       oc adm groups new [OPTIONS]
12
13
14

DESCRIPTION

16       Create a new group.
17
18
19       This command will create a new group with an optional list of users.
20
21
22

OPTIONS

24       --allow-missing-template-keys=true
25           If  true, ignore any errors in templates when a field or map key is
26       missing in the template. Only applies to  golang  and  jsonpath  output
27       formats.
28
29
30       --dry-run=false
31           Display  the group that would be created, without actually creating
32       the group.
33
34
35       -o, --output=""
36           Output format. One of: json|yaml|name|templatefile|template|go-tem‐
37       plate|go-template-file|jsonpath|jsonpath-file.
38
39
40       --template=""
41           Template  string  or  path  to template file to use when -o=go-tem‐
42       plate, -o=go-template-file. The template format is golang  templates  [
43http://golang.org/pkg/text/template/#pkg-overview⟩].
44
45
46

OPTIONS INHERITED FROM PARENT COMMANDS

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

EXAMPLE

296                # Add a group with no users
297                oc adm groups new my-group
298
299                # Add a group with two users
300                oc adm groups new my-group user1 user2
301
302                # Add a group with one user and shorter output
303                oc adm groups new my-group user1 -o name
304
305
306
307

SEE ALSO

309       oc-adm-groups(1),
310
311
312

HISTORY

314       June 2016, Ported from the Kubernetes man-doc generator
315
316
317
318Openshift                  Openshift CLI User Manuals         OC ADM GROUPS(1)
Impressum