9.3. OpenShift Update Service を使用した非接続環境でのクラスターの更新

手順

1. Web コンソールで Operators OperatorHub をクリックします。

   注記

   Update Service と Filter by keyword…​ フィールドに入力し、素早く Operator を見つけます。

2. 利用可能な Operator の一覧から OpenShift Update Service を選択し、Install をクリックします。

   1. 本リリースで利用可能な唯一のチャネルであるため、チャネル v1 が Update Channel として選択されます。
   2. A specific namespace on the cluster が Installation Mode で選択します。
   3. Installed Namespace の namespace を選択するか、推奨される namespace openshift-update-service を受け入れます。

   4. Approval Strategy を選択します。

      • Automatic ストラテジーにより、Operator Lifecycle Manager (OLM) は新規バージョンが利用可能になると Operator を自動的に更新できます。
      • Manual ストラテジーには、クラスター管理者が Operator の更新を承認する必要があります。
   5. Install をクリックします。
3. Operators Installed Operators ページに切り替えて、OpenShift Update Service Operator がインストールされていることを確認します。
4. Status が Succeeded の OpenShift Update Service が選択された namespace に一覧表示されていることを確認します。

手順

1. OpenShift Update Service Operator の namespace を作成します。

   1. OpenShift Update Service Operator の namespace オブジェクト YAML ファイル (update-service-namespace.yaml など) を作成します。

      apiVersion: v1
      kind: Namespace
      metadata:
        name: openshift-update-service
        annotations:
          openshift.io/node-selector: ""
        labels:
          openshift.io/cluster-monitoring: "true" 1

      1

      openshift.io/cluster-monitoring ラベルを設定して、k この namespace で Operator が推奨するクラスターのモニターリングを有効にします。

   2. namespace を作成します。

      $ oc create -f <filename>.yaml

      以下に例を示します。

      $ oc create -f update-service-namespace.yaml

2. 以下のオブジェクトを作成して OpenShift Update Service Operator をインストールします。

   1. OperatorGroup オブジェクト YAML ファイルを作成します (例: update-service-operator-group.yaml)。

      apiVersion: operators.coreos.com/v1
      kind: OperatorGroup
      metadata:
        name: update-service-operator-group
      spec:
        targetNamespaces:
        - openshift-update-service

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

      $ oc -n openshift-update-service create -f <filename>.yaml

      以下に例を示します。

      $ oc -n openshift-update-service create -f update-service-operator-group.yaml

   3. Subscription オブジェクト YAML ファイルを作成します (例: update-service-subscription.yaml)。

      Subscription の例

      apiVersion: operators.coreos.com/v1alpha1
      kind: Subscription
      metadata:
        name: update-service-subscription
      spec:
        channel: v1
        installPlanApproval: "Automatic"
        source: "redhat-operators" 1
        sourceNamespace: "openshift-marketplace"
        name: "cincinnati-operator"

      1

      Operator を提供するカタログソースの名前を指定します。カスタム Operator Lifecycle Manager (OLM) を使用しないクラスターの場合には、redhat-operators を指定します。OpenShift Container Platform クラスターが切断された環境にインストールされている場合、Operator Lifecycle Manager (OLM) を設定したときに作成された CatalogSource オブジェクトの名前を指定します。

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

      $ oc create -f <filename>.yaml

      以下に例を示します。

      $ oc -n openshift-update-service create -f update-service-subscription.yaml

      OpenShift Update Service Operator は openshift-update-service namespace にインストールされ、openshift-update-service namespace をターゲットにします。

3. Operator のインストールを確認します。

   $ oc -n openshift-update-service get clusterserviceversions

   出力例

   NAME                             DISPLAY                    VERSION   REPLACES   PHASE
   update-service-operator.v4.6.0   OpenShift Update Service   4.6.0                Succeeded
   ...

   OpenShift Update Service Operator が記載されている場合には、インストールが成功しています。バージョン番号が表示されるものと異なる場合があります。

手順

1. Web コンソールで Operators Installed Operators をクリックします。
2. インストールされた Operator の一覧から OpenShift Update Service を選択します。
3. Update Service タブをクリックします。
4. Create UpdateService をクリックします。
5. service など、Name フィールドに名前を入力します。
6. Graph Data Image フィールドに OpenShift Update Service グラフデータコンテナーイメージの作成で作成した graph-data コンテナーイメージにローカルの pullspec を入力します (例: registry.example.com/openshift/graph-data:latest)。
7. Releases フィールドに、OpenShift Container Platform イメージリポジトリーのミラーリングでリリースイメージを含むように作成したローカルのレジストリーとリポジトリー (例: registry.example.com/ocp4/openshift4-release-images) を入力します。
8. Replicas フィールドに 2 と入力します。
9. Create をクリックして OpenShift Update Service アプリケーションを作成します。

10. OpenShift Update Service アプリケーションを検証します。

    • Update Service タブの UpdateServices 一覧から、作成した Update Service アプリケーションをクリックします。
    • Resources タブをクリックします。
    • 各アプリケーションリソースのステータスが Created であることを確認します。

手順

1. OpenShift Update Service ターゲット namespace を設定します (例: openshift-update-service)。

   $ NAMESPACE=openshift-update-service

   namespace は Operator グループの targetNamespaces 値と一致する必要があります。

2. OpenShift Update Service アプリケーションの名前 (例: service) を設定します。

   $ NAME=service

