4.12. プラットフォーム Operator の管理 (テクノロジープレビュー)

手順

1. サポートされている OLM ベースの Operator のセットからプラットフォーム Operator を選択します。このセットのリストと現在の制限の詳細については、プラットフォーム Operator のテクノロジープレビューの制限を参照してください。
2. クラスターのインストール方法を選択し、指示に従って install-config.yaml ファイルを作成します。クラスターインストールの準備の詳細については、「クラスターインストール方法の選択とユーザー用の準備」を参照してください。

3. install-config.yaml ファイルを作成して変更を完了したら、インストールプログラムを含むディレクトリーに移動し、マニフェストを作成します。

   $ ./openshift-install create manifests --dir <installation_directory> 1

   1

   <installation_directory> については、クラスターの install-config.yaml ファイルが含まれるディレクトリーの名前を指定します。

4. <installation_directory>/manifests/ ディレクトリーに、TechPreviewNoUpgrade 機能セットを有効にする FeatureGate オブジェクト YAML ファイル (feature-gate.yaml ファイルなど) を作成します。

   feature-gate.yaml ファイルの例

   apiVersion: config.openshift.io/v1
   kind: FeatureGate
   metadata:
     annotations:
       include.release.openshift.io/self-managed-high-availability: "true"
       include.release.openshift.io/single-node-developer: "true"
       release.openshift.io/create-only: "true"
     name: cluster
   spec:
     featureSet: TechPreviewNoUpgrade 1

   1

   TechPreviewNoUpgrade 機能セットを有効にします。

5. 選択したプラットフォーム Operator の PlatformOperator オブジェクト YAML ファイルを <installation_directory>/manifests/ ディレクトリーに作成します。たとえば、Red Hat OpenShift の cert-manager Operator の cert-manager.yaml ファイルです。

   cert-manager.yaml ファイルの例

   apiVersion: platform.openshift.io/v1alpha1
   kind: PlatformOperator
   metadata:
     name: cert-manager
   spec:
     package:
       name: openshift-cert-manager-operator

6. クラスターのインストールを完了する準備ができたら、選択したインストール方法を参照し、openshift-install create cluster コマンドの実行を続行します。

   クラスターの作成中に、提供されたマニフェストを使用して TechPreviewNoUpgrade 機能セットを有効にし、選択したプラットフォーム Operator をインストールします。

   重要

   プラットフォーム Operator が正常にインストールされないと、クラスターのインストールプロセスがブロックされます。

検証

1. 次のコマンドを実行して、cert-managerプラットフォーム Operator のステータスを確認します。

   $ oc get platformoperator cert-manager -o yaml

   出力例

   ...
   status:
     activeBundleDeployment:
       name: cert-manager
     conditions:
     - lastTransitionTime: "2022-10-24T17:24:40Z"
       message: Successfully applied the cert-manager BundleDeployment resource
       reason: InstallSuccessful
       status: "True" 1
       type: Installed

   1

   Installed ステータス条件が True を報告するまで待ちます。

2. platform-operators-aggregated クラスター Operator が Available=True ステータスを報告していることを確認します。

   $ oc get clusteroperator platform-operators-aggregated -o yaml

   出力例

   ...
   status:
     conditions:
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       message: All platform operators are in a successful state
       reason: AsExpected
       status: "False"
       type: Progressing
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       status: "False"
       type: Degraded
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       message: All platform operators are in a successful state
       reason: AsExpected
       status: "True"
       type: Available

手順

1. サポートされている OLM ベースの Operator のセットからプラットフォーム Operator を選択します。このセットのリストと現在の制限の詳細については、プラットフォーム Operator のテクノロジープレビューの制限を参照してください。

2. 選択したプラットフォーム Operator の PlatformOperator オブジェクト YAML ファイルを作成します。たとえば、Red Hat OpenShift の cert-manager Operator の cert-manager.yaml ファイルです。

   cert-manager.yaml ファイルの例

   apiVersion: platform.openshift.io/v1alpha1
   kind: PlatformOperator
   metadata:
     name: cert-manager
   spec:
     package:
       name: openshift-cert-manager-operator

3. 次のコマンドを実行して、PlatformOperator オブジェクトを作成します。

   $ oc apply -f cert-manager.yaml

   注記

   クラスターで TechPreviewNoUpgrades 機能セットが有効になっていない場合、オブジェクトの作成は次のメッセージで失敗します。

   error: resource mapping not found for name: "cert-manager" namespace: "" from "cert-manager.yaml": no matches for kind "PlatformOperator" in version "platform.openshift.io/v1alpha1"
   ensure CRDs are installed first

検証

1. 次のコマンドを実行して、cert-managerプラットフォーム Operator のステータスを確認します。

   $ oc get platformoperator cert-manager -o yaml

   出力例

   ...
   status:
     activeBundleDeployment:
       name: cert-manager
     conditions:
     - lastTransitionTime: "2022-10-24T17:24:40Z"
       message: Successfully applied the cert-manager BundleDeployment resource
       reason: InstallSuccessful
       status: "True" 1
       type: Installed

   1

   Installed ステータス条件が True を報告するまで待ちます。

2. platform-operators-aggregated クラスター Operator が Available=True ステータスを報告していることを確認します。

   $ oc get clusteroperator platform-operators-aggregated -o yaml

   出力例

   ...
   status:
     conditions:
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       message: All platform operators are in a successful state
       reason: AsExpected
       status: "False"
       type: Progressing
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       status: "False"
       type: Degraded
     - lastTransitionTime: "2022-10-24T17:43:26Z"
       message: All platform operators are in a successful state
       reason: AsExpected
       status: "True"
       type: Available

手順

1. インストールされているプラットフォーム Operator のリストを取得し、削除する Operator の名前を見つけます。

   $ oc get platformoperator

2. 選択した Operator (Quay Operator など) の PlatformOperator リソースを削除します。

   $ oc delete platformoperator quay-operator

   出力例

   platformoperator.platform.openshift.io "quay-operator" deleted

検証

1. プラットフォーム Operator の namespace が最終的に削除されることを確認します (たとえば、Quay Operator の場合)。

   $ oc get ns quay-operator-system

   出力例

   Error from server (NotFound): namespaces "quay-operator-system" not found

2. platform-operators-aggregated クラスター Operator が引き続き Available=True ステータスを報告することを確認します。

   $ oc get co platform-operators-aggregated

   出力例

   NAME                            VERSION     AVAILABLE   PROGRESSING   DEGRADED   SINCE   MESSAGE
   platform-operators-aggregated   4.12.0-0    True        False         False      70s