5.5. Compliance Operator の管理

手順

1. OpenShift Container Platform Web コンソールで、Operators OperatorHub ページに移動します。
2. Compliance Operator を検索し、Install をクリックします。
3. Installation mode および namespace のデフォルトの選択を維持し、Operator が openshift-compliance namespace にインストールされていることを確認します。
4. Install をクリックします。

1. Operators Installed Operators ページに移動します。
2. Compliance Operator が openshift-compliance namespace にインストールされ、そのステータスが Succeeded であることを確認します。

1. Operators Installed Operators ページに移動し、Status 列でエラーまたは失敗の有無を確認します。
2. Workloads Pods ページに移動し、openshift-compliance プロジェクトの Pod で問題を報告しているログの有無を確認します。

手順

1. Namespace オブジェクトを定義します。

   namespace-object.yaml の例

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
       pod-security.kubernetes.io/enforce: privileged 1
     name: openshift-compliance

   1

   OpenShift Container Platform 4.16 では、Pod セキュリティーラベルを namespace レベルで privileged に設定する必要があります。

2. Namespace オブジェクトを作成します。

   $ oc create -f namespace-object.yaml

3. OperatorGroup オブジェクトを定義します。

   operator-group-object.yaml の例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: compliance-operator
     namespace: openshift-compliance
   spec:
     targetNamespaces:
     - openshift-compliance

4. OperatorGroup オブジェクトを作成します。

   $ oc create -f operator-group-object.yaml

5. Subscription オブジェクトを定義します。

   subscription-object.yaml の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: compliance-operator-sub
     namespace: openshift-compliance
   spec:
     channel: "stable"
     installPlanApproval: Automatic
     name: compliance-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace

6. Subscription オブジェクトを作成します。

   $ oc create -f subscription-object.yaml

検証

1. CSV ファイルを確認して、インストールが正常に完了したことを確認します。

   $ oc get csv -n openshift-compliance

2. Compliance Operator が稼働していることを確認します。

   $ oc get deploy -n openshift-compliance

手順

1. Namespace オブジェクトを定義します。

   namespace-object.yaml ファイルの例

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
       pod-security.kubernetes.io/enforce: privileged 1
     name: openshift-compliance

   1

   OpenShift Container Platform 4.16 では、Pod セキュリティーラベルを namespace レベルで privileged に設定する必要があります。

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

   $ oc create -f namespace-object.yaml

3. OperatorGroup オブジェクトを定義します。

   operator-group-object.yaml ファイルの例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: compliance-operator
     namespace: openshift-compliance
   spec:
     targetNamespaces:
     - openshift-compliance

4. 以下のコマンドを実行して OperatorGroup オブジェクトを作成します。

   $ oc create -f operator-group-object.yaml

5. Subscription オブジェクトを定義します。

   subscription-object.yaml ファイルの例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: compliance-operator-sub
     namespace: openshift-compliance
   spec:
     channel: "stable"
     installPlanApproval: Automatic
     name: compliance-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     config:
       nodeSelector:
         node-role.kubernetes.io/worker: "" 1

   1

   Operator デプロイメントを更新して、worker ノードにデプロイします。

6. 以下のコマンドを実行して Subscription オブジェクトを作成します。

   $ oc create -f subscription-object.yaml

検証

1. 次のコマンドを実行してクラスターサービスバージョン (CSV) ファイルを調べ、インストールが成功したことを確認します。

   $ oc get csv -n openshift-compliance

2. 次のコマンドを使用して、Compliance Operator が起動して実行されていることを確認します。

   $ oc get deploy -n openshift-compliance

手順

1. 以下のような Namespace オブジェクトを定義します。

   namespace-object.yaml の例

   apiVersion: v1
   kind: Namespace
   metadata:
     labels:
       openshift.io/cluster-monitoring: "true"
       pod-security.kubernetes.io/enforce: privileged 1
     name: openshift-compliance

   1

   OpenShift Container Platform 4.16 では、Pod セキュリティーラベルを namespace レベルで privileged に設定する必要があります。

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

   $ oc create -f namespace-object.yaml

3. OperatorGroup オブジェクトを定義します。

   operator-group-object.yaml の例

   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: compliance-operator
     namespace: openshift-compliance
   spec:
     targetNamespaces:
     - openshift-compliance

