10.4. 移行計画のオプション

手順

1. MigrationController カスタムリソースマニフェストを編集します。

   $ oc edit migrationcontroller <migration_controller> -n openshift-migration

2. 特定のリソースを除外するパラメーターを追加して、spec セクションを更新します。独自の除外パラメーターを持たないリソースの場合は、additional_excluded_resources パラメーターを追加します。

   apiVersion: migration.openshift.io/v1alpha1
   kind: MigrationController
   metadata:
     name: migration-controller
     namespace: openshift-migration
   spec:
     disable_image_migration: true 1
     disable_pv_migration: true 2
     additional_excluded_resources: 3
     - resource1
     - resource2
     ...

   1

   disable_image_migration: true を追加して、移行からイメージストリームを除外します。MigrationController Pod が再起動すると、imagestreams が main.yml の excluded_resources リストに追加されます。

   2

   disable_pv_migration: true を追加して、移行計画から PV を除外します。MigrationController Pod が再起動すると、persistentvolumes と persistentvolumeclaims が main.yml の excluded_resources リストに追加されます。PV 移行を無効にすると、移行計画の作成時に PV 検出も無効にできます。

   3

   除外する OpenShift Container Platform リソースを additional_excluded_resources リストに追加できます。

3. MigrationController Pod が再起動し、変更が適用されるまで 2 分待機します。

4. リソースが除外されていることを確認します。

   $ oc get deployment -n openshift-migration migration-controller -o yaml | grep EXCLUDED_RESOURCES -A1

   出力には、除外されたリソースが含まれます。

   出力例

   name: EXCLUDED_RESOURCES
   value:
   resource1,resource2,imagetags,templateinstances,clusterserviceversions,packagemanifests,subscriptions,servicebrokers,servicebindings,serviceclasses,serviceinstances,serviceplans,imagestreams,persistentvolumes,persistentvolumeclaims

手順

1. OpenShift Container Platform Web コンソールの左側のナビゲーションペインで、Projects をクリックします。

2. プロジェクトリストで、プロジェクトをクリックします。

   Project details ページが開きます。

3. DeploymentConfig 名をクリックします。実行中の Pod の名前をメモします。
4. プロジェクトの YAML タブを開きます。PV を検索し、対応する 永続ボリュームクレーム (PVC) の名前をメモします。
5. MTC Web コンソールで、Migration plans をクリックします。
6. Add migration plan をクリックします。

7. Plan name を入力します。

   移行計画名には、3 - 63 の小文字の英数字 (a-z, 0-9) を使用できず、スペースやアンダースコア (_) を含めることはできません。

8. Migration type メニューから Storage class conversion を選択します。
9. Source cluster リストから、ストレージクラスの変換に必要なクラスターを選択します。

10. Next をクリックします。

    Namespaces ページが開きます。

11. 必要なプロジェクト選択します。

12. Next をクリックします。

    Persistent volumes ページが開きます。このページには、デフォルトで選択されている PV がすべて表示されます。

13. それぞれの PV について、必要なターゲットストレージクラスを選択します。

14. Next をクリックします。

    ウィザードは新しい移行プランを検証し、準備状態にあることを示します。

15. Close をクリックします。

    新しい計画が Migration plans ページに表示されます。

16. 変換を開始するには、新しい計画のオプションメニューをクリックします。

    Migrations の下に、Stage と Cutover の 2 つのオプションが表示されます。

    注記

    カットオーバー移行は、アプリケーションの PVC 参照を更新します。

    ステージ移行は、アプリケーションの PVC 参照を更新しません。

17. オプションを選択します。

    選択したオプションに応じて、Stage migration または Cutover migration の通知が表示されます。

18. Migrate をクリックします。

    選択したオプションに応じて、Stage started または Cutover started のメッセージが表示されます。

19. 現在の移行ステータスを表示するには、Migrations 列の数字をクリックします。

    Migrations ページが開きます。

20. 現在の移行の詳細を表示し、その進捗をモニタリングするには、Type 列から移行を選択します。

    Migration details ページが開きます。移行が DirectVolume の手順に進み、その手順のステータスが Running Rsync Pods to migrate Persistent Volume data になると、View details をクリックしてコピーの詳細なステータスを確認できます。

21. ブレッドクラムバーで Stage または Cutover をクリックし、すべての手順が完了するまで待ちます。

22. OpenShift Container Platform Web コンソールの PersistentVolumeClaims タブを開きます。

    新しい PVC は初期 PVC の名前で表示できますが、new で終わります。これは、ターゲットストレージクラスを使用しています。

23. 左側のナビゲーションペインで、Pods をクリックします。プロジェクトの Pod が再び実行されていることを確認します。

手順

1. MigPlan CR を更新して、Kubernetes リソースを含め、オプションで、labelSelector パラメーターを追加して含まれているリソースをフィルタリングします。

   1. MigPlan CR を更新して Kubernetes リソースを含めるには以下を実行します。

      apiVersion: migration.openshift.io/v1alpha1
      kind: MigPlan
      metadata:
        name: <migplan>
        namespace: openshift-migration
      spec:
        includedResources:
        - kind: <kind> 1
          group: ""
        - kind: <kind>
          group: ""

      1

      Kubernetes オブジェクトを指定します (例: Secret または ConfigMap)。

   2. オプション: labelSelector パラメーターを追加して、含まれているリソースをフィルター処理するには、次のようにします。

      apiVersion: migration.openshift.io/v1alpha1
      kind: MigPlan
      metadata:
        name: <migplan>
        namespace: openshift-migration
      spec:
        includedResources:
        - kind: <kind> 1
          group: ""
        - kind: <kind>
          group: ""
      ...
        labelSelector:
          matchLabels:
            <label> 2

      1

      Kubernetes オブジェクトを指定します (例: Secret または ConfigMap)。

      2

      移行するリソースのラベルを指定します (例: app: frontend)。

2. MigMigration CR を作成して、選択した Kubernetes リソースを移行します。正しい MigPlan が migPlanRef で参照されていることを確認します。

   apiVersion: migration.openshift.io/v1alpha1
   kind: MigMigration
   metadata:
     generateName: <migplan>
     namespace: openshift-migration
   spec:
     migPlanRef:
       name: <migplan>
       namespace: openshift-migration
     stage: false