3. OpenShift Container Platform イメージリポジトリーの設ミラーリング (例: registry.example.com/ocp4/openshift4-release-images) に設定されるように、リリースイメージのローカルレジストリーおよびリポジトリーを設定します。

   $ RELEASE_IMAGES=registry.example.com/ocp4/openshift4-release-images

4. OpenShift Update Service グラフデータコンテナーイメージの作成で作成した graph-data コンテナーイメージにローカルの pullspec を入力します (例: registry.example.com/openshift/graph-data:latest)。

   $ GRAPH_DATA_IMAGE=registry.example.com/openshift/graph-data:latest

5. OpenShift Update Service アプリケーションオブジェクトを作成します。

   $ oc -n "${NAMESPACE}" create -f - <<EOF
   apiVersion: updateservice.operator.openshift.io/v1
   kind: UpdateService
   metadata:
     name: ${NAME}
   spec:
     replicas: 2
     releases: ${RELEASE_IMAGES}
     graphDataImage: ${GRAPH_DATA_IMAGE}
   EOF

6. OpenShift Update Service アプリケーションを検証します。

   1. 以下のコマンドを使用してポリシーエンジンルートを取得します。

      $ while sleep 1; do POLICY_ENGINE_GRAPH_URI="$(oc -n "${NAMESPACE}" get -o jsonpath='{.status.policyEngineURI}/api/upgrades_info/v1/graph{"\n"}' updateservice "${NAME}")"; SCHEME="${POLICY_ENGINE_GRAPH_URI%%:*}"; if test "${SCHEME}" = http -o "${SCHEME}" = https; then break; fi; done

      コマンドが成功するまでポーリングが必要になる場合があります。

   2. ポリシーエンジンからグラフを取得します。チャネル に有効なバージョンを指定してください。たとえば、OpenShift Container Platform 4.8 で実行している場合は、stable-4.8 を使用します。

      $ while sleep 10; do HTTP_CODE="$(curl --header Accept:application/json --output /dev/stderr --write-out "%{http_code}" "${POLICY_ENGINE_GRAPH_URI}?channel=stable-4.6")"; if test "${HTTP_CODE}" -eq 200; then break; fi; echo "${HTTP_CODE}"; done

      これにより、グラフ要求が成功するまでポーリングされます。ただし、ミラーリングしたリリースイメージによっては、生成されるグラフが空白の場合があります。

手順

1. Web コンソールで Operators Installed Operators をクリックします。
2. インストールされた Operator の一覧から OpenShift Update Service を選択します。
3. Update Service タブをクリックします。
4. インストールされた OpenShift Update Service アプリケーションの一覧から、削除するアプリケーションを選択して、Delete UpdateService をクリックします。
5. Delete UpdateService? 確認ダイアログで、Delete をクリックし、削除を確定します。

手順

1. OpenShift Update Service アプリケーションを作成した namespace を使用して OpenShift Update Service アプリケーション名を取得します (例: openshift-update-service)。

   $ oc get updateservice -n openshift-update-service

   出力例

   NAME      AGE
   service   6s

2. 直前の手順の NAME の値を使用して OpenShift Update Service アプリケーションと、OpenShift Update Service アプリケーションを作成した namespace (例: openshift-update-service) を削除します。

   $ oc delete updateservice service -n openshift-update-service

   出力例

   updateservice.updateservice.operator.openshift.io "service" deleted

手順

1. Web コンソールで Operators Installed Operators をクリックします。
2. インストールされた Operator の一覧から OpenShift Update Service を選択し、Uninstall Operator をクリックします。
3. Uninstall Operator? 確認ダイアログから Uninstall をクリックし、アンインストールを確定します。

手順

1. OpenShift Update Service Operator (例: openshift-update-service) が含まれるプロジェクトに切り替えます。

   $ oc project openshift-update-service

   出力例

   Now using project "openshift-update-service" on server "https://example.com:6443".

2. OpenShift Update Service Operator Operator グループの名前を取得します。

   $ oc get operatorgroup

   出力例

   NAME                             AGE
   openshift-update-service-fprx2   4m41s

3. Operator グループを削除します (例: openshift-update-service-fprx2)。

   $ oc delete operatorgroup openshift-update-service-fprx2

   出力例

   operatorgroup.operators.coreos.com "openshift-update-service-fprx2" deleted

4. OpenShift Update Service Operator サブスクリプションの名前を取得します。

   $ oc get subscription

   出力例

   NAME                      PACKAGE                   SOURCE                        CHANNEL
   update-service-operator   update-service-operator   updateservice-index-catalog   v1

5. 直前の手順で Name の値を使用して、currentCSV フィールドで、サブスクライブされた OpenShift Update Service Operator の現行バージョンを確認します。

   $ oc get subscription update-service-operator -o yaml | grep " currentCSV"

   出力例

     currentCSV: update-service-operator.v0.0.1

6. サブスクリプション (例: update-service-operator) を削除します。

   $ oc delete subscription update-service-operator

   出力例

   subscription.operators.coreos.com "update-service-operator" deleted

7. 直前の手順の currentCSV 値を使用し、OpenShift Update Service Operator の CSV を削除します。

   $ oc delete clusterserviceversion update-service-operator.v0.0.1

   出力例

   clusterserviceversion.operators.coreos.com "update-service-operator.v0.0.1" deleted