4. 以下のコマンドを実行して OperatorGroup オブジェクトを作成します。

   $ oc create -f operator-group-object.yaml

5. Subscription オブジェクトを定義します。

   subscription-object.yaml の例

   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: compliance-operator-sub
     namespace: openshift-compliance
   spec:
     channel: "stable"
     installPlanApproval: Automatic
     name: compliance-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     config:
       nodeSelector:
         node-role.kubernetes.io/worker: ""
       env:
       - name: PLATFORM
         value: "HyperShift"

6. 以下のコマンドを実行して Subscription オブジェクトを作成します。

   $ oc create -f subscription-object.yaml

検証

1. 以下のコマンドを実行して CSV ファイルを検査し、インストールが正常に完了したことを確認します。

   $ oc get csv -n openshift-compliance

2. 次のコマンドを実行して、Compliance Operator が稼働していることを確認します。

   $ oc get deploy -n openshift-compliance

手順

1. Web コンソールの Administrator パースペクティブで、Operators Installed Operators に移動します。
2. 更新チャネルを変更する Operator の名前をクリックします。
3. Subscription タブをクリックします。
4. Update channel の下にある更新チャネルの名前をクリックします。
5. 変更する新しい更新チャネルをクリックし、Save をクリックします。

6. Automatic 承認ストラテジーのあるサブスクリプションの場合、更新は自動的に開始します。Operators Installed Operators ページに戻り、更新の進捗をモニターします。完了時に、ステータスは Succeeded および Up to date に変更されます。

   Manual 承認ストラテジーのあるサブスクリプションの場合、Subscription タブから更新を手動で承認できます。

手順

1. OpenShift Container Platform Web コンソールの Administrator パースペクティブで、Operators Installed Operators に移動します。
2. 更新が保留中の Operator は Upgrade available のステータスを表示します。更新する Operator の名前をクリックします。
3. Subscription タブをクリックします。承認が必要な更新は、Upgrade status の横に表示されます。たとえば、1 requires approval が表示される可能性があります。
4. 1 requires approval をクリックしてから、Preview Install Plan をクリックします。
5. 更新に利用可能なリソースとして一覧表示されているリソースを確認します。問題がなければ、Approve をクリックします。
6. Operators Installed Operators ページに戻り、更新の進捗をモニターします。完了時に、ステータスは Succeeded および Up to date に変更されます。

1. Operators Installed Operators Compliance Operator ページに移動します。

   1. All instances をクリックします。
   2. All namespaces で、 オプションメニューをクリックし、すべての ScanSettingBinding、ComplainceSuite、ComplianceScan、および ProfileBundle オブジェクトを削除します。
2. Administration Operators Installed Operators ページに切り替えます。
3. Compliance Operator エントリーのオプションメニュー をクリックして Uninstall Operator を選択します。
4. Home Projects ページに切り替えます。
5. 'compliance' を検索します。

6. openshift-compliance プロジェクトの横にある Options メニュー をクリックし、Delete Project を選択します。

   1. ダイアログボックスに openshift-compliance と入力して削除を確認し、Delete をクリックします。

手順

1. namespace のすべてのオブジェクトを削除します。

   1. ScanSettingBinding オブジェクトを削除します。

      $ oc delete ssb --all -n openshift-compliance

   2. ScanSetting オブジェクトを削除します。

      $ oc delete ss --all -n openshift-compliance

   3. ComplianceSuite オブジェクトを削除します。

      $ oc delete suite --all -n openshift-compliance

   4. ComplianceScan オブジェクトを削除します。

      $ oc delete scan --all -n openshift-compliance

   5. ProfileBundle オブジェクトを削除します。

      $ oc delete profilebundle.compliance --all -n openshift-compliance

2. Subscription オブジェクトを削除します。

   $ oc delete sub --all -n openshift-compliance

3. CSV オブジェクトを削除します。

   $ oc delete csv --all -n openshift-compliance

4. プロジェクトを削除します。

   $ oc delete project openshift-compliance

   出力例

   project.project.openshift.io "openshift-compliance" deleted

検証

1. namespace が削除されていることを確認します。

   $ oc get project/openshift-compliance

   出力例

   Error from server (NotFound): namespaces "openshift-compliance" not found