1.4. クラスターアプリケーション移行ツールのデプロイ

手順

1. OpenShift Container Platform Web コンソールで、Operators OperatorHub をクリックします。
2. Filter by keyword フィールド (この場合は Migration) を使用して Cluster Application Migration Operator を見つけます。
3. Cluster Application Migration Operator を選択し、Install をクリックします。
4. Create Operator Subscription ページで openshift-migration namespace を選択し、承認ストラテジーを指定します。

5. Subscribe をクリックします。

   Installed Operators ページで、Cluster Application Migration Operator は、InstallSucceeded のステータスで openshift-migration プロジェクトに表示されます。

6. Provided APIs の下で、View 12 more…​ をクリックします。
7. Create New MigrationController をクリックします。
8. Create をクリックします。
9. Workloads Pods をクリックし、Controller Manager、Migration UI、Restic、および Velero Pod が実行中であることを確認します。

手順

1. Red Hat カスタマーポータルの認証情報を使用して registry.redhat.io にログインします。

   $ sudo podman login registry.redhat.io

   Copy to Clipboard
   注記

   システムがルートレス Podman コンテナー用に設定されている場合は、この手順に sudo は必要ありません。

2. operator.yml ファイルをダウンロードします。

   $ sudo podman cp $(sudo podman create registry.redhat.io/rhcam-1-2/openshift-migration-rhel7-operator:v1.2):/operator.yml ./

   Copy to Clipboard

3. controller-3.yml ファイルをダウンロードします。

   $ sudo podman cp $(sudo podman create registry.redhat.io/rhcam-1-2/openshift-migration-rhel7-operator:v1.2):/controller-3.yml ./

   Copy to Clipboard
4. OpenShift Container Platform 3 クラスターにログインします。

5. クラスターが registry.redhat.io で認証できることを確認します。

   $ oc run test --image registry.redhat.io/ubi8 --command sleep infinity

   Copy to Clipboard

6. Cluster Application Migration Operator CR オブジェクトを作成します。

   $ oc create -f operator.yml

   Copy to Clipboard

   出力は以下のようになります。

   namespace/openshift-migration created
   rolebinding.rbac.authorization.k8s.io/system:deployers created
   serviceaccount/migration-operator created
   customresourcedefinition.apiextensions.k8s.io/migrationcontrollers.migration.openshift.io created
   role.rbac.authorization.k8s.io/migration-operator created
   rolebinding.rbac.authorization.k8s.io/migration-operator created
   clusterrolebinding.rbac.authorization.k8s.io/migration-operator created
   deployment.apps/migration-operator created
   Error from server (AlreadyExists): error when creating "./operator.yml":
   rolebindings.rbac.authorization.k8s.io "system:image-builders" already exists 

   1

   
   Error from server (AlreadyExists): error when creating "./operator.yml":
   rolebindings.rbac.authorization.k8s.io "system:image-pullers" already exists

   Copy to Clipboard

   1

   Error from server (AlreadyExists) メッセージは無視できます。これらは、Cluster Applicatino Migration Operator が以降のリリースで提供されるリリースを OpenShift Container Platform 3 の以前のバージョン用に作成することによって生じます。

7. Migration コントローラー CR オブジェクトを作成します。

   $ oc create -f controller-3.yml

   Copy to Clipboard

8. Velero および Restic Pod が実行されていることを確認します。

   $ oc get pods -n openshift-migration

   Copy to Clipboard

手順

1. ネットワークアクセスが無制限のワークステーションで、ターゲットミラーレジストリーを使用して認証を行います。

   $ podman login <registry_host_name>

   Copy to Clipboard

   また、ビルド時にベースイメージをプルできるように、registry.redhat.io で認証します。

   $ podman login registry.redhat.io

   Copy to Clipboard

