第1章 OpenShift CLI (oc)

• プロジェクトのソースコードを直接使用している。
• OpenShift Container Platform の操作をスクリプト化する。
• 帯域幅リソースの制限下にあり、Web コンソールを使用できない。

前提条件

• OpenShift Container Platform クラスターへのアクセスがあること。
• CLI をインストールしていること。

手順

• oc login コマンドを使用して CLI にログインし、プロンプトが出されたら必要な情報を入力します。

  $ oc login

  出力例

  Server [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

  OpenShift Container Platform サーバー URL を入力します。

  2

  非セキュアな接続を使用するかどうかを入力します。

  3

  ログインに使用するユーザー名を入力します。

  4

  ユーザーのパスワードを入力します。

• 利用可能なすべての CLI コマンドの一覧および説明を表示するには、oc help を使用します。

  例: CLI についての一般的なヘルプの表示

  $ oc help

  出力例

  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.
  
  Usage:
    oc [flags]
  
  Basic Commands:
    login           Log in to a server
    new-project     Request a new project
    new-app         Create a new application
  
  ...

• 特定の CLI コマンドについてのヘルプを表示するには、--help フラグを使用します。

  例: oc create コマンドについてのヘルプの表示

  $ oc create --help

  出力例

  Create a resource by filename or stdin
  
  JSON and YAML formats are accepted.
  
  Usage:
    oc create -f FILENAME [flags]
  
  ...

• 特定リソースについての説明およびフィールドを表示するには、oc explain コマンドを使用します。

  例: Pod リソースのドキュメントの表示

  $ oc explain pods

  出力例

  KIND:     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
  
  ...

• oc logout コマンドを使用します。

  $ oc logout

  出力例

  Logged "user1" out on "https://openshift.example.com"