1OC(1) June 2016 OC(1)
2
6 oc login - Log in to a server
7
11 oc login [OPTIONS]
12
16 Log in to your server and save login for subsequent use
17 First-time users of the client should run this command to connect to a
20 server, establish an authenticated session, and save connection to the
21 configuration file. The default configuration will be saved to your
22 home directory under ".kube/config".
23 The information required to login -- like username and password, a ses‐
26 sion token, or the server details -- can be provided through flags. If
27 not provided, the command will prompt for user input as needed.
28
32 -p, --password=""
33 Password, will prompt if not provided
34 -u, --username=""
37 Username, will prompt if not provided
38
42 --allow_verification_with_non_compliant_keys=false
43 Allow a SignatureVerifier to use keys which are technically
44 non-compliant with RFC6962.
45 --alsologtostderr=false
48 log to standard error as well as files
49 --application_metrics_count_limit=100
52 Max number of application metrics to store (per container)
53 --as=""
56 Username to impersonate for the operation
57 --as-group=[]
60 Group to impersonate for the operation, this flag can be repeated
61 to specify multiple groups.
62 --azure-container-registry-config=""
65 Path to the file containing Azure container registry configuration
66 information.
67 --boot_id_file="/proc/sys/kernel/random/boot_id"
70 Comma-separated list of files to check for boot-id. Use the first
71 one that exists.
72 --cache-dir="/builddir/.kube/http-cache"
75 Default HTTP cache directory
76 --certificate-authority=""
79 Path to a cert file for the certificate authority
80 --client-certificate=""
83 Path to a client certificate file for TLS
84 --client-key=""
87 Path to a client key file for TLS
88 --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
91 CIDRs opened in GCE firewall for LB traffic proxy health checks
92 --cluster=""
95 The name of the kubeconfig cluster to use
96 --container_hints="/etc/cadvisor/container_hints.json"
99 location of the container hints file
100 --containerd="unix:///var/run/containerd.sock"
103 containerd endpoint
104 --context=""
107 The name of the kubeconfig context to use
108 --default-not-ready-toleration-seconds=300
111 Indicates the tolerationSeconds of the toleration for
112 notReady:NoExecute that is added by default to every pod that does not
113 already have such a toleration.
114 --default-unreachable-toleration-seconds=300
117 Indicates the tolerationSeconds of the toleration for unreach‐
118 able:NoExecute that is added by default to every pod that does not
119 already have such a toleration.
120 --docker="unix:///var/run/docker.sock"
123 docker endpoint
124 --docker-tls=false
127 use TLS to connect to docker
128 --docker-tls-ca="ca.pem"
131 path to trusted CA
132 --docker-tls-cert="cert.pem"
135 path to client certificate
136 --docker-tls-key="key.pem"
139 path to private key
140 --docker_env_metadata_whitelist=""
143 a comma-separated list of environment variable keys that needs to
144 be collected for docker containers
145 --docker_only=false
148 Only report docker containers in addition to root stats
149 --docker_root="/var/lib/docker"
152 DEPRECATED: docker root is read from docker info (this is a fall‐
153 back, default: /var/lib/docker)
154 --enable_load_reader=false
157 Whether to enable cpu load reader
158 --event_storage_age_limit="default=24h"
161 Max length of time for which to store events (per type). Value is a
162 comma separated list of key values, where the keys are event types
163 (e.g.: creation, oom) or "default" and the value is a duration. Default
164 is applied to all non-specified event types
165 --event_storage_event_limit="default=100000"
168 Max number of events to store (per type). Value is a comma sepa‐
169 rated list of key values, where the keys are event types (e.g.: cre‐
170 ation, oom) or "default" and the value is an integer. Default is
171 applied to all non-specified event types
172 --global_housekeeping_interval=0
175 Interval between global housekeepings
176 --housekeeping_interval=0
179 Interval between container housekeepings
180 --insecure-skip-tls-verify=false
183 If true, the server's certificate will not be checked for validity.
184 This will make your HTTPS connections insecure
185 --kubeconfig=""
188 Path to the kubeconfig file to use for CLI requests.
189 --log-flush-frequency=0
192 Maximum number of seconds between log flushes
193 --log_backtrace_at=:0
196 when logging hits line file:N, emit a stack trace
197 --log_cadvisor_usage=false
200 Whether to log the usage of the cAdvisor container
201 --log_dir=""
204 If non-empty, write log files in this directory
205 --logtostderr=true
208 log to standard error instead of files
209 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
212 Comma-separated list of files to check for machine-id. Use the
213 first one that exists.
214 --match-server-version=false
217 Require server version to match client version
218 -n, --namespace=""
221 If present, the namespace scope for this CLI request
222 --request-timeout="0"
225 The length of time to wait before giving up on a single server
226 request. Non-zero values should contain a corresponding time unit (e.g.
227 1s, 2m, 3h). A value of zero means don't timeout requests.
228 -s, --server=""
231 The address and port of the Kubernetes API server
232 --stderrthreshold=2
235 logs at or above this threshold go to stderr
236 --storage_driver_buffer_duration=0
239 Writes in the storage driver will be buffered for this duration,
240 and committed to the non memory backends as a single transaction
241 --storage_driver_db="cadvisor"
244 database name
245 --storage_driver_host="localhost:8086"
248 database host:port
249 --storage_driver_password="root"
252 database password
253 --storage_driver_secure=false
256 use secure connection with database
257 --storage_driver_table="stats"
260 table name
261 --storage_driver_user="root"
264 database username
265 --token=""
268 Bearer token for authentication to the API server
269 --user=""
272 The name of the kubeconfig user to use
273 -v, --v=0
276 log level for V logs
277 --version=false
280 Print version information and quit
281 --vmodule=
284 comma-separated list of pattern=N settings for file-filtered log‐
285 ging
286
290 # Log in interactively
291 oc login
292 # Log in to the given server with the given certificate authority file
294 oc login localhost:8443 --certificate-authority=/path/to/cert.crt
295 # Log in to the given server with the given credentials (will not prompt interactively)
297 oc login localhost:8443 --username=myuser --password=mypass
298
303 oc(1),
304
308 June 2016, Ported from the Kubernetes man-doc generator
309Openshift Openshift CLI User Manuals OC(1)