Migration Toolkit for Virtualization 설치 및 사용

프로세스

1. 임시 디렉터리를 만들고 해당 디렉터리로 이동합니다.

   Copy to Clipboard Toggle word wrap

   $ mkdir /tmp/<dir_name> && cd /tmp/<dir_name>

2. 브라우저에서 VMware VDDK 버전 8 다운로드 페이지로 이동합니다.
3. 버전 8.0.1을 선택하고 다운로드를 클릭합니다.

1. VDDK 아카이브 파일을 임시 디렉터리에 저장합니다.

2. VDDK 아카이브를 추출합니다.

   Copy to Clipboard Toggle word wrap

   $ tar -xzf VMware-vix-disklib-<version>.x86_64.tar.gz

3. Dockerfile을 생성합니다.

   Copy to Clipboard Toggle word wrap

   $ cat > Dockerfile <<EOF
   FROM registry.access.redhat.com/ubi8/ubi-minimal
   USER 1001
   COPY vmware-vix-disklib-distrib /vmware-vix-disklib-distrib
   RUN mkdir -p /opt
   ENTRYPOINT ["cp", "-r", "/vmware-vix-disklib-distrib", "/opt"]
   EOF

4. VDDK 이미지를 빌드합니다.

   Copy to Clipboard Toggle word wrap

   $ podman build . -t <registry_route_or_server_path>/vddk:<tag>

5. VDDK 이미지를 레지스트리로 푸시합니다.

   Copy to Clipboard Toggle word wrap

   $ podman push <registry_route_or_server_path>/vddk:<tag>

6. OpenShift Virtualization 환경에서 이미지에 액세스할 수 있는지 확인합니다.

프로세스

1. ESXi 호스트에 root로 로그인합니다.

2. /etc/vmware/hostd/config.xml:에서 maxMemory 의 값을 1000000000 으로 변경합니다.

   Copy to Clipboard Toggle word wrap

   ...
         <nfcsvc>
            <path>libnfcsvc.so</path>
            <enabled>true</enabled>
            <maxMemory>1000000000</maxMemory>
            <maxStreamMemory>10485760</maxStreamMemory>
         </nfcsvc>
   ...

3. hostd 를 다시 시작하십시오.

   Copy to Clipboard Toggle word wrap

   # /etc/init.d/hostd restart

   호스트를 재부팅할 필요가 없습니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭한 다음 Create Plan 을 클릭합니다.

   마이그레이션 계획 생성 마법사가 소스 공급자 선택 인터페이스로 열립니다.

2. 마이그레이션할 VM의 소스 공급자를 선택합니다.

   Select virtual machines 인터페이스가 열립니다.

3. 마이그레이션할 VM을 선택하고 다음을 클릭합니다.

   마이그레이션 계획 생성 창이 열립니다. 대상 공급자 및 네임스페이스, 네트워크 맵 및 스토리지 맵에 대한 소스 공급자의 이름과 제안 사항을 표시합니다.

4. 계획 이름을 입력합니다.
5. 편집 가능한 항목을 필요한 대로 변경합니다.
6. 매핑 추가 를 클릭하여 제안된 네트워크 매핑 또는 스토리지 매핑을 편집하거나 하나 이상의 추가 매핑을 추가합니다.

7. 마이그레이션 계획 생성을 클릭합니다.

   MTV는 마이그레이션 계획 및 계획 세부 정보 페이지가 열리며 계획을 사용할 준비가 되었는지 또는 오류가 포함되어 있는지 여부를 나타냅니다. 계획 세부 정보가 나열되고 이전 페이지에서 입력한 항목을 편집할 수 있습니다. 변경 사항이 있는 경우 MTV는 계획을 다시 검증합니다.

