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

   마이그레이션 계획에서 PV를 제외하려면 disable_pv_migration: true를 추가합니다. MigrationController Pod가 다시 시작되면 persistentvolumes 및 persistentvolumeclaims 가 main.yml 의 excluded_resources 목록에 추가됩니다. PV 마이그레이션을 비활성화하면 마이그레이션 계획을 생성할 때 PV 검색도 비활성화됩니다.

   3

   additional_excluded_resources 목록에 제외하려는 OpenShift Container Platform 리소스를 추가할 수 있습니다.

3. 변경 사항이 적용되도록 MigrationController 포드가 다시 시작될 때까지 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 웹 콘솔의 왼쪽 탐색 창에서 프로젝트를 클릭합니다.

2. 프로젝트 목록에서 프로젝트를 클릭합니다.

   프로젝트 세부 정보 페이지가 열립니다.

3. DeploymentConfig 이름을 클릭합니다. 실행 중인 pod의 이름을 기록해 둡니다.
4. 프로젝트의 YAML 탭을 엽니다. PV를 찾고 해당 PVC(영구 볼륨 클레임)의 이름을 기록해 둡니다.
5. MTC 웹 콘솔에서 마이그레이션 계획을 클릭합니다.
6. 마이그레이션 계획 추가를 클릭합니다.

7. 계획 이름을 입력합니다.

   마이그레이션 계획 이름에는 3~63자의 소문자 영숫자(a-z, 0-90-9)가 포함되어야 하며 공백이나 밑줄(_)을 포함해서는 안 됩니다.

8. 마이그레이션 유형 메뉴에서 스토리지 클래스 변환을 선택합니다.
9. 소스 클러스터 목록에서 스토리지 클래스 변환을 위해 원하는 클러스터를 선택합니다.

10. 다음을 클릭합니다.

    네임스페이스 페이지가 열립니다.

11. 필요한 프로젝트를 선택합니다.

12. 다음을 클릭합니다.

    영구 볼륨 페이지가 열립니다. 페이지에 기본적으로 선택한 모든 PV가 프로젝트에 표시됩니다.

13. 각 PV에 대해 원하는 대상 스토리지 클래스를 선택합니다.

14. 다음을 클릭합니다.

    마법사는 새 마이그레이션 계획을 검증하고 준비 상태임을 표시합니다.

15. 닫기를 클릭합니다.

    새 계획이 마이그레이션 계획 페이지에 나타납니다.

16. 변환을 시작하려면 새 계획의 옵션 메뉴를 클릭합니다.

    마이그레이션에서 단계 및 컷오버 의 두 가지 옵션이 표시됩니다.

    참고

    축소 마이그레이션은 애플리케이션의 PVC 참조를 업데이트합니다.

    단계 마이그레이션은 애플리케이션의 PVC 참조를 업데이트하지 않습니다.

17. 원하는 옵션을 선택합니다.

    선택한 옵션에 따라 마이그레이션 단계 또는 컷오버 마이그레이션 알림이 표시됩니다.

18. 마이그레이션을 클릭합니다.

    선택한 옵션에 따라 시작 단계 또는 컷오버 시작 메시지가 표시됩니다.

19. 현재 마이그레이션의 상태를 보려면 마이그레이션 열에서 번호를 클릭합니다.

    마이그레이션 페이지가 열립니다.

20. 현재 마이그레이션에 대한 자세한 내용과 진행 상황을 모니터링하려면 유형 열에서 마이그레이션을 선택합니다.

    마이그레이션 세부 정보 페이지가 열립니다. 마이그레이션이 DirectVolume 단계로 진행되고 단계 상태가Running Rsync Pods to migrate Persistent Volume data로 되는 경우 세부 정보 보기를 클릭하고 복사본의 자세한 상태를 확인할 수 있습니다.

21. 이동 경로 표시줄에서 단계 또는 컷오버 를 클릭하고 모든 단계가 완료될 때까지 기다립니다.

22. OpenShift Container Platform 웹 콘솔의 영구 볼륨 클레임 탭을 엽니다.

    초기 PVC의 이름으로 새 PVC를 볼 수 있지만 대상 스토리지 클래스를 사용하는 PVC는 new PVC로 끝납니다.

23. 왼쪽 탐색 창에서 Pod 를 클릭합니다. 프로젝트의 Pod가 다시 실행 중인지 확인합니다.

프로세스

1. Kubernetes 리소스를 포함하도록 MigPlan CR을 업데이트하고, 선택적으로 labelSelector 매개변수를 추가하여 포함된 리소스를 필터링합니다.

   1. Kubernetes 리소스를 포함하도록 MigPlan CR을 업데이트하려면 다음을 수행합니다.

      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. 선택한 Kubernetes 리소스를 마이그레이션하기 위해 MigMigration CR을 생성합니다. migPlanRef:에서 올바른 MigPlan 이 참조되었는지 확인합니다.

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