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 のリストを表示します。
$ oc get packagemanifests -n openshift-marketplace | grep jws上記のコマンドは、使用可能な各 Operator の名前、カタログ、および経過時間を表示します。
以下に例を示します。
NAME CATALOG AGE jws-operator Red Hat Operators 16hJWS Operator を調べて、Operator でサポートされているインストールモードと使用可能なチャネルを確認します。
$ oc describe packagemanifests jws-operator -n openshift-marketplace
Operator グループの実際のリストを確認します。
$ oc get operatorgroups -n <project_name>前述の例で、
<project_name>を OpenShift プロジェクト名に置き換えます。上記のコマンドは、使用可能な各 Operator グループの名前と経過時間を表示します。
以下に例を示します。
NAME AGE mygroup 17hOperator グループを作成する必要がある場合は、次の手順を実行します。
注記インストールする Operator が
SingleNamespaceインストールモードを使用し、適切な Operator グループがまだ配置されていない場合は、この手順を完了して Operator グループを作成する必要があります。指定された名前空間に Operator グループを 1 つだけ作成します。インストールする Operator が
AllNamespacesインストールモードを使用する場合、または適切な Operator グループがすでに配置されている場合は、この手順を無視できます。OperatorGroupオブジェクトの YAML ファイルを作成します。以下に例を示します。
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オブジェクトを作成します。$ oc apply -f <filename>.yaml前の例の
<filename>.yamlを、OperatorGroupオブジェクト用に作成した YAML ファイルの名前に置き換えます。
サブスクリプションオブジェクトを作成するには、次の手順を実行します。
Subscriptionオブジェクトの YAML ファイルを作成します。以下に例を示します。
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オブジェクトを作成します。$ oc apply -f <filename>.yaml前の例の
<filename>.yamlを、Subscriptionオブジェクト用に作成した YAML ファイルの名前に置き換えます。
検証
JWS Operator が正常にインストールされたことを確認するには、次のコマンドを入力します。
$ oc get csv -n <project_name>上の例で、
<project_name>を、Operator をインストールしたプロジェクトの名前空間に置き換えます。このコマンドは、インストールされている Operator の詳細を表示します。
以下に例を示します。
Expand 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) を表しています。