8. VMware 소스 공급자만 해당(선택 사항):

   • VM의 고정 IP 유지: 기본적으로 마이그레이션 프로세스 중에 vNIC(가상 네트워크 인터페이스 컨트롤러)가 변경됩니다. 이로 인해 vSphere에서 고정 IP로 설정된 vNIC가 IP가 손실됩니다. VM의 고정 IP를 보존하여 방지하려면 고정 IP 사전 예약 옆에 있는 편집 아이콘을 클릭하고 열리는 창에서 고정 IP 스위치를 보존할지 여부를 설정합니다. 그런 다음 저장을 클릭합니다.

     그런 다음 MTV는 vNIC 속성이 누락되는 Windows 운영 체제가 있는 모든 VM에 대한 경고 메시지를 발행합니다. 누락된 vNIC 속성을 검색하려면 vNIC 속성이 MTV에 보고되도록 vSphere에서 해당 VM을 실행합니다.

   • Linux Unified Key Setup (LUKS)을 사용하여 암호화된 디스크에 대한 암호 해독 암호 목록을 입력합니다. LUKS 암호화 장치의 암호 해독 목록을 입력하고 설정 섹션에서 디스크 암호 해독 암호 옆에 있는 편집 아이콘을 클릭하고 암호를 입력한 다음 저장을 클릭합니다. 특정 순서로 암호를 입력할 필요가 없습니다. 각 LUKS 암호화 장치에 대해 MTV는 장치를 잠금 해제할 때까지 각 암호를 시도합니다.

   • 루트 장치 지정: 다중 부팅 VM 마이그레이션에만 적용됩니다. 기본적으로 MTV는 루트 장치로 감지된 첫 번째 부팅 가능 장치를 사용합니다.

     다른 루트 장치를 지정하려면 설정 섹션에서 루트 장치 옆에 있는 편집 아이콘을 클릭하고 일반적으로 사용되는 옵션 목록에서 장치를 선택하거나 텍스트 상자에 장치를 입력합니다.

     MTV는 디스크 위치에 다음 형식을 사용합니다. /dev/sd<disk_identifier><disk_partition > . 예를 들어 두 번째 디스크가 루트 장치이고 운영 체제가 디스크의 두 번째 파티션에 있는 경우 형식은 /dev/sdb2 입니다. 부팅 장치를 입력한 후 저장을 클릭합니다.

     제공된 부팅 장치가 올바르지 않기 때문에 변환이 실패하면 변환 Pod 로그를 확인하여 올바른 정보를 얻을 수 있습니다.

9. RHV 소스 공급자만(선택 사항):

   • RHV에서 마이그레이션되는 VM의 CPU 모델을 유지: 일반적으로 RHV VM의 CPU 모델(유형)은 클러스터 수준에서 설정되지만 사용자 지정 CPU 모델이라고 하는 VM 수준에서 설정할 수 있습니다. 기본적으로 MTV는 대상 클러스터에서 CPU 모델을 다음과 같이 설정합니다. MTV는 VM이 있는 VM의 사용자 지정 CPU 설정을 유지하지만 사용자 지정 CPU 설정이 없는 VM의 경우 MTV는 CPU 모델을 설정하지 않습니다. 대신 CPU 모델은 나중에 OpenShift Virtualization에 의해 설정됩니다.

     RHV VM의 클러스터 수준 CPU 모델을 유지하려면 설정 섹션에서 Preserve CPU 모델 옆에 있는 편집 아이콘을 클릭합니다. CPU 모델 스위치를 보존할지 여부에 관계없이 W 를 전환한 다음 저장을 클릭합니다.

10. 계획이 유효하면,

    1. 마이그레이션 시작을 클릭하여 지금 계획을 실행할 수 있습니다.
    2. 가상화 계획 페이지에서 선택하고 마이그레이션 계획 실행 절차에 따라 나중에 계획을 실행할 수 있습니다.

프로세스

1. Red Hat OpenShift 웹 콘솔에서 가상화를 위한 공급자 를 클릭합니다.

2. 적절한 소스 공급자 행에서 VM 을 클릭합니다.

   가상 머신 탭이 열립니다.

3. 마이그레이션할 VM을 선택하고 Create migration plan 을 클릭합니다.

   마이그레이션 계획 생성 창이 열립니다. 대상 공급자 및 네임스페이스, 네트워크 맵 및 스토리지 맵에 대한 소스 공급자의 이름과 제안 사항을 표시합니다.

