Oc get

External

• https://docs.openshift.com/container-platform/3.5/cli_reference/basic_cli_operations.html#get

Internal

• oc

Overview

Gets all resources of a certain type or a single resource of a certain type if specified by name.

Namespace Selection

Generic oc namespace selection applies.

Additionally, to specify all projects, use:

oc get --all-namespaces ...

Selectors

Selectors can be applied with the "-l" option:

oc get ... -l 'label_name=label_value'

To get (almost) all object with a specific label from the current project, execute:

oc get all -l '<label_name>=<label_value>'

Objects that are not displayed:

• Persistent volume claims

Output

JSON Output

oc get ... -o json

JSONPath Output

oc get ... -o jsonpath='{.spec.replicas}'

YAML Output

oc get ... -o yaml

-o template, --template

oc get --template '{{.spec.volumeName}}{{"\n"}}' pvc/<pvc-name>

oc get --template '{{.status.podIP}}{{"\n"}}' pods/<pod-name>

Example:

oc get node infranode1 --template '{{.spec.externalID}}{{"\n"}}'
infranode1

Other Options

-w

Watch for changes: after listing/getting the requested object, watch for changes.

Subcommands

all

oc [-n <project-name>] get all 

Displays DeploymentConfigs, replication controllers, routes, services, and pods for a project:

NAME                     REVISION   DESIRED   CURRENT   TRIGGERED BY
dc/logging-curator       1          1         1         config
dc/logging-es-3fs5ghyo   1          1         1         config
dc/logging-kibana        1          1         1         config

NAME                       DESIRED   CURRENT   READY     AGE
rc/logging-curator-1       1         1         1         25d
rc/logging-es-3fs5ghyo-1   1         1         1         25d
rc/logging-kibana-1        1         1         1         25d

NAME                    HOST/PORT                            PATH      SERVICES         PORT      TERMINATION          WILDCARD
routes/logging-kibana   kibana.apps.openshift.novaordis.io             logging-kibana   <all>     reencrypt/Redirect   None

NAME                     CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
svc/logging-es           172.30.254.155   <none>        9200/TCP   25d
svc/logging-es-cluster   172.30.148.235   <none>        9300/TCP   25d
svc/logging-kibana       172.30.123.83    <none>        443/TCP    25d

NAME                             READY     STATUS              RESTARTS   AGE
po/logging-curator-1-drmq5       1/1       Running             5532       24d
po/logging-es-3fs5ghyo-1-31p0n   1/1       Running             2          24d
po/logging-fluentd-3kz30         0/1       MatchNodeSelector   0          24d
po/logging-fluentd-d150b         0/1       MatchNodeSelector   0          24d
po/logging-fluentd-ktrc8         0/1       MatchNodeSelector   0          24d
po/logging-fluentd-kv781         0/1       MatchNodeSelector   0          24d
po/logging-fluentd-nl42s         0/1       MatchNodeSelector   0          24d
po/logging-fluentd-x1w4r         1/1       Running             2          24d
po/logging-fluentd-x2z8x         1/1       Running             2          24d
po/logging-kibana-1-d4bw2        2/2       Running             52         24d

bc

Returns the Build Config.

oc get bc

returns all build configs from the current project.

oc get bc my-build-config

returns the specified build config.

build, builds

Get the builds and their status.

oc get builds

clusternetwork

Information about the network plugin and network status.

See

OpenShift Network Plugins

deploymentconfig, dc

Lists the DeploymentConfigs of a project:

oc [-n <project-name>] get dc

ep

Get information about an endpoint. The following command can be used as a test for when a service comes on-line:

oc get ep postgresql -o yaml | grep "\- addresses:"

events

Lists events.

oc get events [-n <project-name>]

identity

Returns information about user identity.

oc get identity

images, image

List images available to the Cluster

imagestream, is

oc get is

istag

oc get istag

netnamespaces

OpenShift Network Operations - Information about Virtual Networks assigned to Projects

node, nodes

Displays all nodes:

oc get nodes [-n <project-name>]

All hosts in a healthy cluster should be visible in this output. The "Ready" status means that master hosts can communicate with node hosts and that the nodes are ready to run pods (excluding the nodes in which scheduling is disabled).

Describes an individual node:

oc get node <node-name>

pod, pods, po

Displays the pods of a project.

oc [-n <project-name>] get pods
oc [-n <project-name>] get po
oc get pods --all-namespaces

oc get pod <pod-name>

projects

oc get projects

For more details see

Project Operations

project

oc get project <project-name> -o yaml

sa

Returns the service accounts.

oc get sa

Also see

Service Account Operations

scc

Security Context Constraints Operations

services, svc

Displays the services of a project:

oc [-n <project-name>] get services
oc [-n <project-name>] get svc

se

oc get se docker-registry

secret

oc get secret

status

oc get status

quota

Quota Operations

replicationcontroller, rc

Lists the replication controllers of a project:

oc [-n <project-name>] get rc

routes, routes

Displays the project's routes.

oc get routes

users

Returns the regular users on the system. As "system:admin":

oc get users

NAME      UID                                    FULL NAME   IDENTITIES 
ovidiu    788f943e-610c-11e7-9dee-525400863964               htpasswd_auth:ovidiu