3.2. コマンドラインを使用した JWS Operator のインストール
コマンドラインインターフェイスを使用して JWS Operator をインストールする場合は、oc
コマンドラインツールを使用して JWS Operator をインストールできます。Red Hat が提供する JWS Operator の名前は jws-operator
です。
コマンドラインから JWS Operator をインストールする手順には、Operator でサポートされているインストールモードと使用可能なチャネルの確認、およびサブスクリプションオブジェクトの作成が含まれます。Operator が使用するインストールモードによっては、サブスクリプションオブジェクトを作成する前に、プロジェクトの名前空間に Operator グループを作成する必要があります。
前提条件
- Operator インストールパーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにデプロイできる。
-
ローカルシステムに
oc
ツールがインストールされている。
手順
JWS Operator を調べるには、次の手順を実行します。
OperatorHub からクラスターで使用できる JWS Operator のリストを表示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc get packagemanifests -n openshift-marketplace | grep jws
$ oc get packagemanifests -n openshift-marketplace | grep jws
上記のコマンドは、使用可能な各 Operator の名前、カタログ、および経過時間を表示します。
以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NAME CATALOG AGE jws-operator Red Hat Operators 16h
NAME CATALOG AGE jws-operator Red Hat Operators 16h
JWS Operator を調べて、Operator でサポートされているインストールモードと使用可能なチャネルを確認します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc describe packagemanifests jws-operator -n openshift-marketplace
$ oc describe packagemanifests jws-operator -n openshift-marketplace
Operator グループの実際のリストを確認します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc get operatorgroups -n <project_name>
$ oc get operatorgroups -n <project_name>
前述の例で、
<project_name>
を OpenShift プロジェクト名に置き換えます。上記のコマンドは、使用可能な各 Operator グループの名前と経過時間を表示します。
以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow NAME AGE mygroup 17h
NAME AGE mygroup 17h
Operator グループを作成する必要がある場合は、次の手順を実行します。
注記インストールする Operator が
SingleNamespace
インストールモードを使用し、適切な Operator グループがまだ配置されていない場合は、この手順を完了して Operator グループを作成する必要があります。指定された名前空間に Operator グループを 1 つだけ作成します。インストールする Operator が
AllNamespaces
インストールモードを使用する場合、または適切な Operator グループがすでに配置されている場合は、この手順を無視できます。OperatorGroup
オブジェクトの YAML ファイルを作成します。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: <operatorgroup_name> namespace: <project_name> spec: targetNamespaces: - <project_name>
apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: <operatorgroup_name> namespace: <project_name> spec: targetNamespaces: - <project_name>
前の例で、
<operatorgroup_name>
を作成する Operator グループの名前に置き換え、<project_name>
を Operator をインストールするプロジェクトの名前に置き換えます。プロジェクト名を表示するには、oc project -q
コマンドを実行します。YAML ファイルから
OperatorGroup
オブジェクトを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc apply -f <filename>.yaml
$ oc apply -f <filename>.yaml
前の例の
<filename>.yaml
を、OperatorGroup
オブジェクト用に作成した YAML ファイルの名前に置き換えます。
サブスクリプションオブジェクトを作成するには、次の手順を実行します。
Subscription
オブジェクトの YAML ファイルを作成します。以下に例を示します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: jws-operator namespace: <project_name> spec: channel: alpha name: jws-operator source: redhat-operators sourceNamespace: openshift-marketplace
apiVersion: operators.coreos.com/v1alpha1 kind: Subscription metadata: name: jws-operator namespace: <project_name> spec: channel: alpha name: jws-operator source: redhat-operators sourceNamespace: openshift-marketplace
前の例で、
<project_name>
を Operator をインストールするプロジェクトの名前に置き換えます。プロジェクト名を表示するには、oc project -q
コマンドを実行します。指定する名前空間には、Operator と同じインストールモード設定を持つ
OperatorGroup
オブジェクトが必要です。Operator がAllNamespaces
インストールモードを使用する場合は、<project_name>
をすでに適切な Operator グループを提要しているopenshift-operators
に置き換えます。Operator がSingleNamespace
インストールモードを使用する場合は、この名前空間にOperatorGroup
オブジェクトが 1 つだけあることを確認してください。source
設定が、Operator で使用可能なチャネルを確認したときに表示されたCatalog Source
値 (例:redhat-operators
) と一致していることを確認します。YAML ファイルから
Subscription
オブジェクトを作成します。Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc apply -f <filename>.yaml
$ oc apply -f <filename>.yaml
前の例の
<filename>.yaml
を、Subscription
オブジェクト用に作成した YAML ファイルの名前に置き換えます。
検証
JWS Operator が正常にインストールされたことを確認するには、次のコマンドを入力します。
Copy to Clipboard Copied! Toggle word wrap Toggle overflow oc get csv -n <project_name>
$ oc get csv -n <project_name>
上の例で、
<project_name>
を、Operator をインストールしたプロジェクトの名前空間に置き換えます。このコマンドは、インストールされている Operator の詳細を表示します。
以下に例を示します。
NAME DISPLAY VERSION REPLACES PHASE jws-operator.v2.1.x
JWS Operator
2.1.x
jws-operator.v2.0.y
Succeeded
上記の出力では、
2.1.x
は現在の Operator バージョン (例:2.1.0
) を表し、2.0.y
は現行バージョンに置き換わる前の Operator バージョン (例:2.0.15
) を表しています。