4. 계획 이름을 입력합니다.
5. 편집 가능한 항목을 필요한 대로 변경합니다.
6. 매핑 추가 를 클릭하여 제안된 네트워크 매핑 또는 스토리지 매핑을 편집하거나 하나 이상의 추가 매핑을 추가합니다.

7. 마이그레이션 계획 생성을 클릭합니다.

   MTV는 마이그레이션 계획 및 계획 세부 정보 페이지가 열리며 계획을 사용할 준비가 되었는지 또는 오류가 포함되어 있는지 여부를 나타냅니다. 계획 세부 정보가 나열되고 이전 페이지에서 입력한 항목을 편집할 수 있습니다. 변경 사항이 있는 경우 MTV는 계획을 다시 검증합니다.

8. VMware 소스 공급자만 해당(선택 사항):

   • VM의 고정 IP 유지: 기본적으로 마이그레이션 프로세스 중에 vNIC(가상 네트워크 인터페이스 컨트롤러)가 변경됩니다. 이로 인해 vSphere에서 고정 IP로 설정된 vNIC가 IP가 손실됩니다. VM의 고정 IP를 보존하여 방지하려면 고정 IP 사전 예약 옆에 있는 편집 아이콘을 클릭하고 열리는 창에서 고정 IP 스위치를 보존할지 여부를 설정합니다. 그런 다음 저장을 클릭합니다.

     그런 다음 MTV는 vNIC 속성이 누락되는 Windows 운영 체제가 있는 모든 VM에 대한 경고 메시지를 발행합니다. 누락된 vNIC 속성을 검색하려면 vNIC 속성이 MTV에 보고되도록 vSphere에서 해당 VM을 실행합니다.

   • Linux Unified Key Setup (LUKS)을 사용하여 암호화된 디스크에 대한 암호 해독 암호 목록을 입력합니다. LUKS 암호화 장치의 암호 해독 목록을 입력하고 설정 섹션에서 디스크 암호 해독 암호 옆에 있는 편집 아이콘을 클릭하고 암호를 입력한 다음 저장을 클릭합니다. 특정 순서로 암호를 입력할 필요가 없습니다. 각 LUKS 암호화 장치에 대해 MTV는 장치를 잠금 해제할 때까지 각 암호를 시도합니다.

   • 루트 장치 지정: 다중 부팅 VM 마이그레이션에만 적용됩니다. 기본적으로 MTV는 루트 장치로 감지된 첫 번째 부팅 가능 장치를 사용합니다.

     다른 루트 장치를 지정하려면 설정 섹션에서 루트 장치 옆에 있는 편집 아이콘을 클릭하고 일반적으로 사용되는 옵션 목록에서 장치를 선택하거나 텍스트 상자에 장치를 입력합니다.

     MTV는 디스크 위치에 다음 형식을 사용합니다. /dev/sd<disk_identifier><disk_partition > . 예를 들어 두 번째 디스크가 루트 장치이고 운영 체제가 디스크의 두 번째 파티션에 있는 경우 형식은 /dev/sdb2 입니다. 부팅 장치를 입력한 후 저장을 클릭합니다.

     제공된 부팅 장치가 올바르지 않기 때문에 변환이 실패하면 변환 Pod 로그를 확인하여 올바른 정보를 얻을 수 있습니다.

9. RHV 소스 공급자만(선택 사항):

   • RHV에서 마이그레이션되는 VM의 CPU 모델을 유지: 일반적으로 RHV VM의 CPU 모델(유형)은 클러스터 수준에서 설정되지만 사용자 지정 CPU 모델이라고 하는 VM 수준에서 설정할 수 있습니다. 기본적으로 MTV는 대상 클러스터에서 CPU 모델을 다음과 같이 설정합니다. MTV는 VM이 있는 VM의 사용자 지정 CPU 설정을 유지하지만 사용자 지정 CPU 설정이 없는 VM의 경우 MTV는 CPU 모델을 설정하지 않습니다. 대신 CPU 모델은 나중에 OpenShift Virtualization에 의해 설정됩니다.

     RHV VM의 클러스터 수준 CPU 모델을 유지하려면 설정 섹션에서 Preserve CPU 모델 옆에 있는 편집 아이콘을 클릭합니다. CPU 모델 스위치를 보존할지 여부에 관계없이 W 를 전환한 다음 저장을 클릭합니다.

