1.6. multicluster engine Operator のインストールとアップグレード

OpenShift Container Platform クラスターが正しく設定されていることを確認するには、以下のコマンドを使用して OpenShift Container Platform Web コンソールにアクセスします。

kubectl -n openshift-console get route console

以下の出力例を参照してください。

console console-openshift-console.apps.new-coral.purple-chesterfield.com
console   https   reencrypt/Redirect     None

Operator Installation ページで、インストールのオプションを選択します。

注記: 次のマイナーリリースにアップグレードするには、Red Hat OpenShift ソフトウェアカタログに戻り、より新しいリリースの新しいチャネルを選択する必要があります。

MultiClusterEngine カスタムリソースを作成するには、次のプロセスを参照してください。

Create を選択して、カスタムリソースを初期化します。multicluster engine Operator エンジンがビルドされて起動するまで、最大 10 分かかる場合があります。

MultiClusterEngine リソースが作成されると、リソースのステータスが MultiCluster Engine タブで Available になります。

Operator の要件を満たす、multicluster engine Operator エンジンの namespace を作成します。次のコマンドを実行します。ここで、namespace は multicluster engine Operator の namespace の名前です。namespace の値は、OpenShift Container Platform 環境では プロジェクト と呼ばれる場合があります。

oc create namespace <namespace>

プロジェクトの namespace を、作成した namespace に切り替えます。namespace は、手順 1 で作成した namespace 名に置き換えます。

oc project <namespace>

OperatorGroup リソースを設定するために YAML ファイルを作成します。namespace ごとに割り当てることができる Operator グループは 1 つだけです。default はお使いの operator グループ名に置き換えます。namespace はお使いのプロジェクトの namespace 名に置き換えます。以下の例を参照してください。

apiVersion: operators.coreos.com/v1
kind: OperatorGroup
metadata:
  name: <default>
  namespace: <namespace>
spec:
  targetNamespaces:
  - <namespace>

以下のコマンドを実行して OperatorGroup リソースを作成します。operator-group は、作成した operator グループの YAML ファイル名に置き換えます。

oc apply -f <path-to-file>/<operator-group>.yaml

OpenShift Container Platform サブスクリプションを設定するための YAML ファイルを作成します。ファイルは次の例のようになります。<stable-2.x> は、使用しているサポート対象のバージョンを表すものに変更してください。

apiVersion: operators.coreos.com/v1alpha1
kind: Subscription
metadata:
  name: multicluster-engine
spec:
  sourceNamespace: openshift-marketplace
  source: redhat-operators
  channel: stable-2.x
  installPlanApproval: Automatic
  name: multicluster-engine

注記: インフラストラクチャーノードを設定するには、multicluster engine Operator のインフラストラクチャーノードの設定 を参照してください。

以下のコマンドを実行して OpenShift Container Platform サブスクリプションを作成します。subscription は、作成したサブスクリプションファイル名に置き換えます。

oc apply -f <path-to-file>/<subscription>.yaml

YAML ファイルを作成して、MultiClusterEngine カスタムリソースを設定します。デフォルトのテンプレートは、以下の例のようになります。

apiVersion: multicluster.openshift.io/v1
kind: MultiClusterEngine
metadata:
  name: multiclusterengine
spec: {}

注記: インフラストラクチャーノードに multicluster engine Operator をインストールする場合は、MultiClusterEngine カスタムリソースの追加設定 セクションを参照してください。

次のコマンドを実行して、MultiClusterEngine カスタムリソースを作成します。custom-resource は、カスタムリソースファイル名に置き換えます。

oc apply -f <path-to-file>/<custom-resource>.yaml

以下のエラーで、この手順に失敗した場合でも、リソースは作成され、適用されます。リソースが作成されてから数分後にもう一度コマンドを実行します。

error: unable to recognize "./mce.yaml": no matches for kind "MultiClusterEngine" in version "operator.multicluster-engine.io/v1"

以下のコマンドを実行してカスタムリソースを取得します。次のコマンドを実行した後、MultiClusterEngine カスタムリソースステータスが status.phase フィールドに Available として表示されるまでに最大 10 分かかる場合があります。

oc get mce -o=jsonpath='{.items[0].status.phase}'