$ tar xvzf <file>
With the OpenShift command-line interface (CLI), the oc command, you can create applications and manage OKD projects from a terminal. The OpenShift CLI is ideal in the following situations:
Working directly with project source code
Scripting OKD operations
Managing projects while restricted by bandwidth resources and the web console is unavailable
You can install the OpenShift CLI (oc) either by downloading the binary or by using an RPM.
You can install the OpenShift CLI (oc) in order to interact with OKD from a
command-line interface. You can install oc on Linux, Windows, or macOS.
|
If you installed an earlier version of |
You can install the OpenShift CLI (oc) binary on Linux by using the following procedure.
Navigate to https://mirror.openshift.com/pub/openshift-v4/clients/oc/latest/ and choose the folder for your operating system and architecture.
Download oc.tar.gz.
Unpack the archive:
$ tar xvzf <file>Place the oc binary in a directory that is on your PATH.
To check your PATH, execute the following command:
$ echo $PATHAfter you install the CLI, it is available using the oc command:
$ oc <command>You can install the OpenShift CLI (oc) binary on Windows by using the following procedure.
Navigate to https://mirror.openshift.com/pub/openshift-v4/clients/oc/latest/ and choose the folder for your operating system and architecture.
Download oc.zip.
Unzip the archive with a ZIP program.
Move the oc binary to a directory that is on your PATH.
To check your PATH, open the command prompt and execute the following command:
C:\> pathAfter you install the CLI, it is available using the oc command:
C:\> oc <command>You can install the OpenShift CLI (oc) binary on macOS by using the following procedure.
Navigate to https://mirror.openshift.com/pub/openshift-v4/clients/oc/latest/ and choose the folder for your operating system and architecture.
Download oc.tar.gz.
Unpack and unzip the archive.
Move the oc binary to a directory on your PATH.
To check your PATH, open a terminal and execute the following command:
$ echo $PATHAfter you install the CLI, it is available using the oc command:
$ oc <command>You can log in to the oc CLI to access and manage your cluster.
You must have access to an OKD cluster.
You must have installed the CLI.
|
To access a cluster that is accessible only over an HTTP proxy server, you can set the |
Log in to the CLI using the oc login command and enter the required
information when prompted.
$ oc loginServer [https://localhost:8443]: https://openshift.example.com:6443 (1)
The server uses a certificate signed by an unknown authority.
You can bypass the certificate check, but any data you send to the server could be intercepted by others.
Use insecure connections? (y/n): y (2)
Authentication required for https://openshift.example.com:6443 (openshift)
Username: user1 (3)
Password: (4)
Login successful.
You don't have any projects. You can try to create a new project, by running
oc new-project <projectname>
Welcome! See 'oc help' to get started.| 1 | Enter the OKD server URL. |
| 2 | Enter whether to use insecure connections. |
| 3 | Enter the user name to log in as. |
| 4 | Enter the user’s password. |
You can now create a project or issue other commands for managing your cluster.
Review the following sections to learn how to complete common tasks using the CLI.
Use the oc new-project command to create a new project.
$ oc new-project my-projectNow using project "my-project" on server "https://openshift.example.com:6443".Use the oc new-app command to create a new application.
$ oc new-app https://github.com/sclorg/cakephp-ex--> Found image 40de956 (9 days old) in imagestream "openshift/php" under tag "7.2" for "php"
...
Run 'oc status' to view your app.Use the oc get pods command to view the pods for the current project.
$ oc get pods -o wideNAME READY STATUS RESTARTS AGE IP NODE NOMINATED NODE
cakephp-ex-1-build 0/1 Completed 0 5m45s 10.131.0.10 ip-10-0-141-74.ec2.internal <none>
cakephp-ex-1-deploy 0/1 Completed 0 3m44s 10.129.2.9 ip-10-0-147-65.ec2.internal <none>
cakephp-ex-1-ktz97 1/1 Running 0 3m33s 10.128.2.11 ip-10-0-168-105.ec2.internal <none>Use the oc logs command to view logs for a particular pod.
$ oc logs cakephp-ex-1-deploy--> Scaling cakephp-ex-1 to 1
--> SuccessUse the oc project command to view the current project.
$ oc projectUsing project "my-project" on server "https://openshift.example.com:6443".Use the oc status command to view information about the current project, such
as services, deployments, and build configs.
$ oc statusIn project my-project on server https://openshift.example.com:6443
svc/cakephp-ex - 172.30.236.80 ports 8080, 8443
dc/cakephp-ex deploys istag/cakephp-ex:latest <-
bc/cakephp-ex source builds https://github.com/sclorg/cakephp-ex on openshift/php:7.2
deployment #1 deployed 2 minutes ago - 1 pod
3 infos identified, use 'oc status --suggest' to see details.You can get help with CLI commands and OKD resources in the following ways.
Use oc help to get a list and description of all available CLI commands:
$ oc helpOpenShift 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.
Usage:
oc [flags]
Basic Commands:
login Log in to a server
new-project Request a new project
new-app Create a new application
...Use the --help flag to get help about a specific CLI command:
oc create command$ oc create --helpCreate a resource by filename or stdin
JSON and YAML formats are accepted.
Usage:
oc create -f FILENAME [flags]
...Use the oc explain command to view the description and fields for a
particular resource:
Pod resource$ oc explain podsKIND: Pod
VERSION: v1
DESCRIPTION:
Pod is a collection of containers that can run on a host. This resource is
created by clients and scheduled onto hosts.
FIELDS:
apiVersion <string>
APIVersion defines the versioned schema of this representation of an
object. Servers should convert recognized schemas to the latest internal
value, and may reject unrecognized values. More info:
https://git.k8s.io/community/contributors/devel/api-conventions.md#resources
...You can log out the OpenShift CLI to end your current session.
Use the oc logout command.
$ oc logoutLogged "user1" out on "https://openshift.example.com"This deletes the saved authentication token from the server and removes it from your configuration file.