2.3. 명령줄에서 VMware vSphere 마이그레이션 실행

프로세스

1. 소스 공급자 인증 정보에 대한 시크릿 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Secret
   metadata:
     name: <secret>
     namespace: <namespace>
     ownerReferences: 

   1

   
       - apiVersion: forklift.konveyor.io/v1beta1
         kind: Provider
         name: <provider_name>
         uid: <provider_uid>
     labels:
       createdForProviderType: vsphere
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   ownerReferences 섹션은 선택 사항입니다.

   2

   vCenter 사용자 또는 ESX/ESXi 사용자를 지정합니다.

   3

   vCenter 사용자의 암호 또는 ESX/ESXi 사용자를 지정합니다.

   4

   인증서 확인을 건너뛰려면 "true" 를 지정하고 "false" 를 지정하여 인증서를 확인합니다. 지정하지 않는 경우 기본값은 "false" 입니다. 인증서 확인을 건너뛰면 비보안 마이그레이션이 진행되므로 인증서가 필요하지 않습니다. 비보안 마이그레이션은 전송된 데이터가 안전하지 않은 연결을 통해 전송되고 잠재적으로 민감한 데이터가 노출될 수 있음을 의미합니다.

   5

   이 필드를 설정하지 않고 인증서 확인을 건너뛰면 MTV가 시스템 CA 사용을 시도합니다.

   6

   vCenter 또는 ESX/ESXi의 API 끝점 URL을 지정합니다(예: https://<vCenter_host>/sdk ).

2. 소스 공급자에 대한 공급자 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <source_provider>
     namespace: <namespace>
   spec:
     type: vsphere
     url: <api_end_point> 

   1

   
     settings:
       vddkInitImage: <VDDK_image> 

   2

   
       sdkEndpoint: vcenter 

   3

   
     secret:
       name: <secret> 

   4

   
       namespace: <namespace>
   EOF

   Copy to Clipboard Toggle word wrap

   1

   API 끝점의 URL을 지정합니다(예: https://<vCenter_host>/sdk ).

   2

   선택 사항이지만 마이그레이션을 가속화하기 위해 VDDK 이미지를 생성하는 것이 좋습니다. OpenShift 문서에 따라 생성한 VDDK 이미지를 지정합니다.

   3

   옵션: vcenter 또는 esxi.

   4

   공급자 Secret CR의 이름을 지정합니다.

3. 호스트 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Host
   metadata:
     name: <vmware_host>
     namespace: <namespace>
   spec:
     provider:
       namespace: <namespace>
       name: <source_provider> 

   1

   
     id: <source_host_mor> 

   2

   
     ipAddress: <source_network_ip> 

   3

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   VMware vSphere Provider CR의 이름을 지정합니다.

   2

   VMware vSphere 호스트의 Managed Object Reference (moRef)를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   3

   VMware vSphere 마이그레이션 네트워크의 IP 주소를 지정합니다.

4. NetworkMap 매니페스트를 생성하여 소스 및 대상 네트워크를 매핑합니다.

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: NetworkMap
   metadata:
     name: <network_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           name: <network_name>
           type: pod 

   1

   
         source: 

   2

   
           id: <source_network_id>
           name: <source_network_name>
       - destination:
           name: <network_attachment_definition> 

   3

   
           namespace: <network_attachment_definition_namespace> 

   4

   
           type: multus
         source:
           id: <source_network_id>
           name: <source_network_name>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace> 

   5

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   허용되는 값은 pod,multus 및 ignored 입니다. 이 마이그레이션을 위해 이 네트워크에 VM을 연결하지 않도록 무시됨을 사용합니다.

   2

   id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다. id 는 VMware vSphere 네트워크 Managed Object Reference (moRef)를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   3

   각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.

   4

   type 이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.

   5

   UDN(사용자 정의 네트워크)을 사용하는 경우 해당 네임스페이스는 OpenShift Virtualization에 정의됩니다.

5. 소스 및 대상 스토리지를 매핑하는 StorageMap 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: StorageMap
   metadata:
     name: <storage_map>
     namespace: <namespace>
   spec:
     map:
       - destination:
           storageClass: <storage_class>
           accessMode: <access_mode> 

   1

   
         source:
           id: <source_datastore> 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   Copy to Clipboard Toggle word wrap

   1

   허용되는 값은 ReadWriteOnce 및 ReadWriteMany 입니다.

   2

   VMware vSphere 데이터 저장소 moRef를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

6. 선택 사항: Plan CR에 지정된 단계에서 VM에서 사용자 정의 코드를 실행하려면 후크 매니페스트를 생성합니다.

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/kubev2v/hook-runner
     serviceAccount:<service account> 

   1

   
     playbook: |
       LS0tCi0gbm... 

   2

   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   선택사항: Red Hat OpenShift 서비스 계정. serviceAccount 매개변수를 사용하여 클러스터 리소스를 수정합니다.

   2

   base64로 인코딩된 Ansible Playbook. 플레이북을 지정하는 경우 이미지에 ansible-runner 를 포함해야 합니다.

   참고

   기본 hook-runner 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

7. 다음 명령을 입력하여 MTV 마이그레이션에 사용되는 전송 네트워크의 네트워크 연결 정의(NAD)를 생성합니다.

   이 정의를 사용하여 DHCP(Dynamic Host Configuration Protocol) 또는 정적에서 인터페이스의 IP 주소를 구성합니다.

   IP 주소를 구성하면 인터페이스가 구성된 게이트웨이에 도달할 수 있습니다.

   $ oc edit NetworkAttachmentDefinitions <name_of_the_NAD_to_edit>
   apiVersion: k8s.cni.cncf.io/v1
   kind: NetworkAttachmentDefinition
   metadata:
     name: <name_of_transfer_network>
     namespace: <namespace>
     annotations:
       forklift.konveyor.io/route: <IP_address>

   Copy to Clipboard Toggle word wrap

8. 마이그레이션을 위한 계획 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Plan
   metadata:
     name: <plan> 

   1

   
     namespace: <namespace>
   spec:
     warm: false 

   2

   
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
     map: 

   3

   
       network: 

   4

   
         name: <network_map> 

   5

   
         namespace: <namespace>
       storage: 

   6

   
         name: <storage_map> 

   7

   
         namespace: <namespace>
     preserveStaticIPs: 

   8

   
     networkNameTemplate: <network_interface_template> 

   9

   
     pvcNameTemplate: <pvc_name_template> 

   10

   
     pvcNameTemplateUseGenerateName: true 

   11

   
     skipGuestConversion: false 

   12

   
     targetAffinity: <affinity rule> 

   13

   
     targetLabels: 

   14

   
       label: <label>
     targetNodeSelector: 

   15

   
       <key>:<value>
     targetNamespace: <target_namespace>
     useCompatibilityMode: true 

   16

   
     volumeNameTemplate: <volume_name_template> 

   17

   
     vms: 

   18

   
       - id: <source_vm1> 

   19

   
       - name: <source_vm2>
         networkNameTemplate: <network_interface_template_for_this_vm> 

   20

   
         pvcNameTemplate: <pvc_name_template_for_this_vm> 

   21

   
         volumeNameTemplate: <volume_name_template_for_this_vm> 

   22

   
         targetName: <target_name> 

   23

   
         hooks: 

   24

   
           - hook:
               namespace: <namespace>
               name: <hook> 

   25

   
             step: <step> 

   26

   
   
   EOF

   Copy to Clipboard Toggle word wrap

   1

   Plan CR의 이름을 지정합니다.

   2

   마이그레이션이 웜인지 - true - 또는 cold - false 인지 여부를 지정합니다. 마이그레이션 매니페스트에서 cutover 매개변수 값을 지정하지 않고 웜 마이그레이션 을 지정하면 사전 복사 단계만 실행됩니다.

   3

   계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.

   4

   마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.

   5

   NetworkMap CR의 이름을 지정합니다.

   6

   마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.

   7

   StorageMap CR의 이름을 지정합니다.

   8

   기본적으로 마이그레이션 프로세스 중에 vNIC(가상 네트워크 인터페이스 컨트롤러)가 변경됩니다. 결과적으로 게스트 VM의 인터페이스 이름에 연결된 고정 IP 주소로 구성된 vNIC는 IP 주소가 손실됩니다. 이를 방지하려면 preserveStaticIPs 를 true 로 설정합니다. MTV는 vNIC 속성이 누락된 모든 VM에 대한 경고 메시지를 발행합니다. 누락된 vNIC 속성을 검색하려면 vNIC 속성이 MTV에 보고되도록 vSphere에서 해당 VM을 실행합니다.

   9

   선택 사항입니다. 계획에서 VM의 네트워크 인터페이스 이름에 대한 템플릿을 지정합니다. 템플릿은 Go 템플릿 구문을 따르며 다음 변수에 액세스할 수 있습니다.

   • .NetworkName: 대상 네트워크가 multus 인 경우 Multus 네트워크 연결 정의의 이름을 추가합니다. 그렇지 않으면 이 변수를 비워 둡니다.
   • .networkNamespace: 대상 네트워크가 multus 인 경우 Multus 네트워크 연결 정의가 있는 네임스페이스를 추가합니다.
   • .networkType: 네트워크 유형을 지정합니다. options: multus 또는 pod.

   • .NetworkIndex: 네트워크 인터페이스(0 기반)의 Sequential 인덱스입니다.

     예

   • "net-{{.NetworkIndex}}"

   • {{if eq .NetworkType "pod"}}pod{{else}}multus-{{.NetworkIndex}}{{end}}"

     변수 이름은 63자를 초과할 수 없습니다. 템플릿으로 제공되는 VM 이름은 대문자를 포함하거나 RFC 1123 규칙을 위반해서는 안 됩니다. 이러한 규칙은 네트워크 이름 네트워크 템플릿, PVC 이름 템플릿, VM 이름 템플릿, 볼륨 이름 템플릿에 적용됩니다.

     중요

     MTV는 여기에 설명된 템플릿에서 생성된 VM 이름을 확인하지 않습니다. 이름에 대문자가 포함되거나 RFC 1123 규칙을 위반하는 VM이 포함된 마이그레이션은 자동으로 실패합니다. 실패를 방지하려면 MTV에서 지원하는 sprig 방법을 사용하는 Go 스크립트를 실행해야 할 수 있습니다. MTV가 지원하는 방법을 설명하는 표는 VMware VM 이름에 대한 MTV 템플릿 유틸리티를 참조하십시오.

   10

   선택 사항입니다. 계획의 PVC(영구 볼륨 클레임) 이름에 대한 템플릿을 지정합니다. 템플릿은 Go 템플릿 구문을 따르며 다음 변수에 액세스할 수 있습니다.

   • .vmname: VM의 이름입니다.
   • .PlanName: 마이그레이션 계획의 이름입니다.
   • .DiskIndex: 디스크의 초기 볼륨 인덱스입니다.
   • .RootDiskIndex: 루트 디스크의 인덱스입니다.

   • .shared : 공유 볼륨의 경우 true: true , 비공유 볼륨에 대해 false 입니다.

     예

   • "{{.VmName}}-disk-{{.DiskIndex}}"
   • "{{if eq .DiskIndex .RootDiskIndex}}root{{else}}data{{end}}-{{.DiskIndex}}"
   • "{{if .Shared}}shared-{{end}}{{.VmName}}-{{.DiskIndex}}"

   11

   선택 사항:

   • true 로 설정하면 MTV는 모든 PVC에 고유한 이름이 있는지 확인하기 위해 임의로 생성된 하나 이상의 영숫자 문자를 PVC 이름에 추가합니다.

   • false 로 설정하면 pvcNameTemplate 을 지정하면 MTV는 PVC 이름에 이러한 문자를 추가하지 않습니다.

     주의

     pvcNameTemplateUseGenerateName 을 false 로 설정하면 생성된 PVC 이름이 고유하지 않을 수 있으며 충돌이 발생할 수 있습니다.

   12

   virt-v2v 툴을 사용하여 마이그레이션하기 전에 VM을 변환하는지 여부를 결정합니다. 이로 인해 VM이 OpenShift Virtualization과 호환됩니다.

   • false 로 설정하면 기본값인 MTV는 virt-v2v 를 사용하여 VM을 마이그레이션합니다.

   • true 로 설정하면 MTV는 먼저 변환하지 않고 VM을 복사하는 원시 복사 모드를 사용하여 VM을 마이그레이션합니다.

     원시 복사 모드는 virt-v2v 로 변환하지 않고 VM을 복사합니다. 이를 통해 더 빠른 변환, 광범위한 운영 체제를 실행하는 VM 마이그레이션, 키 없이도 Linux Unified Key Setup(LUKS)을 사용하여 암호화된 디스크 마이그레이션을 지원할 수 있습니다. 그러나 원시 복사 모드를 사용하여 마이그레이션된 VM은 OpenShift Virtualization에서 제대로 작동하지 않을 수 있습니다. virt-v2v 에 대한 자세한 내용은 MTV가 virt-v2v 툴을 사용하는 방법을 참조하십시오.

   13

   선택 사항: 매우 복잡할 수 있는 유사성 규칙이 이 라벨 뒤에 있는 행에 입력됩니다.

   targetAffinity,targetLabels, targetNodeSelector 는 VM 대상 스케줄링을 지원하는 레이블입니다. MTV를 통해 VM(가상 머신)을 특정 노드 또는 워크로드(Pod)로 마이그레이션하고 VM 전원이 켜진 시기를 예약할 수 있는 기능입니다. 일반적으로 기능에 대한 자세한 내용은 대상 VM 스케줄링 옵션을 참조하십시오. 예제 YAML 스니펫을 포함하여 CLI와 함께 기능을 사용하는 방법에 대한 자세한 내용은 명령줄 인터페이스의 대상 VM 예약을 참조하십시오.

   14

   선택 사항: 식별 및 관리를 위해 마이그레이션된 VM에 조직 또는 운영 레이블을 적용합니다.

   15

   선택 사항: 입력한 키-값 쌍에 대해 정확히 일치하는 노드에 VM이 예약되었는지 확인합니다.

   16

   skipGuestConversion 이 true 인 경우 마이그레이션에서 VirtIO 장치 또는 호환성 장치(SATA 버스, E1000E NIC)를 사용하는지 여부를 결정합니다. 즉, 마이그레이션에 원시 복사 모드가 사용되는 경우입니다. virt-v2v 변환이 항상 VirtIO 장치를 사용하므로 skipGuestConversion 이 false 인 경우 useCompatibilityMode 설정은 적용되지 않습니다.

   • true 로 설정하면 MTV는 마이그레이션 프로세스에서 호환성 장치(SATA 버스, E1000E NIC)를 사용하여 마이그레이션 후 VM을 부팅할 수 있도록 합니다.
   • false 로 설정하면 MTV는 마이그레이션 프로세스에서 고성능 VirtIO 장치를 사용하고 virt-v2v 는 마이그레이션 후 VM을 부팅할 수 있도록 합니다. 이 옵션을 사용하기 전에 VirtIO 드라이버가 소스 VM에 이미 설치되어 있는지 확인합니다.

   17

   선택 사항: 계획에 있는 VM의 볼륨 인터페이스 이름에 대한 템플릿을 지정합니다. 템플릿은 Go 템플릿 구문을 따르며 다음 변수에 액세스할 수 있습니다.

   • .PVCName: 이 볼륨을 사용하여 VM에 마운트된 PVC의 이름입니다.

   • .VolumeIndex: 볼륨 인터페이스(0 기반)의 중요한 인덱스입니다.

     예

   • "disk-{{.VolumeIndex}}"
   • "pvc-{{.PVCName}}"

   18

   id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다. UDN을 사용하는 경우 공급자의 IP 주소가 UDN 서브넷 외부에 있는지 확인합니다. IP 주소가 UDN 서브넷 내에 있으면 마이그레이션이 실패합니다.

   19

   VMware vSphere VM moRef를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.

   20

   선택 사항: 특정 VM의 네트워크 인터페이스 이름을 지정합니다. spec:networkNameTemplate 에 설정된 값을 재정의합니다. 호출 9에서 와 같이 변수 및 예제 .

   21

   선택 사항: 특정 VM의 PVC 이름을 지정합니다. spec:pvcNameTemplate 에 설정된 값을 재정의합니다. 호출기 10에서 와 같이 변수 및 예제입니다.

   22

   선택 사항: 특정 VM의 볼륨 이름을 지정합니다. spec:volumeNameTemplate 에 설정된 값을 재정의합니다. 호출 14에서 와 같은 변수 및 예제입니다.

   23

   선택 사항: MTV는 대상 VM의 이름을 자동으로 생성합니다. 이 매개변수를 사용하고 새 이름을 입력하여 이 이름을 재정의할 수 있습니다. 입력한 이름은 고유해야 하며 유효한 Kubernetes 하위 도메인이어야 합니다. 그러지 않으면 마이그레이션이 자동으로 실패합니다.

   24

   선택 사항: VM에 대해 최대 두 개의 후크를 지정합니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.

   25

   Hook CR의 이름을 지정합니다.

   26

   허용되는 값은 마이그레이션 계획이 시작되기 전에 Pre Hook 또는 마이그레이션이 완료된 후 postHook입니다.

   중요

   VMware 7 VM을 CentOS 7.9를 사용하는 OpenShift 4.13+ 플랫폼으로 마이그레이션하면 네트워크 인터페이스 이름이 변경되고 VM의 고정 IP 구성이 더 이상 작동하지 않습니다.

9. Plan CR을 실행할 마이그레이션 매니페스트를 생성합니다.

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Migration
   metadata:
     name: <name_of_migration_cr>
     namespace: <namespace>
   spec:
     plan:
       name: <name_of_plan_cr>
       namespace: <namespace>
     cutover: <optional_cutover_time>
   EOF

   Copy to Clipboard Toggle word wrap
   참고

   컷오버 시간을 지정하는 경우 UTC 시간 오프셋과 함께 ISO 8601 형식을 사용합니다(예: 2024-04-04T01:23:45.678+09:00 ).