2. quay.ioから redhat-operators カタログをベースにカタログイメージをビルドし、そのイメージにタグを付け、ミラーレジストリーにプッシュします。

   $ oc adm catalog build \
       --appregistry-org redhat-operators \

   1

   
       --from=registry.redhat.io/openshift4/ose-operator-registry:v4.3 \

   2

   
       --filter-by-os="linux/amd64" \

   3

   
       --to=<registry_host_name>:<port>/olm/redhat-operators:v1 \

   4

   
       [-a ${REG_CREDS}] \

   5

   
       [--insecure] \

   6

   
       [--auth-token "${AUTH_TOKEN}"] 

   7

   
   
   INFO[0013] loading Bundles                               dir=/var/folders/st/9cskxqs53ll3wdn434vw4cd80000gn/T/300666084/manifests-829192605
   ...
   Pushed sha256:f73d42950021f9240389f99ddc5b0c7f1b533c054ba344654ff1edaf6bf827e3 to example_registry:5000/olm/redhat-operators:v1

   Copy to Clipboard

   1

   App Registry インスタンスからのプルに使用する組織 (namespace)。

   2

   ターゲット OpenShift Container Platform クラスターのメジャーバージョンおよびマイナーバージョンに一致するタグを使用して、--from を ose-operator-registry ベースイメージに設定します。

   3

   --filter-by-os を、ターゲットの OpenShift Container Platform クラスターと一致する必要のある、ベースイメージに使用するオペレーティングシステムおよびアーキテクチャーに設定します。使用できる値は、linux/amd64、linux/ppc64le、および linux/s390x です。

   4

   カタログイメージに名前を付け、v1 などのタグを追加します。

   5

   オプション: 必要な場合は、レジストリー認証情報ファイルの場所を指定します。

   6

   オプション: ターゲットレジストリーの信頼を設定しない場合は、--insecure フラグを追加します。

   7

   オプション: 公開されていない他のアプリケーションレジストリーカタログが使用されている場合、Quay 認証トークンを指定します。

   無効なマニフェストが Red Hat のカタログに誤って導入される可能性があります。これが実際に生じる場合には、以下のようなエラーが表示される可能性があります。

   ...
   INFO[0014] directory                                     dir=/var/folders/st/9cskxqs53ll3wdn434vw4cd80000gn/T/300666084/manifests-829192605 file=4.2 load=package
   W1114 19:42:37.876180   34665 builder.go:141] error building database: error loading package into db: fuse-camel-k-operator.v7.5.0 specifies replacement that couldn't be found
   Uploading ... 244.9kB/s

   Copy to Clipboard

   通常、これらのエラーは致命的なエラーではなく、該当する Operator パッケージにインストールする予定の Operator やその依存関係が含まれない場合、それらを無視することができます。

手順

1. disableAllDefaultSources: true を仕様に追加してデフォルトの OperatorSource を無効にします。

   $ oc patch OperatorHub cluster --type json \
       -p '[{"op": "add", "path": "/spec/disableAllDefaultSources", "value": true}]'

   Copy to Clipboard

   これにより、OpenShift Container Platform のインストール時にデフォルトで設定されるデフォルトの OperatorSource が無効になります。

