oc - Man Page
Command line tools for managing applications
Examples (TL;DR)
- Log in to the OpenShift Container Platform server:
oc login
- Create a new project:
oc new-project project_name
- Switch to an existing project:
oc project project_name
- Add a new application to a project:
oc new-app repo_url --name application
- Open a remote shell session to a container:
oc rsh pod_name
- List pods in a project:
oc get pods
- Logout from the current session:
oc logout
Synopsis
oc [Options]
Description
OpenShift Client
This client helps you develop, build, deploy, and run your applications on any OpenShift or Kubernetes compatible platform. It also includes the administrative commands for managing a cluster under the 'adm' subcommand.
Options
- --allow_verification_with_non_compliant_keys=false
Allow a SignatureVerifier to use keys which are technically non-compliant with RFC6962.
- --alsologtostderr=false
log to standard error as well as files
- --application_metrics_count_limit=100
Max number of application metrics to store (per container)
- --as=""
Username to impersonate for the operation
- --as-group=[]
Group to impersonate for the operation, this flag can be repeated to specify multiple groups.
- --azure-container-registry-config=""
Path to the file containing Azure container registry configuration information.
- --boot_id_file="/proc/sys/kernel/random/boot_id"
Comma-separated list of files to check for boot-id. Use the first one that exists.
- --cache-dir="/builddir/.kube/http-cache"
Default HTTP 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
- --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
CIDRs opened in GCE firewall for LB traffic proxy health checks
- --cluster=""
The name of the kubeconfig cluster to use
- --container_hints="/etc/cadvisor/container_hints.json"
location of the container hints file
- --containerd="unix:///var/run/containerd.sock"
containerd endpoint
- --context=""
The name of the kubeconfig context to use
- --default-not-ready-toleration-seconds=300
Indicates the tolerationSeconds of the toleration for notReady:NoExecute that is added by default to every pod that does not already have such a toleration.
- --default-unreachable-toleration-seconds=300
Indicates the tolerationSeconds of the toleration for unreachable:NoExecute that is added by default to every pod that does not already have such a toleration.
- --docker="unix:///var/run/docker.sock"
docker endpoint
- --docker-tls=false
use TLS to connect to docker
- --docker-tls-ca="ca.pem"
path to trusted CA
- --docker-tls-cert="cert.pem"
path to client certificate
- --docker-tls-key="key.pem"
path to private key
- --docker_env_metadata_whitelist=""
a comma-separated list of environment variable keys that needs to be collected for docker containers
- --docker_only=false
Only report docker containers in addition to root stats
- --docker_root="/var/lib/docker"
DEPRECATED: docker root is read from docker info (this is a fallback, default: /var/lib/docker)
- --enable_load_reader=false
Whether to enable cpu load reader
- --event_storage_age_limit="default=24h"
Max length of time for which to store events (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is a duration. Default is applied to all non-specified event types
- --event_storage_event_limit="default=100000"
Max number of events to store (per type). Value is a comma separated list of key values, where the keys are event types (e.g.: creation, oom) or "default" and the value is an integer. Default is applied to all non-specified event types
- --global_housekeeping_interval=0
Interval between global housekeepings
- --housekeeping_interval=0
Interval between container housekeepings
- --insecure-skip-tls-verify=false
If true, the server's certificate will not be checked for validity. This will make your HTTPS connections insecure
- --kubeconfig=""
Path to the kubeconfig file to use for CLI requests.
- --log-flush-frequency=0
Maximum number of seconds between log flushes
- --log_backtrace_at=:0
when logging hits line file:N, emit a stack trace
- --log_cadvisor_usage=false
Whether to log the usage of the cAdvisor container
- --log_dir=""
If non-empty, write log files in this directory
- --logtostderr=true
log to standard error instead of files
- --machine_id_file="/etc/machine-id,/var/lib/dbus/machine-id"
Comma-separated list of files to check for machine-id. Use the first one that exists.
- --match-server-version=false
Require server version to match client version
- -n, --namespace=""
If present, the namespace scope for this CLI request
- --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
- --stderrthreshold=2
logs at or above this threshold go to stderr
- --storage_driver_buffer_duration=0
Writes in the storage driver will be buffered for this duration, and committed to the non memory backends as a single transaction
- --storage_driver_db="cadvisor"
database name
- --storage_driver_host="localhost:8086"
database host:port
- --storage_driver_password="root"
database password
- --storage_driver_secure=false
use secure connection with database
- --storage_driver_table="stats"
table name
- --storage_driver_user="root"
database username
- --token=""
Bearer token for authentication to the API server
- --user=""
The name of the kubeconfig user to use
- -v, --v=0
log level for V logs
- --version=false
Print version information and quit
- --vmodule=
comma-separated list of pattern=N settings for file-filtered logging
See Also
oc-adm(1), oc-annotate(1), oc-api-resources(1), oc-api-versions(1), oc-apply(1), oc-attach(1), oc-auth(1), oc-autoscale(1), oc-build-logs(1), oc-cancel-build(1), oc-cluster(1), oc-completion(1), oc-config(1), oc-convert(1), oc-cp(1), oc-create(1), oc-debug(1), oc-delete(1), oc-describe(1), oc-edit(1), oc-ex(1), oc-exec(1), oc-explain(1), oc-export(1), oc-expose(1), oc-extract(1), oc-get(1), oc-idle(1), oc-image(1), oc-import(1), oc-import-image(1), oc-label(1), oc-login(1), oc-logout(1), oc-logs(1), oc-new-app(1), oc-new-build(1), oc-new-project(1), oc-observe(1), oc-options(1), oc-patch(1), oc-plugin(1), oc-policy(1), oc-port-forward(1), oc-process(1), oc-project(1), oc-projects(1), oc-proxy(1), oc-registry(1), oc-replace(1), oc-rollback(1), oc-rollout(1), oc-rsh(1), oc-rsync(1), oc-run(1), oc-scale(1), oc-secrets(1), oc-serviceaccounts(1), oc-set(1), oc-start-build(1), oc-status(1), oc-tag(1), oc-types(1), oc-version(1), oc-wait(1), oc-whoami(1),
History
June 2016, Ported from the Kubernetes man-doc generator
Referenced By
oc-adm(1), oc-annotate(1), oc-api-resources(1), oc-api-versions(1), oc-apply(1), oc-attach(1), oc-auth(1), oc-autoscale(1), oc-build-logs(1), oc-cancel-build(1), oc-cluster(1), oc-completion(1), oc-config(1), oc-convert(1), oc-cp(1), oc-create(1), oc-debug(1), oc-delete(1), oc-describe(1), oc-edit(1), oc-ex(1), oc-exec(1), oc-explain(1), oc-export(1), oc-expose(1), oc-extract(1), oc-get(1), oc-idle(1), oc-image(1), oc-import(1), oc-import-image(1), oc-inject(1), oc-label(1), oc-login(1), oc-logout(1), oc-logs(1), oc-new-app(1), oc-new-build(1), oc-new-project(1), oc-observe(1), oc-options(1), oc-patch(1), oc-plugin(1), oc-policy(1), oc-port-forward(1), oc-process(1), oc-project(1), oc-projects(1), oc-proxy(1), oc-registry(1), oc-replace(1), oc-rollback(1), oc-rollout(1), oc-rsh(1), oc-rsync(1), oc-run(1), oc-scale(1), oc-secrets(1), oc-serviceaccounts(1), oc-set(1), oc-start-build(1), oc-status(1), oc-tag(1), oc-types(1), oc-version(1), oc-wait(1), oc-whoami(1).