3.4. JWS Operator のインストール
以下のいずれかの方法を使用して、OpenShift 用の JBoss Web Server (JWS) Operator をインストールできます。
3.4.1. Web コンソールを使用した JWS Operator のインストール
OpenShift Web コンソールを使用して JWS Operator をインストールできます。
前提条件
-
cluster-admin
および Operator インストールのパーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにアクセスできる。
手順
Web コンソールを開き、Operator タブに移動します。
OpenShift OperatorHub が開きます。
JWS を検索し、JWS Operator を選択します。
新しいメニューが表示されます。
- 使用する容量レベルを選択します。
- Operator をインストールするには、コンソールの開始時に Install をクリックします。
Operator のインストールをセットアップするには、次の手順を実行します。
Operator をインストールするクラスターの namespace を指定して、インストールモードを指定します。
注記namespace を指定しない場合、Operator はデフォルトでクラスター上のすべての namespace にインストールされます。
JWS Operator が使用可能な更新チャネルを指定します。
注記JWS Operator は現在 1 つのチャネルからのみ利用できます。
Automatic 更新または Manual 更新を選択して、承認戦略を指定します。
注記Automatic 更新を選択した場合、Operator の新しいバージョンが利用可能になると、Operator Lifecycle Manager (OLM) は Operator の実行中のインスタンスを自動的にアップグレードします。
Manual (手動) 更新を選択した場合、Operator の新しいバージョンが使用できるようになると、OLM によって更新リクエストが作成されます。クラスター管理者は、更新リクエストを手動で承認して、Operator が新しいバージョンに更新されるようにする必要があります。
Install をクリックします。
注記Manual 承認戦略を選択した場合は、インストールが完了する前にインストール計画を承認する必要があります。JWS Operator が Operators タブの Installed Operators セクションに表示されるようになりました。
3.4.2. コマンドラインからの JWS Operator のインストール
oc
コマンドラインツールを使用して JWS Operator をインストールできます。コマンドラインから JWS Operator をインストールする手順には、Operator でサポートされている installModes と使用可能なチャネルの確認、Operator グループの作成、および Subscription オブジェクトの作成が含まれます。
Web コンソールを使用して JWS Operator をインストールし、Operator が SingleNamespace
モードを使用している場合、OperatorGroup
および Subscription
オブジェクトが自動的にインストールされます。
前提条件
- Operator インストールパーミッションを持つアカウントを使用して OpenShift Container Platform クラスターにデプロイできること。
-
ローカルシステムに
oc
ツールがインストールされている。
手順
JWS Operator を調べるには、次の手順を実行します。
JWS Operator でサポートされているインストールモードを確認するには、次のコマンドを入力します。
$ oc get packagemanifests -n openshift-marketplace | grep jws
上記のコマンドは、次のタイプの出力を生成します。
jws-operator Red Hat Operators 16h
JWS Operator で使用可能なチャネルを確認するには、次のコマンドを入力します。
$ oc describe packagemanifests jws-operator -n openshift-marketplace | grep "Catalog Source"
上記のコマンドは、次のタイプの出力を生成します。
Catalog Source: redhat-operators
Operator グループを作成するには、次の手順を実行します。
Operator グループの実際のリストを確認するには、次のコマンドを入力します。
$ oc get operatorgroups -n <project_name>
注記前の例で、<project_name> を OpenShift プロジェクト名に置き換えます。
上記のコマンドは、次のタイプの出力を生成します。
NAME AGE mygroup 17h
OperatorGroup
オブジェクトの YAML ファイルを作成します。以下に例を示します。
apiVersion: operators.coreos.com/v1 kind: OperatorGroup metadata: name: <operatorgroup_name> namespace: <project_name> spec: targetNamespaces: - <project_name>
注記前の例で、
<project_name>
を、Operator をインストールするプロジェクトの namespace (oc project -q
) に置き換えます。`<operatorgroup_name>
をOperatorGroup
オブジェクトの名前に置き換えます。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 をインストールするプロジェクトの namespace (oc project -q
) に置き換えます。Operator がAllNamespaces
モードを使用している場合、<project_name>
をopenshift-operators
に置き換えます。Operator で使用可能なチャネル (
redhat-operators
など) を確認したときのコマンドライン出力に基づいて、source
設定がCatalog source
値と一致していることを確認します。YAML ファイルから
Subscription
オブジェクトを作成します。$ oc apply -f <filename>.yaml
注記前の例の
<filename>.yaml
を、Subscription
オブジェクト用に作成した YAML ファイルの名前に置き換えます。
検証
JWS Operator が正常にインストールされたことを確認するには、次のコマンドを入力します。
$ oc get csv -n <project_name>
注記前の例で、
<project_name>
を Operator をインストールしたプロジェクトの namespace に置き換えます。上記のコマンドは、次のタイプの出力を生成します。
名前 DISPLAY バージョン REPLACE PHASE jws-operator.V<version>
JBoss Web Server Operator
<version>
Succeeded
注記上記の例では、
<version>
は Operator バージョンを参照します (例:1.1.0
)。