2. oc adm catalog mirror コマンドは、カスタム Operator カタログイメージのコンテンツを抽出し、ミラーリングに必要なマニフェストを生成します。以下のいずれかを選択できます。

   • コマンドのデフォルト動作で、マニフェストの生成後にすべてのイメージコンテンツをミラーレジストリーに自動的にミラーリングできるようにします。または、
   • --manifests-only フラグを追加して、ミラーリングに必要なマニフェストのみを生成しますが、これにより、イメージコンテンツがレジストリーに自動的にミラーリングされる訳ではありません。これは、ミラーリングする内容を確認するのに役立ちます。また、コンテンツのサブセットのみが必要な場合に、マッピングの一覧に変更を加えることができます。次に、そのファイルを oc image mirror コマンドで使用し、後のステップでイメージの変更済みの一覧をミラーリングできます。

   ネットワークアクセスが無制限のワークステーションで、以下のコマンドを実行します。

   $ oc adm catalog mirror \
       <registry_host_name>:<port>/olm/redhat-operators:v1 \

   1

   
       <registry_host_name>:<port> \
       [-a ${REG_CREDS}] \

   2

   
       [--insecure] \

   3

   
       [--filter-by-os="<os>/<arch>"] \

   4

   
       [--manifests-only] 

   5

   Copy to Clipboard

   1

   Operator カタログイメージを指定します。

   2

   オプション: 必要な場合は、レジストリー認証情報ファイルの場所を指定します。

   3

   オプション: ターゲットレジストリーの信頼を設定しない場合は、--insecure フラグを追加します。

   4

   オプション: カタログは複数のアーキテクチャーおよびオペレーティングシステムをサポートするイメージを参照する可能性があるため、アーキテクチャーおよびオペレーティングシステムでフィルターして、一 致するイメージのみをミラーリングするようにできます。使用できる値は、linux/amd64、linux/ppc64le、および linux/s390x です。

   5

   オプション: ミラーリングに必要なマニフェストのみを生成し、実際にはイメージコンテンツをレジストリーにミラーリングしません。

   出力例

   using database path mapping: /:/tmp/190214037
   wrote database to /tmp/190214037
   using database at: /tmp/190214037/bundles.db 

   1

   
   ...

   Copy to Clipboard

   1

   コマンドで生成される一時的なデータベース。

   コマンドの実行後に、<image_name>-manifests/ ディレクトリーが現在のディレクトリーに作成され、以下のファイルが生成されます。

   • これにより、imageContentSourcePolicy.yaml ファイルは ImageContentSourcePolicy オブジェクトを定義します。このオブジェクトは、このオブジェクトは、ノードを Operator マニフェストおよびミラーリングされたレジストリーに保存されるイメージ参照間で変換できるように設定します。
   • mapping.txt ファイルには、すべてのソースイメージが含まれ、これはそれらのイメージをターゲットレジストリー内のどこにマップするかを示します。このファイルは oc image mirror コマンドと互換性があり、ミラーリング設定をさらにカスタマイズするために使用できます。

3. 直前の手順で --manifests-only フラグを使用して、コンテンツのサブセットのみをミラーリングする場合は、以下を実行します。

   1. mapping.txt ファイルのイメージの一覧を仕様に変更します。ミラーリングするイメージのサブセットの名前とバージョンが不明な場合は、以下の手順で確認します。

      1. oc adm catalog mirror コマンドで生成された一時的なデータベースに対して sqlite3 ツールを実行し、一般的な検索クエリーに一致するイメージの一覧を取得します。出力は、後に mapping.txt ファイルを編集する方法を通知するのに役立ちます。

         たとえば、clusterlogging.4.3 の文字列のようなイメージの一覧を取得するには、以下を実行します。

         $ echo "select * from related_image \
             where operatorbundle_name like 'clusterlogging.4.3%';" \
             | sqlite3 -line /tmp/190214037/bundles.db 

         1

         Copy to Clipboard

         1

         oc adm catalog mirror コマンドの直前の出力を参照し、データベースファイルのパスを見つけます。

         出力例

         image = registry.redhat.io/openshift4/ose-logging-kibana5@sha256:aa4a8b2a00836d0e28aa6497ad90a3c116f135f382d8211e3c55f34fb36dfe61
         operatorbundle_name = clusterlogging.4.3.33-202008111029.p0
         
         image = registry.redhat.io/openshift4/ose-oauth-proxy@sha256:6b4db07f6e6c962fc96473d86c44532c93b146bbefe311d0c348117bf759c506
         operatorbundle_name = clusterlogging.4.3.33-202008111029.p0
         ...

         Copy to Clipboard

      2. 直前の手順で取得した結果を使用して mapping.txt ファイルを編集し、ミラーリングする必要のあるイメージのサブセットのみを追加します。

         たとえば、前述の出力例の image 値を使用して、mapping.txt ファイルに以下の一致する行が存在することを確認できます。

         mapping.txt の一致するイメージマッピング。

         registry.redhat.io/openshift4/ose-logging-kibana5@sha256:aa4a8b2a00836d0e28aa6497ad90a3c116f135f382d8211e3c55f34fb36dfe61=<registry_host_name>:<port>/openshift4-ose-logging-kibana5:a767c8f0
         registry.redhat.io/openshift4/ose-oauth-proxy@sha256:6b4db07f6e6c962fc96473d86c44532c93b146bbefe311d0c348117bf759c506=<registry_host_name>:<port>/openshift4-ose-oauth-proxy:3754ea2b

         Copy to Clipboard

         この例では、これらのイメージのみをミラーリングする場合に、mapping.txt ファイルの他のすべてのエントリーを削除し、上記の 2 行のみを残します。

   2. ネットワークアクセスが無制限のワークステーション上で、変更した mapping.txt ファイルを使用し、 oc image mirror コマンドを使用してイメージをレジストリーにミラーリングします。

      $ oc image mirror \
          [-a ${REG_CREDS}] \
          -f ./redhat-operators-manifests/mapping.txt

      Copy to Clipboard

