1OC(1) June 2016 OC(1)
2
6 oc attach - Attach to a running container
7
11 oc attach [OPTIONS]
12
16 Attach to a running container
17 Attach the current shell to a remote container, returning output or
20 setting up a full terminal session. Can be used to debug containers and
21 invoke interactive commands.
22
26 -c, --container=""
27 Container name. If omitted, the first container in the pod will be
28 chosen
29 --pod-running-timeout=0
32 The length of time (like 5s, 2m, or 3h, higher than zero) to wait
33 until at least one pod is running
34 -i, --stdin=false
37 Pass stdin to the container
38 -t, --tty=false
41 Stdin is a TTY
42
46 --allow_verification_with_non_compliant_keys=false
47 Allow a SignatureVerifier to use keys which are technically
48 non-compliant with RFC6962.
49 --alsologtostderr=false
52 log to standard error as well as files
53 --application_metrics_count_limit=100
56 Max number of application metrics to store (per container)
57 --as=""
60 Username to impersonate for the operation
61 --as-group=[]
64 Group to impersonate for the operation, this flag can be repeated
65 to specify multiple groups.
66 --azure-container-registry-config=""
69 Path to the file containing Azure container registry configuration
70 information.
71 --boot_id_file="/proc/sys/kernel/random/boot_id"
74 Comma-separated list of files to check for boot-id. Use the first
75 one that exists.
76 --cache-dir="/builddir/.kube/http-cache"
79 Default HTTP cache directory
80 --certificate-authority=""
83 Path to a cert file for the certificate authority
84 --client-certificate=""
87 Path to a client certificate file for TLS
88 --client-key=""
91 Path to a client key file for TLS
92 --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
95 CIDRs opened in GCE firewall for LB traffic proxy health checks
96 --cluster=""
99 The name of the kubeconfig cluster to use
100 --container_hints="/etc/cadvisor/container_hints.json"
103 location of the container hints file
104 --containerd="unix:///var/run/containerd.sock"
107 containerd endpoint
108 --context=""
111 The name of the kubeconfig context to use
112 --default-not-ready-toleration-seconds=300
115 Indicates the tolerationSeconds of the toleration for
116 notReady:NoExecute that is added by default to every pod that does not
117 already have such a toleration.
118 --default-unreachable-toleration-seconds=300
121 Indicates the tolerationSeconds of the toleration for unreach‐
122 able:NoExecute that is added by default to every pod that does not
123 already have such a toleration.
124 --docker="unix:///var/run/docker.sock"
127 docker endpoint
128 --docker-tls=false
131 use TLS to connect to docker
132 --docker-tls-ca="ca.pem"
135 path to trusted CA
136 --docker-tls-cert="cert.pem"
139 path to client certificate
140 --docker-tls-key="key.pem"
143 path to private key
144 --docker_env_metadata_whitelist=""
147 a comma-separated list of environment variable keys that needs to
148 be collected for docker containers
149 --docker_only=false
152 Only report docker containers in addition to root stats
153 --docker_root="/var/lib/docker"
156 DEPRECATED: docker root is read from docker info (this is a fall‐
157 back, default: /var/lib/docker)
158 --enable_load_reader=false
161 Whether to enable cpu load reader
162 --event_storage_age_limit="default=24h"
165 Max length of time for which to store events (per type). Value is a
166 comma separated list of key values, where the keys are event types
167 (e.g.: creation, oom) or "default" and the value is a duration. Default
168 is applied to all non-specified event types
169 --event_storage_event_limit="default=100000"
172 Max number of events to store (per type). Value is a comma sepa‐
173 rated list of key values, where the keys are event types (e.g.: cre‐
174 ation, oom) or "default" and the value is an integer. Default is
175 applied to all non-specified event types
176 --global_housekeeping_interval=0
179 Interval between global housekeepings
180 --housekeeping_interval=0
183 Interval between container housekeepings
184 --httptest.serve=""
187 if non-empty, httptest.NewServer serves on this address and blocks
188 --insecure-skip-tls-verify=false
191 If true, the server's certificate will not be checked for validity.
192 This will make your HTTPS connections insecure
193 --kubeconfig=""
196 Path to the kubeconfig file to use for CLI requests.
197 --log-flush-frequency=0
200 Maximum number of seconds between log flushes
201 --log_backtrace_at=:0
204 when logging hits line file:N, emit a stack trace
205 --log_cadvisor_usage=false
208 Whether to log the usage of the cAdvisor container
209 --log_dir=""
212 If non-empty, write log files in this directory
213 --logtostderr=true
216 log to standard error instead of files
217 --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
220 Comma-separated list of files to check for machine-id. Use the
221 first one that exists.
222 --match-server-version=false
225 Require server version to match client version
226 -n, --namespace=""
229 If present, the namespace scope for this CLI request
230 --request-timeout="0"
233 The length of time to wait before giving up on a single server
234 request. Non-zero values should contain a corresponding time unit (e.g.
235 1s, 2m, 3h). A value of zero means don't timeout requests.
236 -s, --server=""
239 The address and port of the Kubernetes API server
240 --stderrthreshold=2
243 logs at or above this threshold go to stderr
244 --storage_driver_buffer_duration=0
247 Writes in the storage driver will be buffered for this duration,
248 and committed to the non memory backends as a single transaction
249 --storage_driver_db="cadvisor"
252 database name
253 --storage_driver_host="localhost:8086"
256 database host:port
257 --storage_driver_password="root"
260 database password
261 --storage_driver_secure=false
264 use secure connection with database
265 --storage_driver_table="stats"
268 table name
269 --storage_driver_user="root"
272 database username
273 --token=""
276 Bearer token for authentication to the API server
277 --user=""
280 The name of the kubeconfig user to use
281 -v, --v=0
284 log level for V logs
285 --version=false
288 Print version information and quit
289 --vmodule=
292 comma-separated list of pattern=N settings for file-filtered log‐
293 ging
294
298 # Get output from running pod 123456-7890, using the first container by default
299 oc attach 123456-7890
300 # Get output from ruby-container from pod 123456-7890
302 oc attach 123456-7890 -c ruby-container
303 # Switch to raw terminal mode, sends stdin to 'bash' in ruby-container from pod 123456-780
305 # and sends stdout/stderr from 'bash' back to the client
306 oc attach 123456-7890 -c ruby-container -i -t
307
312 oc(1),
313
317 June 2016, Ported from the Kubernetes man-doc generator
318Openshift Openshift CLI User Manuals OC(1)