10. 계획이 유효하면,

    1. 마이그레이션 시작을 클릭하여 지금 계획을 실행할 수 있습니다.
    2. 가상화 계획 페이지에서 선택하고 마이그레이션 계획 실행 절차에 따라 나중에 계획을 실행할 수 있습니다.

프로세스

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

   Copy to Clipboard Toggle word wrap

   $ 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

   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. 소스 공급자에 대한 공급자 매니페스트를 생성합니다.

   Copy to Clipboard Toggle word wrap

   $ 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

   1

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

   2

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

   3

   옵션: vcenter 또는 esxi.

   4

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   1

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

   2

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

   3

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

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

   Copy to Clipboard Toggle word wrap

   $  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>
   EOF

   1

   허용되는 값은 pod 및 multus 입니다.

   2

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

   3

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

   4

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   1

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

   2

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

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

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   다음과 같습니다.

   Playbook은 선택적 Base64로 인코딩된 Ansible 플레이북을 나타냅니다. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

   참고

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

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

   Copy to Clipboard Toggle word wrap

   $ 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>
     targetNamespace: <target_namespace>
     vms: 

   8

   
       - id: <source_vm> 

   9

   
       - name: <source_vm>
         hooks: 

   10

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

   11

   
             step: <step> 

   12

   
   EOF

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

   7

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

   8

   id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다.
   

   9

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

   10

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

   11

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

   12

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   참고

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