4. ImageContentSourcePolicy を適用します。

   $ oc apply -f ./redhat-operators-manifests/imageContentSourcePolicy.yaml

   Copy to Clipboard

5. カタログイメージを参照する CatalogSource オブジェクトを作成します。

   1. 仕様を以下のように変更し、これを catalogsource.yaml ファイルとして保存します。

      apiVersion: operators.coreos.com/v1alpha1
      kind: CatalogSource
      metadata:
        name: my-operator-catalog
        namespace: openshift-marketplace
      spec:
        sourceType: grpc
        image: <registry_host_name>:<port>/olm/redhat-operators:v1 

      1

      
        displayName: My Operator Catalog
        publisher: grpc

      Copy to Clipboard

      1

      Operator カタログイメージを指定します。

   2. このファイルを使用して CatalogSource オブジェクトを作成します。

      $ oc create -f catalogsource.yaml

      Copy to Clipboard

6. 以下のリソースが正常に作成されていることを確認します。

   1. Pod を確認します。

      $ oc get pods -n openshift-marketplace

      Copy to Clipboard

      出力例

      NAME                                    READY   STATUS    RESTARTS  AGE
      my-operator-catalog-6njx6               1/1     Running   0         28s
      marketplace-operator-d9f549946-96sgr    1/1     Running   0         26h

      Copy to Clipboard

   2. CatalogSource を確認します。

      $ oc get catalogsource -n openshift-marketplace

      Copy to Clipboard

      出力例

      NAME                  DISPLAY               TYPE PUBLISHER  AGE
      my-operator-catalog   My Operator Catalog   grpc            5s

      Copy to Clipboard

   3. PackageManifest を確認します。

      $ oc get packagemanifest -n openshift-marketplace

      Copy to Clipboard

      出力例

      NAME    CATALOG              AGE
      etcd    My Operator Catalog  34s

      Copy to Clipboard

手順

1. OpenShift Container Platform Web コンソールで、Operators OperatorHub をクリックします。
2. Filter by keyword フィールド (この場合は Migration) を使用して Cluster Application Migration Operator を見つけます。
3. Cluster Application Migration Operator を選択し、Install をクリックします。
4. Create Operator Subscription ページで openshift-migration namespace を選択し、承認ストラテジーを指定します。

5. Subscribe をクリックします。

   Installed Operators ページで、Cluster Application Migration Operator は、InstallSucceeded のステータスで openshift-migration プロジェクトに表示されます。

6. Provided APIs の下で、View 12 more…​ をクリックします。
7. Create New MigrationController をクリックします。
8. Create をクリックします。
9. Workloads Pods をクリックし、Controller Manager、Migration UI、Restic、および Velero Pod が実行中であることを確認します。

手順

