第3章 Container Development Kit を使用した OpenShift との対話

minishift start コマンドは、cluster up 方法を使用してOpenShift クラスターを作成します。このため、oc バイナリーをホストにコピーします。

oc バイナリーは、$MINISHIFT_HOME/cache/oc/v3.11.374 ディレクトリーにあります。これは、CDK のデフォルトの OpenShift バージョンを使用することを前提とします。minishift oc-env を使用してこのバイナリーを PATH に追加できます。これは、シェルに入力する必要のあるコマンドを表示します。

minishift oc-env の出力は、オペレーティングシステムとシェルタイプによって異なります。

$ minishift oc-env
export PATH="/home/user/.minishift/cache/oc/v3.11.374:$PATH"
# Run this command to configure your shell:
# eval $(minishift oc-env)

minishift start コマンドの一環として、minishift という名前の CLI プロファイル も作成されます。このプロファイルは コンテキスト とも呼ばれ、OpenShift クラスターと通信するための設定が含まれます。

CDK は自動的にこのコンテキストをアクティベートしますが、たとえば別の OpenShift インスタンスにログインした後にそのコンテキストに戻す必要がある場合は、以下を実行します。

$ oc config use-context minishift

oc の使用方法の概要は、OpenShift ドキュメントの「CLI の使用方法」トピックを参照してください。

デフォルトでは、cluster upは、AllowAllPasswordIdentityProvider を使用してローカルクラスターに対して認証を行います。つまり、空でないユーザー名およびパスワードを使用してローカルクラスターにログインできます。

推奨されるユーザー名およびパスワードは、それぞれ developer と developer です。これは、そのユーザーおよびパスワードがすでにデフォルトのプロジェクト myproject に割り当てられており、管理者の 権限を借用 できるためです。これにより、--as system:admin パラメーターを使用して管理者コマンドを実行できます。

管理者としてログインするには、システムアカウントを使用します。

$ oc login -u system:admin

この場合は、クライアント証明書 が使用されます。証明書は ~/.kube/config に保存されます。cluster up コマンドは、ブートストラップの一部として適切な証明書をインストールします。

利用可能なログインコンテキストを表示するには、以下を実行します。

$ oc config view

OpenShift Web コンソール にアクセスするには、CDK を起動して Web コンソールの URL を取得するために、シェルでこのコマンドを実行します。

$ minishift console --url

または、CDK の起動後、以下のコマンドを使用してブラウザーでコンソールを直接開くことができます。

$ minishift console

ルートで公開されるサービスにアクセスするには、シェルで以下のコマンドを実行します。

$ minishift openshift service [-n NAMESPACE] [--url] NAME

詳細は、「サービスの公開」も参照してください。

OpenShift ログにアクセスするには、CDK の起動後に以下のコマンドを実行します。

$ minishift logs

OpenShift の実行中に、クラスターのマスターまたはノード設定を表示および変更できます。

OpenShift マスター設定ファイル master-config.yaml を表示するには、以下のコマンドを実行します。

$ minishift openshift config view

マスター設定の代わりにノードまたは kubeapi-server 設定を表示するには、target フラグを指定します。

view サブコマンドの詳細は、minishift openshift config view の概要を参照してください。

$  minishift openshift config set --patch '{"corsAllowedOrigins": [".*"]}'

PS> minishift.exe openshift config set --patch '{\"corsAllowedOrigins\": [\".*\"]}'

C:\> minishift.exe openshift config set --patch "{\"corsAllowedOrigins\": [\".*\"]}"

$ minishift openshift config set --patch '{"routingConfig": {"subdomain": "<IP-ADDRESS>.xip.io"}}'

コンポーネントを実行中の OpenShift クラスターに追加するには、以下を使用します。

$ minishift openshift component add <component-name>

$ minishift openshift component add service-catalog

実行中の OpenShift クラスターに追加できる有効なコンポーネントを一覧表示するには、以下を実行します。

$ minishift openshift component list