프로세스

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

   Copy to Clipboard Toggle word wrap

   $ 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: ovirt
       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

   1

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

   2

   RHV Manager 사용자를 지정합니다.

   3

   사용자 암호를 지정합니다.

   4

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

   5

   타사 인증서로 대체되지 않은 경우 Manager CA 인증서를 입력합니다. 이 경우 Manager Apache CA 인증서를 입력합니다. https://<engine_host>/ovirt-engine/services/pki-resource?resource=ca-certificate&format=X509-PEM-CA에서 Manager CA 인증서를 검색할 수 있습니다.

   6

   API 끝점 URL을 지정합니다(예: https://<engine_host>/ovirt-engine/api ).

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

   Copy to Clipboard Toggle word wrap

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   1

   API 끝점의 URL을 지정합니다(예: https://<engine_host>/ovirt-engine/api ).

   2

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

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

   Copy to Clipboard Toggle word wrap

   $  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>
   EOF

   1

   허용되는 값은 pod 및 multus 입니다.

   2

   id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다. id 의 경우 RHV 네트워크 UUID(Universal Unique ID)를 지정합니다.

   3

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

   4

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

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

   Copy to Clipboard Toggle word wrap

   $ 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_storage_domain> 

   2

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

   1

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

   2

   RHV 스토리지 도메인 UUID를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다.

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

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   다음과 같습니다.

   Playbook은 선택적 Base64로 인코딩된 Ansible 플레이북을 나타냅니다. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

   참고

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

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

   Copy to Clipboard Toggle word wrap

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

   1

   
     namespace: <namespace>
     preserveClusterCpuModel: true 

   2

   
   spec:
     warm: false 

   3

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

   4

   
       network: 

   5

   
         name: <network_map> 

   6

   
         namespace: <namespace>
       storage: 

   7

   
         name: <storage_map> 

   8

   
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 

   9

   
       - id: <source_vm> 

   10

   
       - name: <source_vm>
         hooks: 

   11

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

   12

   
             step: <step> 

   13

   
   EOF

   1

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

   2

   아래 참고를 참조하십시오.

   3

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

   4

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

   5

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

   6

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

   7

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

   8

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

   9

   id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다.

   10

   RHV VM UUID를 지정합니다.

   11

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

   12

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

   13

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

   참고
   • 마이그레이션된 시스템이 사용자 지정 CPU 모델로 설정된 경우 preserveClusterCpuModel 의 설정에 관계없이 대상 클러스터의 해당 CPU 모델로 설정됩니다.

   • 마이그레이션된 시스템이 사용자 지정 CPU 모델로 설정되지 않은 경우:

     • preserveClusterCpuModel 이 'true'로 설정된 경우 MTV는 클러스터 구성에 따라 RHV에서 실행될 때 VM의 CPU 모델을 확인한 다음 마이그레이션된 VM을 해당 CPU 모델로 설정합니다.
     • preserveClusterCpuModel 이 'false'로 설정된 경우 MTV는 CPU 유형을 설정하지 않으며 VM은 대상 클러스터의 기본 CPU 모델로 설정됩니다.

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

   Copy to Clipboard Toggle word wrap

   $ 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

   참고

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

프로세스

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

   Copy to Clipboard Toggle word wrap

   $ 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: openstack
       createdForResourceType: providers
   type: Opaque
   stringData:
     user: <user> 

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     domainName: <domain_name>
     projectName: <project_name>
     regionName: <region_name>
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   1

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

   2

   OpenStack 사용자를 지정합니다.

   3

   사용자 OpenStack 암호를 지정합니다.

   4

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

   5

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

   6

   API 끝점 URL을 지정합니다(예: https://<identity_service>/v3 ).

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

   Copy to Clipboard Toggle word wrap

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   1

   API 끝점의 URL을 지정합니다.

   2

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

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

   Copy to Clipboard Toggle word wrap

   $  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>
   EOF

   1

   허용되는 값은 pod 및 multus 입니다.

   2

   id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다. id 는 OpenStack 네트워크 UUID를 지정합니다.

   3

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

   4

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

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

   Copy to Clipboard Toggle word wrap

   $ 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_volume_type> 

   2

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

   1

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

   2

   OpenStack volume_type UUID를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다.

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

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   다음과 같습니다.

   Playbook은 선택적 Base64로 인코딩된 Ansible 플레이북을 나타냅니다. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

   참고

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

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

   Copy to Clipboard Toggle word wrap

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

   1

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

   2

   
       network: 

   3

   
         name: <network_map> 

   4

   
         namespace: <namespace>
       storage: 

   5

   
         name: <storage_map> 

   6

   
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 

   7

   
       - id: <source_vm> 

   8

   
       - name: <source_vm>
         hooks: 

   9

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

   10

   
             step: <step> 

   11

   
   EOF

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

   7

   id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다.

   8

   OpenStack VM UUID를 지정합니다.

   9

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

   10

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

   11

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   참고

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

프로세스

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

   Copy to Clipboard Toggle word wrap

   $ 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: ova
       createdForResourceType: providers
   type: Opaque
   stringData:
     url: <nfs_server:/nfs_path> 

   2

   
   EOF

   1

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

   2

   여기서: nfs_server 는 공유가 생성된 서버의 IP 또는 호스트 이름이고 nfs_path 는 OVA 파일이 저장된 서버의 경로입니다.

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

   Copy to Clipboard Toggle word wrap

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   1

   여기서: nfs_server 는 공유가 생성된 서버의 IP 또는 호스트 이름이고 nfs_path 는 OVA 파일이 저장된 서버의 경로입니다.

   2

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

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

   Copy to Clipboard Toggle word wrap

   $  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:
           id: <source_network_id> 

   2

   
       - destination:
           name: <network_attachment_definition> 

   3

   
           namespace: <network_attachment_definition_namespace> 

   4

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

   1

   허용되는 값은 pod 및 multus 입니다.

   2

   OVA 네트워크 UUID(Universal Unique ID)를 지정합니다.

   3

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

   4

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

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

   Copy to Clipboard Toggle word wrap

   $ 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:
           name:  Dummy storage for source provider <provider_name> 

   2

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

   1

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

   2

   OVA의 경우 StorageMap 은 OVA의 모든 디스크가 연결된 단일 스토리지만 대상의 스토리지 클래스에 매핑할 수 있습니다. 이러한 이유로 UI에서 "Dummy storage for source provider <provider_name>"이라고 합니다. YAML에서 따옴표 없이 위의 문구를 작성하고 <provider_name>을 공급자의 실제 이름으로 바꿉니다.

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

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   다음과 같습니다.

   Playbook은 선택적 Base64로 인코딩된 Ansible 플레이북을 나타냅니다. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

   참고

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

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

   Copy to Clipboard Toggle word wrap

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

   1

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

   2

   
       network: 

   3

   
         name: <network_map> 

   4

   
         namespace: <namespace>
       storage: 

   5

   
         name: <storage_map> 

   6

   
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms: 

   7

   
       - id: <source_vm> 

   8

   
       - name: <source_vm>
         hooks: 

   9

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

   10

   
             step: <step> 

   11

   
   EOF

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

   7

   id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다.

   8

   OVA VM UUID를 지정합니다.

   9

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

   10

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

   11

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   참고

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

프로세스

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

   Copy to Clipboard Toggle word wrap

   $ 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: openshift
       createdForResourceType: providers
   type: Opaque
   stringData:
     token: <token> 

   2

   
     password: <password> 

   3

   
     insecureSkipVerify: <"true"/"false"> 

   4

   
     cacert: | 

   5

   
       <ca_certificate>
     url: <api_end_point> 

   6

   
   EOF

   1

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

   2

   cluster-admin 권한이 있는 서비스 계정의 토큰을 지정합니다. 토큰과 URL 이 모두 비어 있으면 로컬 OpenShift 클러스터가 사용됩니다.

   3

   사용자 암호를 지정합니다.

   4

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

   5

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

   6

   API 서버의 끝점 URL을 지정합니다.

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

   Copy to Clipboard Toggle word wrap

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

   1

   
     secret:
       name: <secret> 

   2

   
       namespace: <namespace>
   EOF

   1

   API 서버의 끝점 URL을 지정합니다.

   2

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

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

   Copy to Clipboard Toggle word wrap

   $  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:
           name: <network_name>
           type: pod
       - destination:
           name: <network_attachment_definition> 

   2

   
           namespace: <network_attachment_definition_namespace> 

   3

   
           type: multus
         source:
           name: <network_attachment_definition>
           namespace: <network_attachment_definition_namespace>
           type: multus
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

   허용되는 값은 pod 및 multus 입니다.

   2

   각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다. 네임스페이스 속성을 사용하거나 다음과 같이 빌드된 이름으로 네임스페이스 를 지정합니다. < network_namespace>/<network_name>.

   3

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

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

   Copy to Clipboard Toggle word wrap

   $ 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:
           name: <storage_class>
     provider:
       source:
         name: <source_provider>
         namespace: <namespace>
       destination:
         name: <destination_provider>
         namespace: <namespace>
   EOF

   1

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

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

   Copy to Clipboard Toggle word wrap

   $  cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Hook
   metadata:
     name: <hook>
     namespace: <namespace>
   spec:
     image: quay.io/konveyor/hook-runner
     playbook: |
       LS0tCi0gbmFtZTogTWFpbgogIGhvc3RzOiBsb2NhbGhvc3QKICB0YXNrczoKICAtIG5hbWU6IExv
       YWQgUGxhbgogICAgaW5jbHVkZV92YXJzOgogICAgICBmaWxlOiAiL3RtcC9ob29rL3BsYW4ueW1s
       IgogICAgICBuYW1lOiBwbGFuCiAgLSBuYW1lOiBMb2FkIFdvcmtsb2FkCiAgICBpbmNsdWRlX3Zh
       cnM6CiAgICAgIGZpbGU6ICIvdG1wL2hvb2svd29ya2xvYWQueW1sIgogICAgICBuYW1lOiB3b3Jr
       bG9hZAoK
   EOF

   다음과 같습니다.

   Playbook은 선택적 Base64로 인코딩된 Ansible 플레이북을 나타냅니다. 플레이북을 지정하는 경우 이미지는 hook-runner 여야 합니다.

   참고

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

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

   Copy to Clipboard Toggle word wrap

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

   1

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

   2

   
       network: 

   3

   
         name: <network_map> 

   4

   
         namespace: <namespace>
       storage: 

   5

   
         name: <storage_map> 

   6

   
         namespace: <namespace>
     targetNamespace: <target_namespace>
     vms:
       - name: <source_vm>
         namespace: <namespace>
         hooks: 

   7

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

   8

   
             step: <step> 

   9

   
   EOF

   1

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

   2

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

   3

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

   4

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

   5

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

   6

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

   7

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

   8

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

   9

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

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

   Copy to Clipboard Toggle word wrap

   $ 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

   참고

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

프로세스

1. Validation Pod의 터미널에 연결합니다.

   Copy to Clipboard Toggle word wrap

   $ oc rsh <validation_pod>

2. 공급자의 OPA 정책 디렉터리로 이동합니다.

   Copy to Clipboard Toggle word wrap

   $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider> 

   1

   1

   vmware 또는 ovirt 를 지정합니다.

3. 기본 정책을 검색합니다.

   Copy to Clipboard Toggle word wrap

   $ grep -R "default" *

프로세스

1. 다음 예에 따라 구성 맵 CR을 생성합니다.

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: <forklift-validation-config>
     namespace: openshift-mtv
   data:
     vmware_multiple_disks.rego: |-
       package <provider_package> 

   1

   
   
       has_multiple_disks { 

   2

   
         count(input.disks) > 1
       }
   
       concerns[flag] {
         has_multiple_disks 

   3

   
           flag := {
             "category": "<Information>", 

   4

   
             "label": "Multiple disks detected",
             "assessment": "Multiple disks detected on this VM."
           }
       }
   EOF

   1

   공급자 패키지 이름을 지정합니다. 허용되는 값은 VMware의 경우 io.konveyor.forklift.vmware 및 Red Hat Virtualization의 경우 io.konveyor.forklift.ovirt 입니다.

   2

   concerns 이름 및 Rego 쿼리를 지정합니다.

   3

   concerns name 및 flag 매개변수 값을 지정합니다.

   4

   허용되는 값은 Critical,Warning 및 Information 입니다.

2. forklift-controller 배포를 0 으로 스케일링하여 Validation Pod를 중지합니다.

   Copy to Clipboard Toggle word wrap

   $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller

3. forklift-controller 배포를 1 로 확장하여 Validation Pod를 시작합니다.

   Copy to Clipboard Toggle word wrap

   $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller

4. Validation Pod 로그를 확인하여 Pod가 시작되었는지 확인합니다.

   Copy to Clipboard Toggle word wrap

   $ oc logs -f <validation_pod>

   사용자 정의 규칙이 기본 규칙과 충돌하면 Validation Pod가 시작되지 않습니다.

5. 소스 공급자를 제거합니다.

   Copy to Clipboard Toggle word wrap

   $ oc delete provider <provider> -n openshift-mtv

6. 소스 공급자를 추가하여 새 규칙을 적용합니다.

   Copy to Clipboard Toggle word wrap

   $ cat << EOF | oc apply -f -
   apiVersion: forklift.konveyor.io/v1beta1
   kind: Provider
   metadata:
     name: <provider>
     namespace: openshift-mtv
   spec:
     type: <provider_type> 

   1

   
     url: <api_end_point> 

   2

   
     secret:
       name: <secret> 

   3

   
       namespace: openshift-mtv
   EOF

   1

   허용되는 값은 ovirt,vsphere, openstack 입니다.

   2

   API 엔드포인트 URL을 지정합니다(예: vSphere의 경우 https://<vCenter_host>/sdk, RHV의 경우 https://<engine_host>/ovirt-engine/api 또는 OpenStack의 경우 https://<identity_service>/v 3).

   3

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

프로세스

1. 현재 규칙 버전을 검색합니다.

   Copy to Clipboard Toggle word wrap

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 

   1

   출력 예

   Copy to Clipboard Toggle word wrap

   {
      "result": {
          "rules_version": 5
      }
   }

2. Validation Pod의 터미널에 연결합니다.

   Copy to Clipboard Toggle word wrap

   $ oc rsh <validation_pod>

3. /usr/share/opa/policies/io/konveyor/forklift/<provider>/rules_version.rego 파일에서 규칙 버전을 업데이트합니다.
4. Validation Pod 터미널에서 로그아웃합니다.

5. 업데이트된 규칙 버전을 확인합니다.

   Copy to Clipboard Toggle word wrap

   $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version 

   1

   출력 예

   Copy to Clipboard Toggle word wrap

   {
      "result": {
          "rules_version": 6
      }
   }