1. ネットワークアクセスが無制限のワークステーションで、Red Hat カスタマーポータルの認証情報を使用して registry.redhat.io にログインします。

   $ sudo podman login registry.redhat.io

   Copy to Clipboard
   注記

   システムがルートレス Podman コンテナー用に設定されている場合は、この手順に sudo は必要ありません。

2. operator.yml ファイルをダウンロードします。

   $ sudo podman cp $(sudo podman create registry.redhat.io/rhcam-1-2/openshift-migration-rhel7-operator:v1.2):/operator.yml ./

   Copy to Clipboard

3. controller-3.yml ファイルをダウンロードします。

   $ sudo podman cp $(sudo podman create registry.redhat.io/rhcam-1-2/openshift-migration-rhel7-operator:v1.2):/controller-3.yml ./

   Copy to Clipboard

4. OpenShift Container Platform 4 クラスターで oc adm catalog mirror の実行時に作成された mapping.txt ファイルから Operator イメージの値を取得します。

   $ grep openshift-migration-rhel7-operator ./mapping.txt | grep rhcam-1-2

   Copy to Clipboard

   出力には、registry.redhat.io イメージとミラーレジストリーイメージ間のマッピングが表示されます。

   registry.redhat.io/rhcam-1-2/openshift-migration-rhel7-operator@sha256:468a6126f73b1ee12085ca53a312d1f96ef5a2ca03442bcb63724af5e2614e8a=<registry.apps.example.com>/rhcam-1-2/openshift-migration-rhel7-operator

   Copy to Clipboard

5. operator.yml ファイルの image および REGISTRY の値を更新します。

   containers:
     - name: ansible
       image: <registry.apps.example.com>/rhcam-1-2/openshift-migration-rhel7-operator@sha256:<468a6126f73b1ee12085ca53a312d1f96ef5a2ca03442bcb63724af5e2614e8a> 

   1

   
   ...
     - name: operator
       image: <registry.apps.example.com>/rhcam-1-2/openshift-migration-rhel7-operator@sha256:<468a6126f73b1ee12085ca53a312d1f96ef5a2ca03442bcb63724af5e2614e8a> 

   2

   
   ...
       env:
       - name: REGISTRY
         value: <registry.apps.example.com> 

   3

   Copy to Clipboard

   1 2

   ミラーレジストリー、および mapping.txt ファイルで Operator イメージの sha256 の値を指定します。

   3

   ミラーレジストリーを指定します。

6. OpenShift Container Platform 3 クラスターにログインします。

7. Cluster Application Migration Operator CR オブジェクトを作成します。

   $ oc create -f operator.yml

   Copy to Clipboard

   出力は以下のようになります。

   namespace/openshift-migration created
   rolebinding.rbac.authorization.k8s.io/system:deployers created
   serviceaccount/migration-operator created
   customresourcedefinition.apiextensions.k8s.io/migrationcontrollers.migration.openshift.io created
   role.rbac.authorization.k8s.io/migration-operator created
   rolebinding.rbac.authorization.k8s.io/migration-operator created
   clusterrolebinding.rbac.authorization.k8s.io/migration-operator created
   deployment.apps/migration-operator created
   Error from server (AlreadyExists): error when creating "./operator.yml":
   rolebindings.rbac.authorization.k8s.io "system:image-builders" already exists 

   1

   
   Error from server (AlreadyExists): error when creating "./operator.yml":
   rolebindings.rbac.authorization.k8s.io "system:image-pullers" already exists

   Copy to Clipboard

   1

   Error from server (AlreadyExists) メッセージは無視できます。これらは、Cluster Applicatino Migration Operator が以降のリリースで提供されるリリースを OpenShift Container Platform 3 の以前のバージョン用に作成することによって生じます。

8. Migration コントローラー CR オブジェクトを作成します。

   $ oc create -f controller-3.yml

   Copy to Clipboard

9. Velero および Restic Pod が実行されていることを確認します。

   $ oc get pods -n openshift-migration

   Copy to Clipboard