1.7.4. 非推奨の API の更新

手順

1. 移行計画を実行します。

2. MigPlan カスタムリソース (CR) を表示します:

   $ oc describe migplan <migplan_name> -n openshift-migration 

   1

   1

   MigPlan CR の名前を指定します。

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

   metadata:
     ...
     uid: 79509e05-61d6-11e9-bc55-02ce4781844a 

   1

   
   status:
     ...
     conditions:
     - category: Warn
       lastTransitionTime: 2020-04-30T17:16:23Z
       message: 'Some namespaces contain GVKs incompatible with destination cluster.
         See: `incompatibleNamespaces` for details'
       status: "True"
       type: GVKsIncompatible
     incompatibleNamespaces:
     - gvks: 

   2

   
       - group: batch
         kind: cronjobs
         version: v2alpha1
       - group: batch
         kind: scheduledjobs
         version: v2alpha1

   1

   MigPlan CR UID を記録します。

   2

   gvks セクションに一覧表示された非推奨の API を記録します。

3. MigPlan UID に関連付けられた MigMigration 名を取得します。

   $ oc get migmigration -o json | jq -r '.items[] | select(.metadata.ownerReferences[].uid=="<migplan_uid>") | .metadata.name' 

   1

   1

   MigPlan CR UID を指定します。

4. MigMigration 名に関連付けられた MigMigration UID を取得します。

   $ oc get migmigration <migmigration_name> -o jsonpath='{.metadata.uid}' 

   1

   1

   MigMigration 名を指定します。

5. MigMigration UID に関連付けられた Velero バックアップ名を取得します。

   $ oc get backup.velero.io --selector migration-initial-backup="<migmigration_uid>" -o jsonpath={.items[*].metadata.name} 

   1

   1

   MigMigration UID を指定します。

6. ストレージプロバイダーのコマンドを実行して、Velero バックアップの内容をローカルマシンにダウンロードします。

   • AWS S3:

     $ aws s3 cp s3://<bucket_name>/velero/backups/<backup_name> <backup_local_dir> --recursive 

     1

     1

     バケット、バックアップ名、およびローカルバックアップのディレクトリー名を指定します。

   • GCP

     $ gsutil cp gs://<bucket_name>/velero/backups/<backup_name> <backup_local_dir> --recursive 

     1

     1

     バケット、バックアップ名、およびローカルバックアップのディレクトリー名を指定します。

   • Azure:

     $ azcopy copy 'https://velerobackups.blob.core.windows.net/velero/backups/<backup_name>' '<backup_local_dir>' --recursive 

     1

     1

     バックアップ名とローカルバックアップのディレクトリー名を指定します。

7. Velero バックアップアーカイブファイルを展開します。

   $ tar -xfv <backup_local_dir>/<backup_name>.tar.gz -C <backup_local_dir>

8. 非推奨のそれぞれの API でオフラインモードで oc convert を実行します。

   $ oc convert -f <backup_local_dir>/resources/<gvk>.json

9. ターゲットクラスターで変換された API を作成します。

   $ oc create -f <gvk>.json