OC(1)

💅 OC(1) — oc attach, the attach-to-a-running-container manual 💅

okay so bestie, this is the OC(1) page for oc attach. She's short, she's useful, and she's about to make attaching to a running container make sense. 💖

🎀 NAME 🎀

oc attach — attach to a running container. That's the whole name, and she's iconic. ✨

✨ SYNOPSIS ✨

oc attach [OPTIONS]

literally that's the shape of it: oc attach plus whatever [OPTIONS] you need. 🫶

💖 DESCRIPTION 💖

okay so oc attach attaches you to a process that is already running inside an existing container. It's giving “join the group chat that's already popping off” energy — you're attaching to the one that's already there. 💅

That's the description, bestie. Short, sweet, to the point. 🌸

🌸 OPTIONS 🌸

these are the flags that belong to oc attach itself. read them, love them, use them. 🎀

• -c, --container="" — Container name. If omitted, use the kubectl.kubernetes.io/default-container annotation for selecting the container to be attached or the first container in the pod will be chosen. 🫙
• --pod-running-timeout=0 — The length of time (like 5s, 2m, or 3h, higher than zero) to wait until at least one pod is running. ⏳
• -q, --quiet=false — Only print output from the remote session. 🤫
• -i, --stdin=false — Pass stdin to the container. 📥
• -t, --tty=false — Stdin is a TTY. 🖥️

🦋 OPTIONS INHERITED FROM PARENT COMMANDS 🦋

these come from the parent command, so they're inherited — like getting your mom's good hair, but for flags. 💜

• --as="" — Username to impersonate for the operation. User could be a regular user or a service account in a namespace. 🎭
• --as-group=[] — Group to impersonate for the operation, this flag can be repeated to specify multiple groups. 👯
• --as-uid="" — UID to impersonate for the operation. 🪪
• --as-user-extra=[] — User extras to impersonate for the operation, this flag can be repeated to specify multiple values for the same key. 🗂️
• --cache-dir="/homeless-shelter/.kube/cache" — Default cache directory. 📁
• --certificate-authority="" — Path to a cert file for the certificate authority. 🔐
• --client-certificate="" — Path to a client certificate file for TLS. 📜
• --client-key="" — Path to a client key file for TLS. 🔑
• --cluster="" — The name of the kubeconfig cluster to use. ☁️
• --context="" — The name of the kubeconfig context to use. 🧭
• --disable-compression=false — If true, opt-out of response compression for all requests to the server. 🗜️
• --insecure-skip-tls-verify=false — If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure. 🚨 insecure, bestie.
• --kubeconfig="" — Path to the kubeconfig file to use for CLI requests. 🗺️
• --kuberc="" — Path to the kuberc file to use for preferences. This can be disabled by exporting KUBECTL_KUBERC=false feature gate or turning off the feature KUBERC=off. 🛠️
• --match-server-version=false — Require server version to match client version. ✅
• -n, --namespace="" — If present, the namespace scope for this CLI request. 📦
• --profile="none" — Name of profile to capture. One of (none|cpu|heap|goroutine|threadcreate|block|mutex). 📈
• --profile-output="profile.pprof" — Name of the file to write the profile to. 💾
• --request-timeout="0" — The length of time to wait before giving up on a single server request. Non-zero values should contain a corresponding time unit (e.g. 1s, 2m, 3h). A value of zero means don't timeout requests. ⏱️
• -s, --server="" — The address and port of the Kubernetes API server. 🌐
• --tls-server-name="" — Server name to use for server certificate validation. If it is not provided, the hostname used to contact the server is used. 🪪
• --token="" — Bearer token for authentication to the API server. 🎟️
• --user="" — The name of the kubeconfig user to use. 👤
• --warnings-as-errors=false — Treat warnings received from the server as errors and exit with a non-zero exit code. ⚠️

🍓 EXAMPLE 🍓

okay bestie, here are the examples exactly as they live in the page — copy them, don't improvise, she's precise: 🎀

# Get output from running pod mypod; use the 'oc.kubernetes.io/default-container' annotation
# for selecting the container to be attached or the first container in the pod will be chosen
oc attach mypod

# Get output from ruby-container from pod mypod
oc attach mypod -c ruby-container

# Switch to raw terminal mode; sends stdin to 'bash' in ruby-container from pod mypod
# and sends stdout/stderr from 'bash' back to the client
oc attach mypod -c ruby-container -i -t

# Get output from the first pod of a replica set named nginx
oc attach rs/nginx

🔥 SEE ALSO 🔥

• oc(1), — the parent manual, obviously. 💅

👑 HISTORY 👑

June 2016 — Ported from the Kubernetes man-doc generator. A little historical moment, and honestly? iconic. 🌈

kisses and sparkles 💋 — source/version Openshift / Openshift CLI User Manuals, June 2016. mwah 💖