Red Hat Summit Red Hat Summit지원콘솔개발자평가판 시작연락처

가상 머신을 Red Hat OpenShift Virtualization으로 마이그레이션

Migration Toolkit for Virtualization 2.10

Migration Toolkit for Virtualization을 사용하여 VMware vSphere, Red Hat Virtualization 또는 OpenStack 플랫폼 또는 기타 플랫폼에서 Red Hat OpenShift Virtualization으로 가상 머신 마이그레이션

Red Hat Modernization and Migration Documentation Team

초록

Red Hat OpenShift 웹 콘솔 또는 명령줄 인터페이스에서 MCP(Migration Toolkit for Virtualization) 사용자 인터페이스를 사용하여 마이그레이션 계획을 실행합니다.

1장. 마이그레이션 수행
링크 복사

MCP(Migration Toolkit for Virtualization)를 사용하여 마이그레이션을 계획하면 다음 소스 공급자에서 OpenShift Virtualization 대상 공급자로 가상 머신을 마이그레이션할 수 있습니다.

  • VMware vSphere
  • RHV(Red Hat Virtualization)
  • OpenStack
  • VMware vSphere에서 생성한 오픈 가상 어플라이언스(OVA)
  • 원격 OpenShift Virtualization 클러스터

2장. VMware vSphere에서 마이그레이션
링크 복사

MTV UI 또는 명령행에서 VMware 마이그레이션 계획을 실행합니다.

2.1. 사전 요구 사항
링크 복사

  • VMware vSphere에서 마이그레이션을 계획했습니다.

2.2. MTV UI에서 마이그레이션 계획 실행
링크 복사

마이그레이션 계획을 실행하고 Red Hat OpenShift 웹 콘솔에서 진행 상황을 볼 수 있습니다.

사전 요구 사항

  • 유효한 마이그레이션 계획.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

    계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태, 마이그레이션이 시작된 날짜, 각 계획에 대한 설명이 표시됩니다.

  2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

  3. 열리는 확인 창에서 시작을 클릭합니다.

    계획의 상태가 Running 으로 변경되고 마이그레이션의 진행 상황이 표시됩니다.

    웜 마이그레이션만 해당:

    • 사전 복사 단계가 시작됩니다.

    • 컷오버 를 클릭하여 마이그레이션을 완료합니다.

      주의

      마이그레이션을 시작한 후 VM의 스냅샷을 찍지 마십시오. 마이그레이션이 시작된 후 스냅 샷을 수행하면 마이그레이션이 실패할 수 있습니다.

  4. 선택 사항: 마이그레이션 상태 링크를 클릭하여 전체 상태 및 각 VM의 상태를 확인합니다.

    • 왼쪽의 링크는 마이그레이션이 실패, 성공 또는 진행 중인지를 나타냅니다. 또한 마이그레이션이 성공, 실패 또는 취소된 VM 수를 보고합니다.

    • 오른쪽에 있는 링크는 계획 세부 정보 페이지의 가상 머신 탭을 엽니다. 각 VM마다 탭에 다음 데이터가 표시됩니다.

      • VM의 이름
      • 마이그레이션의 시작 및 종료 시간
      • 복사한 데이터 양

      • VM 마이그레이션을 위한 진행률 파이프라인

        주의

        데이터 손상을 방지하기 위해 가져오는 VM에 대해 svMotion 및 재배치를 포함한 vMotion을 비활성화해야 합니다.

  5. 선택 사항: 실행 중이거나 완료된 후 마이그레이션의 로그를 보려면 다음 작업을 수행합니다.

    1. 가상 머신 탭을 클릭합니다.

    2. 확인할 마이그레이션 진행 중인 가상 머신의 왼쪽에 있는 화살표( > )를 클릭합니다.

      VM 세부 정보가 표시됩니다.

    3. Pods 섹션의 Pod 링크 열에서 로그 링크를 클릭합니다.

      로그 탭이 열립니다.

      참고

      로그를 항상 사용할 수 있는 것은 아닙니다. 다음은 로그를 사용할 수 없는 일반적인 이유입니다.

      • 마이그레이션은 OpenShift Virtualization에서 OpenShift Virtualization으로 수행됩니다. 이 경우 virt-v2v 가 포함되어 있지 않으므로 Pod가 필요하지 않습니다.
      • Pod가 생성되지 않았습니다.
      • Pod가 삭제되었습니다.
      • Pod를 실행하기 전에 마이그레이션이 실패했습니다.
    4. 원시 로그를 보려면 Raw 링크를 클릭합니다.
    5. 로그를 다운로드하려면 다운로드 링크를 클릭합니다.

2.2.1. 마이그레이션 계획 옵션
링크 복사

Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 마이그레이션 계획 옆에 있는 옵션 메뉴 kebab 를 클릭하여 다음 옵션에 액세스할 수 있습니다.

  • Edit Plan: 마이그레이션 계획의 세부 정보를 편집합니다. 계획이 실행 중이거나 성공적으로 완료된 경우 다음 옵션을 편집할 수 없습니다.

    • 계획 세부 정보 페이지의 설정 섹션에 있는 모든 속성입니다. 예를 들어, 웜 또는 콜드 마이그레이션, 대상 네임스페이스, 보존된 고정 IP입니다.
    • 매핑 탭의 계획 매핑입니다.
    • 후크 탭에 나열된 후크 입니다.
  • Start migration: 관련 경우에만 활성화됩니다.
  • 재시작 마이그레이션: 중단된 마이그레이션을 다시 시작합니다. 이 옵션을 선택하기 전에 오류 메시지가 없는지 확인합니다. 있는 경우 계획을 편집해야 합니다.

  • 컷오버: warm 마이그레이션만 가능합니다. 관련 경우에만 활성화됩니다. 컷오버 를 클릭하면 다음 옵션을 지원하는 컷오버 창이 열립니다.

    • 설정 컷오버: 컷오버의 날짜와 시간을 설정합니다.
    • Remove cutover: 예약된 컷오버를 취소합니다. 관련 경우에만 활성화됩니다.

  • 중복 계획: 기존 계획과 동일한 VM(가상 머신), 매개변수, 매핑 및 후크를 사용하여 새 마이그레이션 계획을 생성합니다. 이 기능을 다음 작업에 사용할 수 있습니다.

    • VM을 다른 네임스페이스로 마이그레이션합니다.
    • 아카이브된 마이그레이션 계획을 편집합니다.
    • 다른 상태로 마이그레이션 계획을 편집합니다(예: 실패, 취소, 실행 중, 중요 또는 준비됨).

  • 아카이브 계획: 마이그레이션 계획의 로그, 기록 및 메타데이터를 삭제합니다. 계획을 편집하거나 다시 시작할 수 없습니다. 보기, 중복 또는 삭제만 수행할 수 있습니다.

    참고

    아카이브 계획은 되돌릴 수 없습니다. 그러나 보관된 계획을 복제할 수 있습니다.

  • 계획 삭제: 마이그레이션 계획을 영구적으로 제거합니다. 실행 중인 마이그레이션 계획을 삭제할 수 없습니다.

    참고

    삭제 계획은 되돌릴 수 없습니다.

    마이그레이션 계획을 삭제해도 임시 리소스는 제거되지 않습니다. 임시 리소스를 제거하려면 먼저 계획을 삭제하기 전에 보관합니다.

    참고

    마이그레이션 계획 보관 및 삭제 결과는 CLI 또는 UI를 사용하여 계획 및 스토리지 및 네트워크 매핑을 만들었는지에 따라 다릅니다.

    • UI를 사용하여 생성한 경우 마이그레이션 계획 및 해당 매핑이 더 이상 UI에 표시되지 않습니다.
    • CLI를 사용하여 생성한 경우에도 매핑이 여전히 UI에 표시될 수 있습니다. CLI의 매핑은 둘 이상의 마이그레이션 계획에서 사용할 수 있지만 UI에서 생성된 매핑은 하나의 마이그레이션 계획에서만 사용할 수 있기 때문입니다.

2.2.2. 마이그레이션 취소
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획이 진행되는 동안 일부 또는 모든 VM(가상 머신)의 마이그레이션을 취소할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
  2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
  3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

  4. 예, 취소 를 클릭하여 취소를 확인합니다.

    VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

마이그레이션 계획 페이지의 마이그레이션 계획 옆에 있는 재시작 을 클릭하여 취소된 마이그레이션 을 다시 시작할 수 있습니다.

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

CLI(명령줄 인터페이스)를 사용하여 VMware vSphere 소스 공급자에서 마이그레이션할 수 있습니다.

중요

안티바이러스 소프트웨어는 마이그레이션이 실패할 수 있습니다. 마이그레이션을 시작하기 전에 소스 VM에서 이러한 소프트웨어를 제거하는 것이 좋습니다.

중요

MTV는 VMware NVMe(Non-Volatile Memory Express) 디스크 마이그레이션을 지원하지 않습니다.

참고

공유 디스크가 있는 VM(가상 머신)을 마이그레이션하려면 공유 디스크가 있는 가상 머신 마이그레이션을 참조하십시오.

사전 요구 사항

  • UDN(사용자 정의 네트워크)을 사용하는 경우 OpenShift Virtualization에 정의된 네임스페이스 이름을 기록해 둡니다.

프로세스

  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 ).

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

    $ 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의 이름을 지정합니다.

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

    $ 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 주소를 지정합니다.

  1. 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에 정의됩니다.

  1. 소스 및 대상 스토리지를 매핑하는 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 검색을 참조하십시오.

  2. 선택 사항: 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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

  1. 다음 명령을 입력하여 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

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

    $ 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 
    
  targetNamespace: <target_namespace>
  useCompatibilityMode: true
    13 
    
  volumeNameTemplate: <volume_name_template>
    14 
    
  vms:
    15 
    
    - id: <source_vm1>
    16 
    
    - name: <source_vm2>
      networkNameTemplate: <network_interface_template_for_this_vm>
    17 
    
      pvcNameTemplate: <pvc_name_template_for_this_vm>
    18 
    
      volumeNameTemplate: <volume_name_template_for_this_vm>
    19 
    
      targetName: <target_name>
    20 
    
      hooks:
    21 
    
        - hook:
            namespace: <namespace>
            name: <hook>
    22 
    
          step: <step>
    23 
    

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자를 초과할 수 없습니다. 이 규칙은 네트워크 이름 네트워크 템플릿, PVC 이름 템플릿, VM 이름 템플릿 및 볼륨 이름 템플릿에 적용됩니다.

    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
    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에 이미 설치되어 있는지 확인합니다.
    14
    선택 사항: 계획에 있는 VM의 볼륨 인터페이스 이름에 대한 템플릿을 지정합니다. 템플릿은 Go 템플릿 구문을 따르며 다음 변수에 액세스할 수 있습니다.
    • .PVCName: 이 볼륨을 사용하여 VM에 마운트된 PVC의 이름입니다.

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

      예

    • "disk-{{.VolumeIndex}}"
    • "pvc-{{.PVCName}}"
    15
    id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다. UDN을 사용하는 경우 공급자의 IP 주소가 UDN 서브넷 외부에 있는지 확인합니다. IP 주소가 UDN 서브넷 내에 있으면 마이그레이션이 실패합니다.
    16
    VMware vSphere VM moRef를 지정합니다. moRef를 검색하려면 VMware vSphere moRef 검색을 참조하십시오.
    17
    선택 사항: 특정 VM의 네트워크 인터페이스 이름을 지정합니다. spec:networkNameTemplate 에 설정된 값을 재정의합니다. 호출 9에서 와 같이 변수 및 예제 .
    18
    선택 사항: 특정 VM의 PVC 이름을 지정합니다. spec:pvcNameTemplate 에 설정된 값을 재정의합니다. 호출기 10에서 와 같이 변수 및 예제입니다.
    19
    선택 사항: 특정 VM의 볼륨 이름을 지정합니다. spec:volumeNameTemplate 에 설정된 값을 재정의합니다. 호출 14에서 와 같은 변수 및 예제입니다.
    20
    선택 사항: MTV는 대상 VM의 이름을 자동으로 생성합니다. 이 매개변수를 사용하고 새 이름을 입력하여 이 이름을 재정의할 수 있습니다. 입력한 이름은 고유해야 하며 유효한 Kubernetes 하위 도메인이어야 합니다. 그러지 않으면 마이그레이션이 자동으로 실패합니다.
    21
    선택 사항: VM에 대해 최대 두 개의 후크를 지정합니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.
    22
    Hook CR의 이름을 지정합니다.
    23
    허용되는 값은 마이그레이션 계획이 시작되기 전에 Pre Hook 또는 마이그레이션이 완료된 후 postHook입니다.
    중요

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

  3. 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 ).

중요

forklift-controller 가 지속적으로 마이그레이션 계획을 조정하지 못하고 나중에 HTTP 500 오류를 반환하는 데 문제가 있습니다. 이 문제는 VM(가상 머신)에서만 사용자 권한을 지정할 때 발생합니다.

MTV에서는 VM에서 사용하는 스토리지, 네트워크, 스위치 등을 포함하는 데이터 센터 수준에서 권한을 추가해야 합니다. 그런 다음 사용 권한을 자식 요소에 전파해야 합니다.

이 수준의 권한을 추가하지 않으려면 필요한 VM 호스트의 각 오브젝트에 권한을 수동으로 추가해야 합니다.

2.3.1. VMware vSphere moRef 검색
링크 복사

명령줄에서 MCP(Migration Toolkit for Virtualization)를 사용하여 VMware vSphere 소스 공급자가 있는 VM을 마이그레이션하는 경우 vSphere의 특정 엔티티(데이터 저장소, 네트워크 및 VM)의 관리 오브젝트 참조(moRef)를 알아야 합니다.

인벤토리 서비스에서 하나 이상의 vSphere 엔티티의 moRef를 검색할 수 있습니다. 그런 다음 각 moRef를 다른 엔티티의 moRef를 검색하기 위한 참조로 사용할 수 있습니다.

프로세스

  1. 프로젝트의 경로를 검색합니다. 

    oc get route -n openshift-mtv
    Copy to Clipboard Toggle word wrap

  2. 인벤토리 서비스 경로를 검색합니다. 

    $ oc get route <inventory_service> -n openshift-mtv
    Copy to Clipboard Toggle word wrap

  3. 액세스 토큰을 검색합니다. 

    $ TOKEN=$(oc whoami -t)
    Copy to Clipboard Toggle word wrap

  4. VMware vSphere 공급자의 moRef를 검색합니다. 

    $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/vsphere -k
    Copy to Clipboard Toggle word wrap

  5. VMware vSphere 소스 공급자의 데이터 저장소를 검색합니다. 

    $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/vsphere/<provider id>/datastores/ -k
    Copy to Clipboard Toggle word wrap

    출력 예

    [
  {
    "id": "datastore-11",
    "parent": {
      "kind": "Folder",
      "id": "group-s5"
    },
    "path": "/Datacenter/datastore/v2v_general_porpuse_ISCSI_DC",
    "revision": 46,
    "name": "v2v_general_porpuse_ISCSI_DC",
    "selfLink": "providers/vsphere/01278af6-e1e4-4799-b01b-d5ccc8dd0201/datastores/datastore-11"
  },
  {
    "id": "datastore-730",
    "parent": {
      "kind": "Folder",
      "id": "group-s5"
    },
    "path": "/Datacenter/datastore/f01-h27-640-SSD_2",
    "revision": 46,
    "name": "f01-h27-640-SSD_2",
    "selfLink": "providers/vsphere/01278af6-e1e4-4799-b01b-d5ccc8dd0201/datastores/datastore-730"
  },
 ...
    Copy to Clipboard Toggle word wrap

이 예에서 데이터 저장소 v2v_general_porpuse_ISCSI_DC 의 moRef는 datastore-11 이고 데이터 저장소 f01-h27-640-SSD_2 의 moRef는 datastore-730 입니다.

2.3.2. 공유 디스크를 사용하여 가상 머신 마이그레이션
링크 복사

MTV(Migration Toolkit for Virtualization)를 사용하여 공유 디스크가 있는 VMware VM(가상 머신)을 마이그레이션할 수 있습니다. 이 기능은 콜드 마이그레이션에서만 사용할 수 있으며 공유 부팅 디스크에는 사용할 수 없습니다.

공유 디스크는 두 개 이상의 VM에 연결되어 있으며 다중 쓰기기 옵션을 사용하는 디스크입니다. 이러한 특성으로 인해 공유 디스크가 마이그레이션하기 어렵습니다.

특정 상황에서 VM의 애플리케이션에는 공유 디스크가 필요합니다. 데이터베이스 및 클러스터형 파일 시스템은 공유 디스크의 주요 사용 사례입니다.

MTV 버전 2.7.11 이상에는 다음과 같이 MTV를 공유 디스크를 마이그레이션하거나 마이그레이션 중에 건너뛰도록 MTV에 지시하는 Plan CR(사용자 정의 리소스)에서 migrateSharedDisks 라는 매개변수가 포함되어 있습니다.

  • true 로 설정하면 MTV가 공유 디스크를 마이그레이션합니다. MTV는 virt-v2v 를 사용한 일반 콜드 마이그레이션 흐름을 사용하고 공유 PVC(영구 볼륨 클레임) 레이블을 지정합니다.
  • false 로 설정하면 MTV가 공유 디스크를 건너뜁니다. MTV는 디스크 전송을 위해 KubeVirt Containerized-Data-Importer(CDI)를 사용합니다.

디스크 전송 후 MTV는 이미 공유된 PVC와 이미 마이그레이션된 공유 디스크를 자동으로 찾아서 VM에 연결합니다.

기본적으로 migrateSharedDisks 는 true 로 설정됩니다.

공유 디스크를 사용하여 VM을 성공적으로 마이그레이션하려면 다음과 같이 두 가지 Plan CR을 생성합니다.

  • 첫 번째 단계에서는 migrateSharedDisks 를 true 로 설정합니다.

    MTV는 다음을 마이그레이션합니다.

    • 모든 공유 디스크입니다.
    • 각 공유 디스크에 대해 연결된 VM 중 하나입니다. 가능한 경우 둘 이상의 VM에 연결된 공유 디스크가 계획에 포함되지 않도록 VM을 선택합니다. 추가 지침은 다음 자료를 참조하십시오.
    • 이 계획에 대해 선택한 VM에 연결된 모든 공유되지 않은 디스크입니다.

  • 두 번째에서는 migrateSharedDisks 를 false 로 설정합니다.

    MTV는 다음을 마이그레이션합니다.

    • 기타 모든 VM.
    • 두 번째 Plan CR에 있는 VM의 공유되지 않은 디스크입니다.

MTV가 공유 디스크가 있는 VM을 마이그레이션하면 해당 공유 디스크가 이미 마이그레이션되었는지 확인하지 않습니다. 따라서 두 개의 각각에 VM을 할당하여 각 공유 디스크가 한 번만 마이그레이션되도록 하는 것이 중요합니다.

각 Plan CR에 VM 및 공유 디스크를 할당하는 방법을 이해하려면 다음 두 가지 숫자를 고려하십시오. 둘 다에서 plan1 에 대해 migrateSharedDisks 가 true 로 설정되고 plan2 에서는 false 로 설정됩니다.

첫 번째 그림에서 VM 및 공유 디스크가 올바르게 할당됩니다.

그림 2.1. VM 및 공유 디스크가 올바르게 할당된 예

성공적인 마이그레이션의 예
View larger image
성공적인 마이그레이션의 예

plan1 은 VM 2 및 4를 공유 디스크 1, 2, 3, VM 2 및 4의 비공유 디스크를 마이그레이션합니다. VM 2 및 4는 각각 한 번 모든 공유 디스크에 연결되므로 이 계획에 포함됩니다.

plan2 는 VM 1 및 3과 비공유 디스크를 마이그레이션합니다. plan2 는 migrateSharedDisks 가 false 로 설정되어 있기 때문에 VM 1 및 3에 연결된 공유 디스크를 마이그레이션하지 않습니다.

MTV는 다음과 같이 각 VM 및 해당 디스크를 마이그레이션합니다.

  1. plan1 에서 :

    1. VM 3, 공유 디스크 1 및 2 및 VM 3에 연결된 비공유 디스크입니다.
    2. VM 4, 공유 디스크 3 및 VM 4에 연결된 비공유 디스크입니다.

  2. plan2 에서 다음을 수행합니다.

    1. VM 1 및 비공유 디스크가 연결되어 있습니다.
    2. VM 2 및 비공유 디스크가 연결되어 있습니다.

그 결과 VM 2 및 4가 모든 공유 디스크와 공유되지 않은 모든 디스크가 마이그레이션되지만 한 번만 마이그레이션됩니다. MTV는 공유 디스크를 포함하여 모든 VM을 해당 디스크에 다시 연결할 수 있습니다.

두 번째 그림에서 VM 및 공유 디스크가 올바르게 할당되지 않습니다.

그림 2.2. VM 및 공유 디스크 잘못 할당의 예

복잡한 순환 공유 디스크 종속 항목
View larger image
복잡한 순환 공유 디스크 종속 항목

이 경우 MTV는 각 VM 및 해당 디스크를 다음과 같이 마이그레이션합니다.

  1. plan1 에서 :

    1. VM 2, 공유 디스크 1 및 2 및 VM 2에 연결된 비공유 디스크입니다.
    2. VM 3, 공유 디스크 2 및 3, VM 3에 연결된 공유되지 않은 디스크입니다.

  2. plan2 에서 다음을 수행합니다.

    1. VM 1 및 비공유 디스크가 연결되어 있습니다.
    2. VM 4 및 연결된 비공유 디스크입니다.

이 마이그레이션은 "성공"이지만 문제가 발생합니다. 공유 디스크 2는 첫 번째 Plan CR에 의해 두 번 마이그레이션됩니다. 절차를 따르는 알려진 문제 섹션에서 설명하는 두 가지 해결 방법 중 하나를 사용하여 이 문제를 해결할 수 있습니다.

프로세스

  1. MTV에서 공유 디스크에 대한 마이그레이션 계획, 연결된 최소 VM 수, 해당 VM의 공유되지 않은 디스크를 생성합니다.
  2. VMware 클러스터에서 공유 디스크에 연결된 모든 VM의 전원을 끕니다.
  3. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

  4. 원하는 계획을 선택합니다.

    계획 세부 정보 페이지가 열립니다.

  5. 계획의 YAML 탭을 클릭합니다.

  6. migrateSharedDisks 가 true 로 설정되어 있는지 확인합니다.

    migrateSharedDisks 가 true로 설정된 Plan CR의 예

    apiVersion: forklift.konveyor.io/v1beta1
kind: Plan
 name: transfer-shared-disks
 namespace: openshift-mtv
spec:
 map:
   network:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: NetworkMap
     name: vsphere-7gxbs
     namespace: openshift-mtv
     uid: a3c83db3-1cf7-446a-b996-84c618946362
   storage:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: StorageMap
     name: vsphere-mqp7b
     namespace: openshift-mtv
     uid: 20b43d4f-ded4-4798-b836-7c0330d552a0
 migrateSharedDisks: true
 provider:
   destination:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: Provider
     name: host
     namespace: openshift-mtv
     uid: abf4509f-1d5f-4ff6-b1f2-18206136922a
   source:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: Provider
     name: vsphere
     namespace: openshift-mtv
     uid: be4dc7ab-fedd-460a-acae-a850f6b9543f
 targetNamespace: openshift-mtv
 vms:
   - id: vm-69
     name: vm-1-with-shared-disks
    Copy to Clipboard Toggle word wrap

  7. 첫 번째 계획의 마이그레이션을 시작하고 완료될 때까지 기다립니다.
  8. 두 번째 Plan CR을 생성하여 다른 모든 VM과 공유되지 않은 디스크를 첫 번째 대상 네임스페이스와 동일한 대상 네임스페이스로 마이그레이션합니다.

  9. Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 새 계획을 선택합니다.

    계획 세부 정보 페이지가 열립니다.

  10. 계획의 YAML 탭을 클릭합니다.

  11. migrateSharedDisks 를 false 로 설정합니다.

    migrateSharedDisks 가 false로 설정된 Plan CR의 예

    apiVersion: forklift.konveyor.io/v1beta1
kind: Plan
 name: skip-shared-disks
 namespace: openshift-mtv
spec:
 map:
   network:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: NetworkMap
     name: vsphere-7gxbs
     namespace: openshift-mtv
     uid: a3c83db3-1cf7-446a-b996-84c618946362
   storage:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: StorageMap
     name: vsphere-mqp7b
     namespace: openshift-mtv
     uid: 20b43d4f-ded4-4798-b836-7c0330d552a0
 migrateSharedDisks: false
 provider:
   destination:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: Provider
     name: host
     namespace: openshift-mtv
     uid: abf4509f-1d5f-4ff6-b1f2-18206136922a
   source:
     apiVersion: forklift.konveyor.io/v1beta1
     kind: Provider
     name: vsphere
     namespace: openshift-mtv
     uid: be4dc7ab-fedd-460a-acae-a850f6b9543f
 targetNamespace: openshift-mtv
 vms:
   - id: vm-71
     name: vm-2-with-shared-disks
    Copy to Clipboard Toggle word wrap

  12. 두 번째 계획의 마이그레이션을 시작하고 완료될 때까지 기다립니다.
  13. 모든 공유 디스크가 마이그레이션 전과 동일한 VM에 연결되어 있고 중복되지 않았는지 확인합니다. 문제가 있는 경우 다음 알려진 문제에 대한 설명을 참조하십시오.

2.3.3. 명령줄 인터페이스에서 마이그레이션 취소
링크 복사

CLI(명령줄 인터페이스)를 사용하여 마이그레이션이 진행되는 동안 전체 마이그레이션 또는 특정 VM(가상 머신) 마이그레이션을 취소할 수 있습니다.

3장. Red Hat Virtualization에서 마이그레이션
링크 복사

MTV UI 또는 명령행에서 Red Hat Virtualization 마이그레이션 계획을 실행합니다.

3.1. 사전 요구 사항
링크 복사

  • 고객님은 Red Hat Virtualization에서 마이그레이션을 계획하셨습니다.

3.2. MTV UI에서 마이그레이션 계획 실행
링크 복사

마이그레이션 계획을 실행하고 Red Hat OpenShift 웹 콘솔에서 진행 상황을 볼 수 있습니다.

사전 요구 사항

  • 유효한 마이그레이션 계획.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

    계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태, 마이그레이션이 시작된 날짜, 각 계획에 대한 설명이 표시됩니다.

  2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

  3. 열리는 확인 창에서 시작을 클릭합니다.

    계획의 상태가 Running 으로 변경되고 마이그레이션의 진행 상황이 표시됩니다.

    웜 마이그레이션만 해당:

    • 사전 복사 단계가 시작됩니다.

    • 컷오버 를 클릭하여 마이그레이션을 완료합니다.

      주의

      마이그레이션을 시작한 후 VM의 스냅샷을 찍지 마십시오. 마이그레이션이 시작된 후 스냅 샷을 수행하면 마이그레이션이 실패할 수 있습니다.

  4. 선택 사항: 마이그레이션 상태 링크를 클릭하여 전체 상태 및 각 VM의 상태를 확인합니다.

    • 왼쪽의 링크는 마이그레이션이 실패, 성공 또는 진행 중인지를 나타냅니다. 또한 마이그레이션이 성공, 실패 또는 취소된 VM 수를 보고합니다.

    • 오른쪽에 있는 링크는 계획 세부 정보 페이지의 가상 머신 탭을 엽니다. 각 VM마다 탭에 다음 데이터가 표시됩니다.

      • VM의 이름
      • 마이그레이션의 시작 및 종료 시간
      • 복사한 데이터 양
      • VM 마이그레이션을 위한 진행률 파이프라인

  5. 선택 사항: 실행 중이거나 완료된 후 마이그레이션의 로그를 보려면 다음 작업을 수행합니다.

    1. 가상 머신 탭을 클릭합니다.

    2. 확인할 마이그레이션 진행 중인 가상 머신의 왼쪽에 있는 화살표( > )를 클릭합니다.

      VM 세부 정보가 표시됩니다.

    3. Pods 섹션의 Pod 링크 열에서 로그 링크를 클릭합니다.

      로그 탭이 열립니다.

      참고

      로그를 항상 사용할 수 있는 것은 아닙니다. 다음은 로그를 사용할 수 없는 일반적인 이유입니다.

      • 마이그레이션은 OpenShift Virtualization에서 OpenShift Virtualization으로 수행됩니다. 이 경우 virt-v2v 가 포함되어 있지 않으므로 Pod가 필요하지 않습니다.
      • Pod가 생성되지 않았습니다.
      • Pod가 삭제되었습니다.
      • Pod를 실행하기 전에 마이그레이션이 실패했습니다.
    4. 원시 로그를 보려면 Raw 링크를 클릭합니다.
    5. 로그를 다운로드하려면 다운로드 링크를 클릭합니다.

3.2.1. 마이그레이션 계획 옵션
링크 복사

Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 마이그레이션 계획 옆에 있는 옵션 메뉴 kebab 를 클릭하여 다음 옵션에 액세스할 수 있습니다.

  • Edit Plan: 마이그레이션 계획의 세부 정보를 편집합니다. 계획이 실행 중이거나 성공적으로 완료된 경우 다음 옵션을 편집할 수 없습니다.

    • 계획 세부 정보 페이지의 설정 섹션에 있는 모든 속성입니다. 예를 들어, 웜 또는 콜드 마이그레이션, 대상 네임스페이스, 보존된 고정 IP입니다.
    • 매핑 탭의 계획 매핑입니다.
    • 후크 탭에 나열된 후크 입니다.
  • Start migration: 관련 경우에만 활성화됩니다.
  • 재시작 마이그레이션: 중단된 마이그레이션을 다시 시작합니다. 이 옵션을 선택하기 전에 오류 메시지가 없는지 확인합니다. 있는 경우 계획을 편집해야 합니다.

  • 컷오버: warm 마이그레이션만 가능합니다. 관련 경우에만 활성화됩니다. 컷오버 를 클릭하면 다음 옵션을 지원하는 컷오버 창이 열립니다.

    • 설정 컷오버: 컷오버의 날짜와 시간을 설정합니다.
    • Remove cutover: 예약된 컷오버를 취소합니다. 관련 경우에만 활성화됩니다.

  • 중복 계획: 기존 계획과 동일한 VM(가상 머신), 매개변수, 매핑 및 후크를 사용하여 새 마이그레이션 계획을 생성합니다. 이 기능을 다음 작업에 사용할 수 있습니다.

    • VM을 다른 네임스페이스로 마이그레이션합니다.
    • 아카이브된 마이그레이션 계획을 편집합니다.
    • 다른 상태로 마이그레이션 계획을 편집합니다(예: 실패, 취소, 실행 중, 중요 또는 준비됨).

  • 아카이브 계획: 마이그레이션 계획의 로그, 기록 및 메타데이터를 삭제합니다. 계획을 편집하거나 다시 시작할 수 없습니다. 보기, 중복 또는 삭제만 수행할 수 있습니다.

    참고

    아카이브 계획은 되돌릴 수 없습니다. 그러나 보관된 계획을 복제할 수 있습니다.

  • 계획 삭제: 마이그레이션 계획을 영구적으로 제거합니다. 실행 중인 마이그레이션 계획을 삭제할 수 없습니다.

    참고

    삭제 계획은 되돌릴 수 없습니다.

    마이그레이션 계획을 삭제해도 임시 리소스는 제거되지 않습니다. 임시 리소스를 제거하려면 먼저 계획을 삭제하기 전에 보관합니다.

    참고

    마이그레이션 계획 보관 및 삭제 결과는 CLI 또는 UI를 사용하여 계획 및 스토리지 및 네트워크 매핑을 만들었는지에 따라 다릅니다.

    • UI를 사용하여 생성한 경우 마이그레이션 계획 및 해당 매핑이 더 이상 UI에 표시되지 않습니다.
    • CLI를 사용하여 생성한 경우에도 매핑이 여전히 UI에 표시될 수 있습니다. CLI의 매핑은 둘 이상의 마이그레이션 계획에서 사용할 수 있지만 UI에서 생성된 매핑은 하나의 마이그레이션 계획에서만 사용할 수 있기 때문입니다.

3.2.2. 마이그레이션 취소
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획이 진행되는 동안 일부 또는 모든 VM(가상 머신)의 마이그레이션을 취소할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
  2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
  3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

  4. 예, 취소 를 클릭하여 취소를 확인합니다.

    VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

마이그레이션 계획 페이지의 마이그레이션 계획 옆에 있는 재시작 을 클릭하여 취소된 마이그레이션 을 다시 시작할 수 있습니다.

3.3. 명령줄에서 Red Hat Virtualization 마이그레이션 실행
링크 복사

CLI(명령줄 인터페이스)를 사용하여 Red Hat Virtualization 소스 공급자에서 마이그레이션할 수 있습니다.

사전 요구 사항

  • UDN(사용자 정의 네트워크)을 사용하는 경우 OpenShift Virtualization에 정의된 네임스페이스 이름을 기록해 둡니다.
  • 직접 LUN 디스크를 사용하여 가상 머신을 마이그레이션하는 경우 OpenShift Virtualization 대상 클러스터의 노드가 백엔드 스토리지에 액세스할 수 있는지 확인합니다.
참고
  • 소스 공급자에서 대상 공급자로 복사 되는 디스크 이미지와 달리 LUN은 소스 공급자의 가상 머신에서분리되지만 제거되지 않은 다음 대상 공급자에 생성된 가상 머신(VM)에 연결됩니다.
  • 소스 공급자에 대한 대체가 필요한 경우 마이그레이션 중에 원본 공급자에서 LUN을 제거하지 않습니다. 그러나 소스 공급자의 VM에 LUN을 다시 연결하기 전에 대상 환경의 VM에서 LUN을 사용하지 않도록 하여 데이터 손상이 발생할 수 있습니다.

프로세스

  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: 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
    Copy to Clipboard Toggle word wrap
    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 ).

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

    $ 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
    Copy to Clipboard Toggle word wrap
    1
    API 끝점의 URL을 지정합니다(예: https://<engine_host>/ovirt-engine/api ).
    2
    공급자 Secret CR의 이름을 지정합니다.

  1. 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 입니다.
    2
    id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다. id 의 경우 RHV 네트워크 UUID(Universal Unique ID)를 지정합니다.
    3
    각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.
    4
    type 이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.
    5
    UDN(사용자 정의 네트워크)을 사용하는 경우 해당 네임스페이스는 OpenShift Virtualization에 정의됩니다.

  1. 소스 및 대상 스토리지를 매핑하는 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_storage_domain>
    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
    RHV 스토리지 도메인 UUID를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다.

  2. 선택 사항: 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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

  1. 다음 명령을 입력하여 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

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

    $ 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_vm1>
    10 
    
    - name: <source_vm2>
      hooks:
    11 
    
        - hook:
            namespace: <namespace>
            name: <hook>
    12 
    
          step: <step>
    13 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    Plan CR의 이름을 지정합니다.
    2
    아래 참고를 참조하십시오.
    3
    마이그레이션이 워밍인지 또는 콜드인지를 지정합니다. 마이그레이션 매니페스트에서 cutover 매개변수 값을 지정하지 않고 웜 마이그레이션 을 지정하면 사전 복사 단계만 실행됩니다.
    4
    계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.
    5
    마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    6
    NetworkMap CR의 이름을 지정합니다.
    7
    마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    8
    StorageMap CR의 이름을 지정합니다.
    9
    id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다. UDN을 사용하는 경우 공급자의 IP 주소가 UDN 서브넷 외부에 있는지 확인합니다. IP 주소가 UDN 서브넷 내에 있으면 마이그레이션이 실패합니다.
    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 모델로 설정됩니다.

  3. 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 ).

3.3.1. 명령줄 인터페이스에서 마이그레이션 취소
링크 복사

CLI(명령줄 인터페이스)를 사용하여 마이그레이션이 진행되는 동안 전체 마이그레이션 또는 특정 VM(가상 머신) 마이그레이션을 취소할 수 있습니다.

4장. OpenStack에서 마이그레이션
링크 복사

MTV UI 또는 명령행에서 OpenStack 마이그레이션 계획을 실행합니다.

4.1. 사전 요구 사항
링크 복사

  • OpenStack에서 마이그레이션을 계획하셨습니다.

4.2. MTV UI에서 마이그레이션 계획 실행
링크 복사

마이그레이션 계획을 실행하고 Red Hat OpenShift 웹 콘솔에서 진행 상황을 볼 수 있습니다.

사전 요구 사항

  • 유효한 마이그레이션 계획.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

    계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태, 마이그레이션이 시작된 날짜, 각 계획에 대한 설명이 표시됩니다.

  2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

  3. 열리는 확인 창에서 시작을 클릭합니다.

    계획의 상태가 Running 으로 변경되고 마이그레이션의 진행 상황이 표시됩니다.

    주의

    마이그레이션을 시작한 후 VM의 스냅샷을 찍지 마십시오. 마이그레이션이 시작된 후 스냅 샷을 수행하면 마이그레이션이 실패할 수 있습니다.

  4. 선택 사항: 마이그레이션 상태 링크를 클릭하여 전체 상태 및 각 VM의 상태를 확인합니다.

    • 왼쪽의 링크는 마이그레이션이 실패, 성공 또는 진행 중인지를 나타냅니다. 또한 마이그레이션이 성공, 실패 또는 취소된 VM 수를 보고합니다.

    • 오른쪽에 있는 링크는 계획 세부 정보 페이지의 가상 머신 탭을 엽니다. 각 VM마다 탭에 다음 데이터가 표시됩니다.

      • VM의 이름
      • 마이그레이션의 시작 및 종료 시간
      • 복사한 데이터 양
      • VM 마이그레이션을 위한 진행률 파이프라인

  5. 선택 사항: 실행 중이거나 완료된 후 마이그레이션의 로그를 보려면 다음 작업을 수행합니다.

    1. 가상 머신 탭을 클릭합니다.

    2. 확인할 마이그레이션 진행 중인 가상 머신의 왼쪽에 있는 화살표( > )를 클릭합니다.

      VM 세부 정보가 표시됩니다.

    3. Pods 섹션의 Pod 링크 열에서 로그 링크를 클릭합니다.

      로그 탭이 열립니다.

      참고

      로그를 항상 사용할 수 있는 것은 아닙니다. 다음은 로그를 사용할 수 없는 일반적인 이유입니다.

      • 마이그레이션은 OpenShift Virtualization에서 OpenShift Virtualization으로 수행됩니다. 이 경우 virt-v2v 가 포함되어 있지 않으므로 Pod가 필요하지 않습니다.
      • Pod가 생성되지 않았습니다.
      • Pod가 삭제되었습니다.
      • Pod를 실행하기 전에 마이그레이션이 실패했습니다.
    4. 원시 로그를 보려면 Raw 링크를 클릭합니다.
    5. 로그를 다운로드하려면 다운로드 링크를 클릭합니다.

4.2.1. 마이그레이션 계획 옵션
링크 복사

Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 마이그레이션 계획 옆에 있는 옵션 메뉴 kebab 를 클릭하여 다음 옵션에 액세스할 수 있습니다.

  • Edit Plan: 마이그레이션 계획의 세부 정보를 편집합니다. 계획이 실행 중이거나 성공적으로 완료된 경우 다음 옵션을 편집할 수 없습니다.

    • 계획 세부 정보 페이지의 설정 섹션에 있는 모든 속성입니다. 예를 들어, 웜 또는 콜드 마이그레이션, 대상 네임스페이스, 보존된 고정 IP입니다.
    • 매핑 탭의 계획 매핑입니다.
    • 후크 탭에 나열된 후크 입니다.
  • Start migration: 관련 경우에만 활성화됩니다.
  • 재시작 마이그레이션: 중단된 마이그레이션을 다시 시작합니다. 이 옵션을 선택하기 전에 오류 메시지가 없는지 확인합니다. 있는 경우 계획을 편집해야 합니다.

  • 컷오버: warm 마이그레이션만 가능합니다. 관련 경우에만 활성화됩니다. 컷오버 를 클릭하면 다음 옵션을 지원하는 컷오버 창이 열립니다.

    • 설정 컷오버: 컷오버의 날짜와 시간을 설정합니다.
    • Remove cutover: 예약된 컷오버를 취소합니다. 관련 경우에만 활성화됩니다.

  • 중복 계획: 기존 계획과 동일한 VM(가상 머신), 매개변수, 매핑 및 후크를 사용하여 새 마이그레이션 계획을 생성합니다. 이 기능을 다음 작업에 사용할 수 있습니다.

    • VM을 다른 네임스페이스로 마이그레이션합니다.
    • 아카이브된 마이그레이션 계획을 편집합니다.
    • 다른 상태로 마이그레이션 계획을 편집합니다(예: 실패, 취소, 실행 중, 중요 또는 준비됨).

  • 아카이브 계획: 마이그레이션 계획의 로그, 기록 및 메타데이터를 삭제합니다. 계획을 편집하거나 다시 시작할 수 없습니다. 보기, 중복 또는 삭제만 수행할 수 있습니다.

    참고

    아카이브 계획은 되돌릴 수 없습니다. 그러나 보관된 계획을 복제할 수 있습니다.

  • 계획 삭제: 마이그레이션 계획을 영구적으로 제거합니다. 실행 중인 마이그레이션 계획을 삭제할 수 없습니다.

    참고

    삭제 계획은 되돌릴 수 없습니다.

    마이그레이션 계획을 삭제해도 임시 리소스는 제거되지 않습니다. 임시 리소스를 제거하려면 먼저 계획을 삭제하기 전에 보관합니다.

    참고

    마이그레이션 계획 보관 및 삭제 결과는 CLI 또는 UI를 사용하여 계획 및 스토리지 및 네트워크 매핑을 만들었는지에 따라 다릅니다.

    • UI를 사용하여 생성한 경우 마이그레이션 계획 및 해당 매핑이 더 이상 UI에 표시되지 않습니다.
    • CLI를 사용하여 생성한 경우에도 매핑이 여전히 UI에 표시될 수 있습니다. CLI의 매핑은 둘 이상의 마이그레이션 계획에서 사용할 수 있지만 UI에서 생성된 매핑은 하나의 마이그레이션 계획에서만 사용할 수 있기 때문입니다.

4.2.2. 마이그레이션 취소
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획이 진행되는 동안 일부 또는 모든 VM(가상 머신)의 마이그레이션을 취소할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
  2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
  3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

  4. 예, 취소 를 클릭하여 취소를 확인합니다.

    VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

마이그레이션 계획 페이지의 마이그레이션 계획 옆에 있는 재시작 을 클릭하여 취소된 마이그레이션 을 다시 시작할 수 있습니다.

4.3. 명령줄에서 OpenStack 마이그레이션 실행
링크 복사

CLI(명령줄 인터페이스)를 사용하여 OpenStack 소스 공급자에서 마이그레이션할 수 있습니다.

사전 요구 사항

  • UDN(사용자 정의 네트워크)을 사용하는 경우 OpenShift Virtualization에 정의된 대로 해당 네임스페이스의 이름을 기록해 둡니다.

프로세스

  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: 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
    Copy to Clipboard Toggle word wrap
    1
    ownerReferences 섹션은 선택 사항입니다.
    2
    OpenStack 사용자를 지정합니다.
    3
    사용자 OpenStack 암호를 지정합니다.
    4
    인증서 확인을 건너뛰려면 "true" 를 지정하고 "false" 를 지정하여 인증서를 확인합니다. 지정하지 않는 경우 기본값은 "false" 입니다. 인증서 확인을 건너뛰면 비보안 마이그레이션이 진행되므로 인증서가 필요하지 않습니다. 비보안 마이그레이션은 전송된 데이터가 안전하지 않은 연결을 통해 전송되고 잠재적으로 민감한 데이터가 노출될 수 있음을 의미합니다.
    5
    이 필드를 설정하지 않고 인증서 확인을 건너뛰면 MTV가 시스템 CA 사용을 시도합니다.
    6
    API 끝점 URL을 지정합니다(예: https://<identity_service>/v3 ).

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

    $ 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
    Copy to Clipboard Toggle word wrap
    1
    API 끝점의 URL을 지정합니다.
    2
    공급자 Secret CR의 이름을 지정합니다.

  1. 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 입니다.
    2
    id 또는 name 매개변수를 사용하여 소스 네트워크를 지정할 수 있습니다. id 는 OpenStack 네트워크 UUID를 지정합니다.
    3
    각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.
    4
    type 이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.
    5
    UDN(사용자 정의 네트워크)을 사용하는 경우 해당 네임스페이스는 OpenShift Virtualization에 정의됩니다.

  1. 소스 및 대상 스토리지를 매핑하는 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_volume_type>
    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
    OpenStack volume_type UUID를 지정합니다. 예를 들면 f2737930-b567-451a-9ceb-2887f6207009 입니다.

  2. 선택 사항: 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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

  1. 다음 명령을 입력하여 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

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

    $ 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_vm1>
    8 
    
    - name: <source_vm2>
      hooks:
    9 
    
        - hook:
            namespace: <namespace>
            name: <hook>
    10 
    
          step: <step>
    11 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    Plan CR의 이름을 지정합니다.
    2
    계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.
    3
    마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    4
    NetworkMap CR의 이름을 지정합니다.
    5
    마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    6
    StorageMap CR의 이름을 지정합니다.
    7
    id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다. UDN을 사용하는 경우 공급자의 IP 주소가 UDN 서브넷 외부에 있는지 확인합니다. IP 주소가 UDN 서브넷 내에 있으면 마이그레이션이 실패합니다.
    8
    OpenStack VM UUID를 지정합니다.
    9
    선택 사항: VM에 대해 최대 두 개의 후크를 지정합니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.
    10
    Hook CR의 이름을 지정합니다.
    11
    허용되는 값은 마이그레이션 계획이 시작되기 전에 PreHook 이거나 마이그레이션이 완료된 후 postHook 입니다.

  3. 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 ).

4.3.1. 명령줄 인터페이스에서 마이그레이션 취소
링크 복사

CLI(명령줄 인터페이스)를 사용하여 마이그레이션이 진행되는 동안 전체 마이그레이션 또는 특정 VM(가상 머신) 마이그레이션을 취소할 수 있습니다.

5장. OVA에서 마이그레이션
링크 복사

MTV UI 또는 명령행에서 OVA 마이그레이션 계획을 실행합니다.

5.1. 사전 요구 사항
링크 복사

  • OVA에서 마이그레이션을 계획했습니다.

5.2. MTV UI에서 마이그레이션 계획 실행
링크 복사

마이그레이션 계획을 실행하고 Red Hat OpenShift 웹 콘솔에서 진행 상황을 볼 수 있습니다.

사전 요구 사항

  • 유효한 마이그레이션 계획.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

    계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태, 마이그레이션이 시작된 날짜, 각 계획에 대한 설명이 표시됩니다.

  2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

  3. 열리는 확인 창에서 시작을 클릭합니다.

    계획의 상태가 Running 으로 변경되고 마이그레이션의 진행 상황이 표시됩니다.

    주의

    마이그레이션을 시작한 후 VM의 스냅샷을 찍지 마십시오. 마이그레이션이 시작된 후 스냅 샷을 수행하면 마이그레이션이 실패할 수 있습니다.

  4. 선택 사항: 마이그레이션 상태 링크를 클릭하여 전체 상태 및 각 VM의 상태를 확인합니다.

    • 왼쪽의 링크는 마이그레이션이 실패, 성공 또는 진행 중인지를 나타냅니다. 또한 마이그레이션이 성공, 실패 또는 취소된 VM 수를 보고합니다.

    • 오른쪽에 있는 링크는 계획 세부 정보 페이지의 가상 머신 탭을 엽니다. 각 VM마다 탭에 다음 데이터가 표시됩니다.

      • VM의 이름
      • 마이그레이션의 시작 및 종료 시간
      • 복사한 데이터 양
      • VM 마이그레이션을 위한 진행률 파이프라인

  5. 선택 사항: 실행 중이거나 완료된 후 마이그레이션의 로그를 보려면 다음 작업을 수행합니다.

    1. 가상 머신 탭을 클릭합니다.

    2. 확인할 마이그레이션 진행 중인 가상 머신의 왼쪽에 있는 화살표( > )를 클릭합니다.

      VM 세부 정보가 표시됩니다.

    3. Pods 섹션의 Pod 링크 열에서 로그 링크를 클릭합니다.

      로그 탭이 열립니다.

      참고

      로그를 항상 사용할 수 있는 것은 아닙니다. 다음은 로그를 사용할 수 없는 일반적인 이유입니다.

      • 마이그레이션은 OpenShift Virtualization에서 OpenShift Virtualization으로 수행됩니다. 이 경우 virt-v2v 가 포함되어 있지 않으므로 Pod가 필요하지 않습니다.
      • Pod가 생성되지 않았습니다.
      • Pod가 삭제되었습니다.
      • Pod를 실행하기 전에 마이그레이션이 실패했습니다.
    4. 원시 로그를 보려면 Raw 링크를 클릭합니다.
    5. 로그를 다운로드하려면 다운로드 링크를 클릭합니다.

5.2.1. 마이그레이션 계획 옵션
링크 복사

Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 마이그레이션 계획 옆에 있는 옵션 메뉴 kebab 를 클릭하여 다음 옵션에 액세스할 수 있습니다.

  • Edit Plan: 마이그레이션 계획의 세부 정보를 편집합니다. 계획이 실행 중이거나 성공적으로 완료된 경우 다음 옵션을 편집할 수 없습니다.

    • 계획 세부 정보 페이지의 설정 섹션에 있는 모든 속성입니다. 예를 들어, 웜 또는 콜드 마이그레이션, 대상 네임스페이스, 보존된 고정 IP입니다.
    • 매핑 탭의 계획 매핑입니다.
    • 후크 탭에 나열된 후크 입니다.
  • Start migration: 관련 경우에만 활성화됩니다.
  • 재시작 마이그레이션: 중단된 마이그레이션을 다시 시작합니다. 이 옵션을 선택하기 전에 오류 메시지가 없는지 확인합니다. 있는 경우 계획을 편집해야 합니다.

  • 컷오버: warm 마이그레이션만 가능합니다. 관련 경우에만 활성화됩니다. 컷오버 를 클릭하면 다음 옵션을 지원하는 컷오버 창이 열립니다.

    • 설정 컷오버: 컷오버의 날짜와 시간을 설정합니다.
    • Remove cutover: 예약된 컷오버를 취소합니다. 관련 경우에만 활성화됩니다.

  • 중복 계획: 기존 계획과 동일한 VM(가상 머신), 매개변수, 매핑 및 후크를 사용하여 새 마이그레이션 계획을 생성합니다. 이 기능을 다음 작업에 사용할 수 있습니다.

    • VM을 다른 네임스페이스로 마이그레이션합니다.
    • 아카이브된 마이그레이션 계획을 편집합니다.
    • 다른 상태로 마이그레이션 계획을 편집합니다(예: 실패, 취소, 실행 중, 중요 또는 준비됨).

  • 아카이브 계획: 마이그레이션 계획의 로그, 기록 및 메타데이터를 삭제합니다. 계획을 편집하거나 다시 시작할 수 없습니다. 보기, 중복 또는 삭제만 수행할 수 있습니다.

    참고

    아카이브 계획은 되돌릴 수 없습니다. 그러나 보관된 계획을 복제할 수 있습니다.

  • 계획 삭제: 마이그레이션 계획을 영구적으로 제거합니다. 실행 중인 마이그레이션 계획을 삭제할 수 없습니다.

    참고

    삭제 계획은 되돌릴 수 없습니다.

    마이그레이션 계획을 삭제해도 임시 리소스는 제거되지 않습니다. 임시 리소스를 제거하려면 먼저 계획을 삭제하기 전에 보관합니다.

    참고

    마이그레이션 계획 보관 및 삭제 결과는 CLI 또는 UI를 사용하여 계획 및 스토리지 및 네트워크 매핑을 만들었는지에 따라 다릅니다.

    • UI를 사용하여 생성한 경우 마이그레이션 계획 및 해당 매핑이 더 이상 UI에 표시되지 않습니다.
    • CLI를 사용하여 생성한 경우에도 매핑이 여전히 UI에 표시될 수 있습니다. CLI의 매핑은 둘 이상의 마이그레이션 계획에서 사용할 수 있지만 UI에서 생성된 매핑은 하나의 마이그레이션 계획에서만 사용할 수 있기 때문입니다.

5.2.2. 마이그레이션 취소
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획이 진행되는 동안 일부 또는 모든 VM(가상 머신)의 마이그레이션을 취소할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
  2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
  3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

  4. 예, 취소 를 클릭하여 취소를 확인합니다.

    VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

마이그레이션 계획 페이지의 마이그레이션 계획 옆에 있는 재시작 을 클릭하여 취소된 마이그레이션 을 다시 시작할 수 있습니다.

5.3. 명령줄에서 OVA(Open Virtual VolumeSnapshot) 마이그레이션 실행
링크 복사

CLI(명령줄 인터페이스)를 사용하여 VMware vSphere에서 소스 공급자로 생성한 OVA(Open Virtual Appliance) 파일에서 마이그레이션할 수 있습니다.

사전 요구 사항

  • UDN(사용자 정의 네트워크)을 사용하는 경우 OpenShift Virtualization에 정의된 네임스페이스 이름을 기록해 둡니다.

프로세스

  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: ova
    createdForResourceType: providers
type: Opaque
stringData:
  url: <nfs_server:/nfs_path>
    2 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    ownerReferences 섹션은 선택 사항입니다.
    2
    여기서: nfs_server 는 공유가 생성된 서버의 IP 또는 호스트 이름이고 nfs_path 는 OVA 파일이 저장된 서버의 경로입니다.

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

    $ 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
    Copy to Clipboard Toggle word wrap
    1
    여기서: nfs_server 는 공유가 생성된 서버의 IP 또는 호스트 이름이고 nfs_path 는 OVA 파일이 저장된 서버의 경로입니다.
    2
    공급자 Secret CR의 이름을 지정합니다.

  1. 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:
        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>
    5 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    허용되는 값은 pod 및 multus 입니다.
    2
    OVA 네트워크 UUID(Universal Unique ID)를 지정합니다.
    3
    각 추가 OpenShift Virtualization 네트워크에 대한 네트워크 연결 정의를 지정합니다.
    4
    type 이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.
    5
    UDN(사용자 정의 네트워크)을 사용하는 경우 해당 네임스페이스는 OpenShift Virtualization에 정의됩니다.

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

  2. 선택 사항: 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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

  1. 다음 명령을 입력하여 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

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

    $ 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_vm1>
    8 
    
    - name: <source_vm2>
      hooks:
    9 
    
        - hook:
            namespace: <namespace>
            name: <hook>
    10 
    
          step: <step>
    11 
    
EOF
    Copy to Clipboard Toggle word wrap
    1
    Plan CR의 이름을 지정합니다.
    2
    계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.
    3
    마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    4
    NetworkMap CR의 이름을 지정합니다.
    5
    마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    6
    StorageMap CR의 이름을 지정합니다.
    7
    id 또는 name 매개변수를 사용하여 소스 VM을 지정할 수 있습니다. UDN을 사용하는 경우 공급자의 IP 주소가 UDN 서브넷 외부에 있는지 확인합니다. IP 주소가 UDN 서브넷 내에 있으면 마이그레이션이 실패합니다.
    8
    OVA VM UUID를 지정합니다.
    9
    선택 사항: VM에 대해 최대 두 개의 후크를 지정할 수 있습니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.
    10
    Hook CR의 이름을 지정합니다.
    11
    허용되는 값은 마이그레이션 계획이 시작되기 전에 PreHook 이거나 마이그레이션이 완료된 후 postHook 입니다.

  3. 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 ).

5.3.1. 명령줄 인터페이스에서 마이그레이션 취소
링크 복사

CLI(명령줄 인터페이스)를 사용하여 마이그레이션이 진행되는 동안 전체 마이그레이션 또는 특정 VM(가상 머신) 마이그레이션을 취소할 수 있습니다.

6장. OpenShift Virtualization에서 마이그레이션
링크 복사

MTV UI 또는 명령행에서 OpenShift Virtualization 마이그레이션 계획을 실행합니다.

6.1. 사전 요구 사항
링크 복사

  • OpenShift Virtualization에서 마이그레이션을 계획했습니다.

6.2. MTV UI에서 마이그레이션 계획 실행
링크 복사

마이그레이션 계획을 실행하고 Red Hat OpenShift 웹 콘솔에서 진행 상황을 볼 수 있습니다.

사전 요구 사항

  • 유효한 마이그레이션 계획.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 > 가상화 계획을 클릭합니다.

    계획 목록에는 소스 및 대상 공급자, 마이그레이션 중인 VM(가상 머신) 수, 상태, 마이그레이션이 시작된 날짜, 각 계획에 대한 설명이 표시됩니다.

  2. 마이그레이션 계획 옆에 있는 시작을 클릭하여 마이그레이션을 시작합니다.

  3. 열리는 확인 창에서 시작을 클릭합니다.

    계획의 상태가 Running 으로 변경되고 마이그레이션의 진행 상황이 표시됩니다.

    주의

    마이그레이션을 시작한 후 VM의 스냅샷을 찍지 마십시오. 마이그레이션이 시작된 후 스냅 샷을 수행하면 마이그레이션이 실패할 수 있습니다.

  4. 선택 사항: 마이그레이션 상태 링크를 클릭하여 전체 상태 및 각 VM의 상태를 확인합니다.

    • 왼쪽의 링크는 마이그레이션이 실패, 성공 또는 진행 중인지를 나타냅니다. 또한 마이그레이션이 성공, 실패 또는 취소된 VM 수를 보고합니다.

    • 오른쪽에 있는 링크는 계획 세부 정보 페이지의 가상 머신 탭을 엽니다. 각 VM마다 탭에 다음 데이터가 표시됩니다.

      • VM의 이름
      • 마이그레이션의 시작 및 종료 시간
      • 복사한 데이터 양
      • VM 마이그레이션을 위한 진행률 파이프라인

  5. 선택 사항: 실행 중이거나 완료된 후 마이그레이션의 로그를 보려면 다음 작업을 수행합니다.

    1. 가상 머신 탭을 클릭합니다.

    2. 확인할 마이그레이션 진행 중인 가상 머신의 왼쪽에 있는 화살표( > )를 클릭합니다.

      VM 세부 정보가 표시됩니다.

    3. Pods 섹션의 Pod 링크 열에서 로그 링크를 클릭합니다.

      로그 탭이 열립니다.

      참고

      로그를 항상 사용할 수 있는 것은 아닙니다. 다음은 로그를 사용할 수 없는 일반적인 이유입니다.

      • 마이그레이션은 OpenShift Virtualization에서 OpenShift Virtualization으로 수행됩니다. 이 경우 virt-v2v 가 포함되어 있지 않으므로 Pod가 필요하지 않습니다.
      • Pod가 생성되지 않았습니다.
      • Pod가 삭제되었습니다.
      • Pod를 실행하기 전에 마이그레이션이 실패했습니다.
    4. 원시 로그를 보려면 Raw 링크를 클릭합니다.
    5. 로그를 다운로드하려면 다운로드 링크를 클릭합니다.

6.2.1. 마이그레이션 계획 옵션
링크 복사

Red Hat OpenShift 웹 콘솔의 가상화 계획 페이지에서 마이그레이션 계획 옆에 있는 옵션 메뉴 kebab 를 클릭하여 다음 옵션에 액세스할 수 있습니다.

  • Edit Plan: 마이그레이션 계획의 세부 정보를 편집합니다. 계획이 실행 중이거나 성공적으로 완료된 경우 다음 옵션을 편집할 수 없습니다.

    • 계획 세부 정보 페이지의 설정 섹션에 있는 모든 속성입니다. 예를 들어, 웜 또는 콜드 마이그레이션, 대상 네임스페이스, 보존된 고정 IP입니다.
    • 매핑 탭의 계획 매핑입니다.
    • 후크 탭에 나열된 후크 입니다.
  • Start migration: 관련 경우에만 활성화됩니다.
  • 재시작 마이그레이션: 중단된 마이그레이션을 다시 시작합니다. 이 옵션을 선택하기 전에 오류 메시지가 없는지 확인합니다. 있는 경우 계획을 편집해야 합니다.

  • 컷오버: warm 마이그레이션만 가능합니다. 관련 경우에만 활성화됩니다. 컷오버 를 클릭하면 다음 옵션을 지원하는 컷오버 창이 열립니다.

    • 설정 컷오버: 컷오버의 날짜와 시간을 설정합니다.
    • Remove cutover: 예약된 컷오버를 취소합니다. 관련 경우에만 활성화됩니다.

  • 중복 계획: 기존 계획과 동일한 VM(가상 머신), 매개변수, 매핑 및 후크를 사용하여 새 마이그레이션 계획을 생성합니다. 이 기능을 다음 작업에 사용할 수 있습니다.

    • VM을 다른 네임스페이스로 마이그레이션합니다.
    • 아카이브된 마이그레이션 계획을 편집합니다.
    • 다른 상태로 마이그레이션 계획을 편집합니다(예: 실패, 취소, 실행 중, 중요 또는 준비됨).

  • 아카이브 계획: 마이그레이션 계획의 로그, 기록 및 메타데이터를 삭제합니다. 계획을 편집하거나 다시 시작할 수 없습니다. 보기, 중복 또는 삭제만 수행할 수 있습니다.

    참고

    아카이브 계획은 되돌릴 수 없습니다. 그러나 보관된 계획을 복제할 수 있습니다.

  • 계획 삭제: 마이그레이션 계획을 영구적으로 제거합니다. 실행 중인 마이그레이션 계획을 삭제할 수 없습니다.

    참고

    삭제 계획은 되돌릴 수 없습니다.

    마이그레이션 계획을 삭제해도 임시 리소스는 제거되지 않습니다. 임시 리소스를 제거하려면 먼저 계획을 삭제하기 전에 보관합니다.

    참고

    마이그레이션 계획 보관 및 삭제 결과는 CLI 또는 UI를 사용하여 계획 및 스토리지 및 네트워크 매핑을 만들었는지에 따라 다릅니다.

    • UI를 사용하여 생성한 경우 마이그레이션 계획 및 해당 매핑이 더 이상 UI에 표시되지 않습니다.
    • CLI를 사용하여 생성한 경우에도 매핑이 여전히 UI에 표시될 수 있습니다. CLI의 매핑은 둘 이상의 마이그레이션 계획에서 사용할 수 있지만 UI에서 생성된 매핑은 하나의 마이그레이션 계획에서만 사용할 수 있기 때문입니다.

6.2.2. 마이그레이션 취소
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획이 진행되는 동안 일부 또는 모든 VM(가상 머신)의 마이그레이션을 취소할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 가상화 계획을 클릭합니다.
  2. 실행 중인 마이그레이션 계획의 이름을 클릭하여 마이그레이션 세부 정보를 확인합니다.
  3. 하나 이상의 VM을 선택하고 취소 를 클릭합니다.

  4. 예, 취소 를 클릭하여 취소를 확인합니다.

    VM별 마이그레이션 세부 정보 목록에서 취소된 VM의 상태가 취소됩니다. 마이그레이션되지 않은 가상 머신 및 마이그레이션된 가상 머신은 영향을 받지 않습니다.

마이그레이션 계획 페이지의 마이그레이션 계획 옆에 있는 재시작 을 클릭하여 취소된 마이그레이션 을 다시 시작할 수 있습니다.

6.3. 명령줄에서 Red Hat OpenShift Virtualization 마이그레이션 실행
링크 복사

Red Hat OpenShift Virtualization 공급자를 소스 공급자 또는 대상 공급자로 사용할 수 있습니다. CLI(명령줄 인터페이스)를 사용하여 OpenShift Virtualization 소스 공급자에서 마이그레이션할 수 있습니다.

참고

소스 공급자의 Red Hat OpenShift 클러스터 버전은 4.16 이상이어야 합니다.

프로세스

  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: 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
    Copy to Clipboard Toggle word wrap
    1
    ownerReferences 섹션은 선택 사항입니다.
    2
    cluster-admin 권한이 있는 서비스 계정의 토큰을 지정합니다. 토큰과 URL 이 모두 비어 있으면 로컬 OpenShift 클러스터가 사용됩니다.
    3
    사용자 암호를 지정합니다.
    4
    인증서 확인을 건너뛰려면 "true" 를 지정하고 "false" 를 지정하여 인증서를 확인합니다. 지정하지 않는 경우 기본값은 "false" 입니다. 인증서 확인을 건너뛰면 비보안 마이그레이션이 진행되므로 인증서가 필요하지 않습니다. 비보안 마이그레이션은 전송된 데이터가 안전하지 않은 연결을 통해 전송되고 잠재적으로 민감한 데이터가 노출될 수 있음을 의미합니다.
    5
    이 필드를 설정하지 않고 인증서 확인을 건너뛰면 MTV가 시스템 CA 사용을 시도합니다.
    6
    API 서버의 끝점 URL을 지정합니다.

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

    $ 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
    Copy to Clipboard Toggle word wrap
    1
    API 서버의 끝점 URL을 지정합니다.
    2
    공급자 Secret CR의 이름을 지정합니다.

  1. 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:
        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
    Copy to Clipboard Toggle word wrap
    1
    허용되는 값은 pod,ignored, multus 입니다.
    2
    네트워크 이름을 지정합니다. 유형이 multus 인 경우 OpenShift Virtualization 네트워크 연결 정의 이름을 사용합니다.
    3
    유형이 multus 인 경우에만 필요합니다. OpenShift Virtualization 네트워크 연결 정의의 네임스페이스를 지정합니다.

  1. 소스 및 대상 스토리지를 매핑하는 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:
        name: <storage_class>
  provider:
    source:
      name: <source_provider>
      namespace: <namespace>
    destination:
      name: <destination_provider>
      namespace: <namespace>
EOF
    Copy to Clipboard Toggle word wrap
    1
    허용되는 값은 ReadWriteOnce 및 ReadWriteMany 입니다.

  2. 선택 사항: 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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

  1. 다음 명령을 입력하여 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

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

    $ 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
    Copy to Clipboard Toggle word wrap
    1
    Plan CR의 이름을 지정합니다.
    2
    계획당 하나의 네트워크 맵과 하나의 스토리지 맵만 지정합니다.
    3
    마이그레이션할 VM이 네트워크에 할당되지 않은 경우에도 네트워크 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    4
    NetworkMap CR의 이름을 지정합니다.
    5
    마이그레이션할 VM이 디스크 이미지로 할당되지 않은 경우에도 스토리지 매핑을 지정합니다. 이 경우 매핑이 비어 있을 수 있습니다.
    6
    StorageMap CR의 이름을 지정합니다.
    7
    선택 사항: VM에 대해 최대 두 개의 후크를 지정합니다. 각 후크는 별도의 마이그레이션 단계에서 실행되어야 합니다.
    8
    Hook CR의 이름을 지정합니다.
    9
    허용되는 값은 마이그레이션 계획이 시작되기 전에 PreHook 이거나 마이그레이션이 완료된 후 postHook 입니다.

  3. 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 ).

6.3.1. 명령줄 인터페이스에서 마이그레이션 취소
링크 복사

CLI(명령줄 인터페이스)를 사용하여 마이그레이션이 진행되는 동안 전체 마이그레이션 또는 특정 VM(가상 머신) 마이그레이션을 취소할 수 있습니다.

7장. 고급 마이그레이션 옵션
링크 복사

웜 마이그레이션을 위해 사전 복사 스냅샷 간격 변경, 검증을 위한 사용자 정의 규칙 생성 또는 마이그레이션 계획에 후크 추가와 같은 고급 마이그레이션 작업을 수행합니다.

7.1. 웜 마이그레이션의 사전 복사 간격 변경
링크 복사

ForkliftController 사용자 정의 리소스(CR)를 패치하여 스냅샷 간격을 변경할 수 있습니다.

프로세스

  • ForkliftController CR을 패치합니다. 

    $ oc patch forkliftcontroller/<forklift-controller> -n openshift-mtv -p '{"spec": {"controller_precopy_interval": <60>}}' --type=merge
    1
    Copy to Clipboard Toggle word wrap
    1
    사전 복사 간격을 분 단위로 지정합니다. 기본값은 60 입니다.

    forklift-controller Pod를 다시 시작할 필요가 없습니다.

7.2. Validation 서비스에 대한 사용자 지정 규칙 생성
링크 복사

유효성 검사 서비스는 OCI(Open Policy Agent) 정책 규칙을 사용하여 마이그레이션을 위한 각 VM(가상 머신)의 적합성을 확인합니다. 유효성 검사 서비스는 공급자 인벤토리 서비스에 VM 속성으로 저장되는 각 VM에 대한 우려 목록을 생성합니다. 웹 콘솔에는 공급자 인벤토리의 각 VM에 대한 문제가 표시됩니다.

사용자 지정 규칙을 만들어 Validation 서비스의 기본 규칙 집합을 확장할 수 있습니다. 예를 들어 VM에 여러 디스크가 있는지 확인하는 규칙을 생성할 수 있습니다.

7.2.1. Rego 파일 정보
링크 복사

검증 규칙은 OCI(Open Policy Agent) 기본 쿼리 언어인 Rego 로 작성됩니다. 규칙은 Validation Pod의 /usr/share/opa/policies/io/konveyor/forklift/<provider > 디렉터리에 .rego 파일로 저장됩니다.

각 검증 규칙은 별도의 .rego 파일에 정의되고 특정 조건에 대한 테스트입니다. 조건이 true 로 평가되면 규칙은 {"category", "label", "assessment"} 해시를 문제에 추가합니다. 문제가 있는 콘텐츠는 VM의 인벤토리 레코드에 있는 concerns 키에 추가됩니다. 웹 콘솔에는 공급자 인벤토리의 각 VM에 대한 concerns 키 내용이 표시됩니다.

다음 .rego 파일 예제에서는 VMware VM 클러스터에서 활성화된 분산 리소스 스케줄링을 확인합니다.

drs_enabled.rego example

package io.konveyor.forklift.vmware
1 


has_drs_enabled {
    input.host.cluster.drsEnabled
2 

}

concerns[flag] {
    has_drs_enabled
    flag := {
        "category": "Information",
        "label": "VM running in a DRS-enabled cluster",
        "assessment": "Distributed resource scheduling is not currently supported by OpenShift Virtualization. The VM can be migrated but it will not have this feature in the target environment."
    }
}
Copy to Clipboard Toggle word wrap

1
각 검증 규칙은 패키지 내에 정의됩니다. 패키지 네임스페이스는 VMware용 io.konveyor.forklift.vmware 및 Red Hat Virtualization의 경우 io.konveyor.forklift.ovirt 입니다.
2
쿼리 매개변수는 Validation 서비스 JSON의 입력 키를 기반으로 합니다.

7.2.2. 기본 검증 규칙 확인
링크 복사

사용자 지정 규칙을 만들기 전에 Validation 서비스의 기본 규칙을 확인하여 기존 기본값을 설명하는 규칙을 만들지 않아야 합니다.

예: 기본 규칙에 default valid_input = false 행이 포함되어 있고 default valid_input = true 줄이 포함된 사용자 정의 규칙을 생성하면 검증 서비스가 시작되지 않습니다.

프로세스

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

    $ oc rsh <validation_pod>
    Copy to Clipboard Toggle word wrap

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

    $ cd /usr/share/opa/policies/io/konveyor/forklift/<provider>
    1
    Copy to Clipboard Toggle word wrap
    1
    vmware 또는 ovirt 를 지정합니다.

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

    $ grep -R "default" *
    Copy to Clipboard Toggle word wrap

7.2.3. 검증 규칙 생성
링크 복사

검증 서비스에 규칙이 포함된 구성 맵 CR(사용자 정의 리소스)을 적용하여 검증 규칙을 생성합니다.

중요
  • 기존 규칙과 동일한 이름으로 규칙을 만드는 경우 유효성 검사 서비스는 규칙을 사용하여 OR 작업을 수행합니다.
  • 기본 규칙과 일치하지 않는 규칙을 생성하면 검증 서비스가 시작되지 않습니다.

검증 규칙 예

검증 규칙은 공급자 인벤토리 서비스에서 수집한 VM(가상 머신) 속성을 기반으로 합니다.

예를 들어 VMware API는 이 경로를 사용하여 VMware VM에 NUMA 노드 유사성이 MOR: Cryostat.config.extraConfig["numa.nodeAffinity"] 가 구성되어 있는지 확인합니다.

공급자 인벤토리 서비스는 이 구성을 단순화하고 목록 값을 사용하여 테스트 가능한 속성을 반환합니다. 

"numaNodeAffinity": [
    "0",
    "1"
],
Copy to Clipboard Toggle word wrap

이 속성을 기반으로 Rego 쿼리를 생성하고 forklift-validation-config 구성 맵에 추가합니다. 

`count(input.numaNodeAffinity) != 0`
Copy to Clipboard Toggle word wrap

프로세스

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

    $ 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
    Copy to Clipboard Toggle word wrap
    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를 중지합니다. 

    $ oc scale -n openshift-mtv --replicas=0 deployment/forklift-controller
    Copy to Clipboard Toggle word wrap

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

    $ oc scale -n openshift-mtv --replicas=1 deployment/forklift-controller
    Copy to Clipboard Toggle word wrap

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

    $ oc logs -f <validation_pod>
    Copy to Clipboard Toggle word wrap

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

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

    $ oc delete provider <provider> -n openshift-mtv
    Copy to Clipboard Toggle word wrap

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

    $ 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
    Copy to Clipboard Toggle word wrap
    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의 이름을 지정합니다.

인벤토리 서비스에서 변경 사항을 감지하고 VM의 유효성을 검사하도록 사용자 지정 규칙을 생성한 후 규칙 버전을 업데이트해야 합니다.

7.2.4. 인벤토리 규칙 버전 업데이트
링크 복사

공급자 인벤토리 서비스에서 변경 사항을 감지하고 검증 서비스를 트리거하도록 규칙을 업데이트할 때마다 인벤토리 규칙 버전을 업데이트해야 합니다.

규칙 버전은 각 공급자에 대한 rules_version.rego 파일에 기록됩니다.

프로세스

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

    $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version
    1
    Copy to Clipboard Toggle word wrap

    출력 예

    {
   "result": {
       "rules_version": 5
   }
}
    Copy to Clipboard Toggle word wrap

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

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

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

    $ GET https://forklift-validation/v1/data/io/konveyor/forklift/<provider>/rules_version
    1
    Copy to Clipboard Toggle word wrap

    출력 예

    {
   "result": {
       "rules_version": 6
   }
}
    Copy to Clipboard Toggle word wrap

7.2.5. 인벤토리 서비스 JSON 검색
링크 복사

인벤토리 서비스 쿼리를 VM(가상 머신 )으로 전송하여 인벤토리 서비스 JSON을 검색합니다. 출력에는 유효성 검사 서비스 규칙에 의해 쿼리되는 인벤토리 속성이 포함된 "입력" 키가 포함되어 있습니다.

"입력" 키의 모든 속성을 기반으로 검증 규칙을 생성할 수 있습니다(예: input.snapshot.kind ).

프로세스

  1. 프로젝트의 경로를 검색합니다. 

    oc get route -n openshift-mtv
    Copy to Clipboard Toggle word wrap

  2. 인벤토리 서비스 경로를 검색합니다. 

    $ oc get route <inventory_service> -n openshift-mtv
    Copy to Clipboard Toggle word wrap

  3. 액세스 토큰을 검색합니다. 

    $ TOKEN=$(oc whoami -t)
    Copy to Clipboard Toggle word wrap

  4. HTTP GET 요청을 트리거합니다(예: Curl 사용). 

    $ curl -H "Authorization: Bearer $TOKEN" https://<inventory_service_route>/providers -k
    Copy to Clipboard Toggle word wrap

  5. 공급자의 UUID 를 검색합니다. 

    $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider> -k
    1
    Copy to Clipboard Toggle word wrap
    1 1 1
    공급자에 허용되는 값은 vsphere,ovirt, openstack 입니다.

  6. 공급자의 VM을 검색합니다. 

    $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/vms -k
    Copy to Clipboard Toggle word wrap

  7. VM의 세부 정보를 검색합니다. 

    $ curl -H "Authorization: Bearer $TOKEN"  https://<inventory_service_route>/providers/<provider>/<UUID>/workloads/<vm> -k
    Copy to Clipboard Toggle word wrap

    출력 예

    {
    "input": {
        "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/workloads/vm-431",
        "id": "vm-431",
        "parent": {
            "kind": "Folder",
            "id": "group-v22"
        },
        "revision": 1,
        "name": "iscsi-target",
        "revisionValidated": 1,
        "isTemplate": false,
        "networks": [
            {
                "kind": "Network",
                "id": "network-31"
            },
            {
                "kind": "Network",
                "id": "network-33"
            }
        ],
        "disks": [
            {
                "key": 2000,
                "file": "[iSCSI_Datastore] iscsi-target/iscsi-target-000001.vmdk",
                "datastore": {
                    "kind": "Datastore",
                    "id": "datastore-63"
                },
                "capacity": 17179869184,
                "shared": false,
                "rdm": false
            },
            {
                "key": 2001,
                "file": "[iSCSI_Datastore] iscsi-target/iscsi-target_1-000001.vmdk",
                "datastore": {
                    "kind": "Datastore",
                    "id": "datastore-63"
                },
                "capacity": 10737418240,
                "shared": false,
                "rdm": false
            }
        ],
        "concerns": [],
        "policyVersion": 5,
        "uuid": "42256329-8c3a-2a82-54fd-01d845a8bf49",
        "firmware": "bios",
        "powerState": "poweredOn",
        "connectionState": "connected",
        "snapshot": {
            "kind": "VirtualMachineSnapshot",
            "id": "snapshot-3034"
        },
        "changeTrackingEnabled": false,
        "cpuAffinity": [
            0,
            2
        ],
        "cpuHotAddEnabled": true,
        "cpuHotRemoveEnabled": false,
        "memoryHotAddEnabled": false,
        "faultToleranceEnabled": false,
        "cpuCount": 2,
        "coresPerSocket": 1,
        "memoryMB": 2048,
        "guestName": "Red Hat Enterprise Linux 7 (64-bit)",
        "balloonedMemory": 0,
        "ipAddress": "10.19.2.96",
        "storageUsed": 30436770129,
        "numaNodeAffinity": [
            "0",
            "1"
        ],
        "devices": [
            {
                "kind": "RealUSBController"
            }
        ],
        "host": {
            "id": "host-29",
            "parent": {
                "kind": "Cluster",
                "id": "domain-c26"
            },
            "revision": 1,
            "name": "IP address or host name of the vCenter host or RHV Engine host",
            "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/hosts/host-29",
            "status": "green",
            "inMaintenance": false,
            "managementServerIp": "10.19.2.96",
            "thumbprint": <thumbprint>,
            "timezone": "UTC",
            "cpuSockets": 2,
            "cpuCores": 16,
            "productName": "VMware ESXi",
            "productVersion": "6.5.0",
            "networking": {
                "pNICs": [
                    {
                        "key": "key-vim.host.PhysicalNic-vmnic0",
                        "linkSpeed": 10000
                    },
                    {
                        "key": "key-vim.host.PhysicalNic-vmnic1",
                        "linkSpeed": 10000
                    },
                    {
                        "key": "key-vim.host.PhysicalNic-vmnic2",
                        "linkSpeed": 10000
                    },
                    {
                        "key": "key-vim.host.PhysicalNic-vmnic3",
                        "linkSpeed": 10000
                    }
                ],
                "vNICs": [
                    {
                        "key": "key-vim.host.VirtualNic-vmk2",
                        "portGroup": "VM_Migration",
                        "dPortGroup": "",
                        "ipAddress": "192.168.79.13",
                        "subnetMask": "255.255.255.0",
                        "mtu": 9000
                    },
                    {
                        "key": "key-vim.host.VirtualNic-vmk0",
                        "portGroup": "Management Network",
                        "dPortGroup": "",
                        "ipAddress": "10.19.2.13",
                        "subnetMask": "255.255.255.128",
                        "mtu": 1500
                    },
                    {
                        "key": "key-vim.host.VirtualNic-vmk1",
                        "portGroup": "Storage Network",
                        "dPortGroup": "",
                        "ipAddress": "172.31.2.13",
                        "subnetMask": "255.255.0.0",
                        "mtu": 1500
                    },
                    {
                        "key": "key-vim.host.VirtualNic-vmk3",
                        "portGroup": "",
                        "dPortGroup": "dvportgroup-48",
                        "ipAddress": "192.168.61.13",
                        "subnetMask": "255.255.255.0",
                        "mtu": 1500
                    },
                    {
                        "key": "key-vim.host.VirtualNic-vmk4",
                        "portGroup": "VM_DHCP_Network",
                        "dPortGroup": "",
                        "ipAddress": "10.19.2.231",
                        "subnetMask": "255.255.255.128",
                        "mtu": 1500
                    }
                ],
                "portGroups": [
                    {
                        "key": "key-vim.host.PortGroup-VM Network",
                        "name": "VM Network",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                    },
                    {
                        "key": "key-vim.host.PortGroup-Management Network",
                        "name": "Management Network",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch0"
                    },
                    {
                        "key": "key-vim.host.PortGroup-VM_10G_Network",
                        "name": "VM_10G_Network",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                    },
                    {
                        "key": "key-vim.host.PortGroup-VM_Storage",
                        "name": "VM_Storage",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                    },
                    {
                        "key": "key-vim.host.PortGroup-VM_DHCP_Network",
                        "name": "VM_DHCP_Network",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                    },
                    {
                        "key": "key-vim.host.PortGroup-Storage Network",
                        "name": "Storage Network",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch1"
                    },
                    {
                        "key": "key-vim.host.PortGroup-VM_Isolated_67",
                        "name": "VM_Isolated_67",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                    },
                    {
                        "key": "key-vim.host.PortGroup-VM_Migration",
                        "name": "VM_Migration",
                        "vSwitch": "key-vim.host.VirtualSwitch-vSwitch2"
                    }
                ],
                "switches": [
                    {
                        "key": "key-vim.host.VirtualSwitch-vSwitch0",
                        "name": "vSwitch0",
                        "portGroups": [
                            "key-vim.host.PortGroup-VM Network",
                            "key-vim.host.PortGroup-Management Network"
                        ],
                        "pNICs": [
                            "key-vim.host.PhysicalNic-vmnic4"
                        ]
                    },
                    {
                        "key": "key-vim.host.VirtualSwitch-vSwitch1",
                        "name": "vSwitch1",
                        "portGroups": [
                            "key-vim.host.PortGroup-VM_10G_Network",
                            "key-vim.host.PortGroup-VM_Storage",
                            "key-vim.host.PortGroup-VM_DHCP_Network",
                            "key-vim.host.PortGroup-Storage Network"
                        ],
                        "pNICs": [
                            "key-vim.host.PhysicalNic-vmnic2",
                            "key-vim.host.PhysicalNic-vmnic0"
                        ]
                    },
                    {
                        "key": "key-vim.host.VirtualSwitch-vSwitch2",
                        "name": "vSwitch2",
                        "portGroups": [
                            "key-vim.host.PortGroup-VM_Isolated_67",
                            "key-vim.host.PortGroup-VM_Migration"
                        ],
                        "pNICs": [
                            "key-vim.host.PhysicalNic-vmnic3",
                            "key-vim.host.PhysicalNic-vmnic1"
                        ]
                    }
                ]
            },
            "networks": [
                {
                    "kind": "Network",
                    "id": "network-31"
                },
                {
                    "kind": "Network",
                    "id": "network-34"
                },
                {
                    "kind": "Network",
                    "id": "network-57"
                },
                {
                    "kind": "Network",
                    "id": "network-33"
                },
                {
                    "kind": "Network",
                    "id": "dvportgroup-47"
                }
            ],
            "datastores": [
                {
                    "kind": "Datastore",
                    "id": "datastore-35"
                },
                {
                    "kind": "Datastore",
                    "id": "datastore-63"
                }
            ],
            "vms": null,
            "networkAdapters": [],
            "cluster": {
                "id": "domain-c26",
                "parent": {
                    "kind": "Folder",
                    "id": "group-h23"
                },
                "revision": 1,
                "name": "mycluster",
                "selfLink": "providers/vsphere/c872d364-d62b-46f0-bd42-16799f40324e/clusters/domain-c26",
                "folder": "group-h23",
                "networks": [
                    {
                        "kind": "Network",
                        "id": "network-31"
                    },
                    {
                        "kind": "Network",
                        "id": "network-34"
                    },
                    {
                        "kind": "Network",
                        "id": "network-57"
                    },
                    {
                        "kind": "Network",
                        "id": "network-33"
                    },
                    {
                        "kind": "Network",
                        "id": "dvportgroup-47"
                    }
                ],
                "datastores": [
                    {
                        "kind": "Datastore",
                        "id": "datastore-35"
                    },
                    {
                        "kind": "Datastore",
                        "id": "datastore-63"
                    }
                ],
                "hosts": [
                    {
                        "kind": "Host",
                        "id": "host-44"
                    },
                    {
                        "kind": "Host",
                        "id": "host-29"
                    }
                ],
                "dasEnabled": false,
                "dasVms": [],
                "drsEnabled": true,
                "drsBehavior": "fullyAutomated",
                "drsVms": [],
                "datacenter": null
            }
        }
    }
}
    Copy to Clipboard Toggle word wrap

7.3. MTV 마이그레이션 계획에 후크 추가
링크 복사

MCP(Migration Toolkit for Virtualization) 마이그레이션 계획에 후크를 추가하여 마이그레이션 전이나 후에 VM에서 자동화된 작업을 수행할 수 있습니다.

7.3.1. MTV 마이그레이션 계획의 후크 정보
링크 복사

MCP(Migration Toolkit for Virtualization) 마이그레이션 계획에 후크를 추가하여 마이그레이션 전이나 후에 VM에서 자동화된 작업을 수행할 수 있습니다.

Red Hat OpenShift 웹 콘솔에 있는 MTV CLI 또는 MTV 사용자 인터페이스를 사용하여 MTC(Migration Toolkit for Virtualization) 마이그레이션 계획에 후크를 추가할 수 있습니다.

  • 마이그레이션 전 후크는 공급자에 있는 VM에서 작업을 수행하는 후크입니다. 그러면 마이그레이션을 위한 VM이 준비됩니다.
  • 마이그레이션 후 후크는 OpenShift Virtualization으로 마이그레이션된 VM에서 작업을 수행하는 후크입니다.
7.3.1.1. 기본 후크 이미지
링크 복사

MTV 후크의 기본 후크 이미지는 quay.io/kubev2v/hook-runner 입니다. 이미지는 Ansible Kubernetes 리소스 및 최근 oc 바이너리를 제공하기 위해 python-openshift 가 추가된 Ansible Runner 이미지를 기반으로 합니다.

7.3.1.2. 후크 실행
링크 복사

마이그레이션 후크의 일부로 제공되는 Ansible 플레이북은 후크 컨테이너에 ConfigMap 으로 마운트됩니다. 후크 컨테이너는 선택한 ServiceAccount 를 사용하여 openshift-mtv 네임스페이스의 원하는 클러스터에서 작업으로 실행됩니다.

후크를 추가할 때 후크 CR이 있는 네임스페이스, 후크 이름, 후크가 사전 마이그레이션 후크인지 또는 마이그레이션 후 후크인지를 지정해야 합니다.

중요

후크를 VM에서 실행하려면 VM을 시작하고 SSH를 사용하여 사용할 수 있어야 합니다.

다음 그림에서는 마이그레이션 후크를 사용하는 일반적인 프로세스를 보여줍니다. 특정 절차는 Red Hat OpenShift 웹 콘솔을 사용하여 마이그레이션 계획에 마이그레이션 후크 추가 및 CLI를 사용하여 마이그레이션 계획에 마이그레이션 후크 추가를 참조하십시오.

그림 7.1. 마이그레이션 계획에 후크 추가

마이그레이션 계획에 후크 추가
View larger image
마이그레이션 계획에 후크 추가

프로세스:

  1. Ansible 후크 및 인증 정보를 입력합니다.

    1. UI 또는 CLI를 사용하여 Ansible 후크 이미지를 MTV 컨트롤러에 입력합니다.

      • UI에서 ansible-runner 를 지정하고 후크를 포함하는 playbook.yml 을 입력합니다.
      • CLI에서 후크를 실행하는 플레이북을 지정하는 후크 이미지를 입력합니다.

    2. SSH 데이터와 같이 Pod 내에서 플레이북을 실행하기 위해 추가 데이터가 필요한 경우 VM의 인증 정보가 포함된 보안을 생성합니다. 시크릿은 포드에 마운트되지 않지만 플레이북에서 호출됩니다.

      참고

      이 보안은 소스 공급자의 인증 정보가 포함된 Secret CR과 동일하지 않습니다.

  2. MTV 컨트롤러는 다음을 포함하는 ConfigMap 을 생성합니다.

    • workload.yml: VM에 대한 정보를 포함합니다.
    • playbook.yml - 실행할 원시 문자열 플레이북입니다.

    • plan.yml: Plan CR입니다.

      ConfigMap 에는 VM 이름이 포함되어 있으며 플레이북에 수행할 작업을 지시합니다.

  3. MTV 컨트롤러는 사용자가 지정한 이미지를 시작하는 작업을 생성합니다.

    1. 컨테이너에 ConfigMap 을 마운트합니다.

      Ansible 후크는 사용자가 이전에 입력한 보안을 가져옵니다.

  4. 이 작업은 다음과 같이 마이그레이션 전 후크 또는 마이그레이션 후 후크를 실행합니다.

    1. 마이그레이션 전 후크의 경우 작업은 SSH를 사용하여 소스 공급자의 VM에 로그하고 후크를 실행합니다.
    2. 마이그레이션 후 후크의 경우 작업은 SSH를 사용하여 OpenShift Virtualization의 VM에 로그하고 후크를 실행합니다.

Red Hat OpenShift 웹 콘솔을 사용하여 기존 마이그레이션 계획에 마이그레이션 후크를 추가할 수 있습니다.

참고

MCP(Migration Toolkit for Virtualization) CLI에서 하나의 명령을 실행해야 합니다.

예를 들어 후크를 생성하여 VM에 cloud-init 서비스를 설치하고 마이그레이션 전에 파일을 작성할 수 있습니다.

참고

마이그레이션 전 후크 한 개, 마이그레이션 후 후크 한 개 또는 마이그레이션 계획당 하나씩 실행할 수 있습니다.

사전 요구 사항

  • 마이그레이션 계획
  • 복사한 콘텐츠를 복사하여 웹 콘솔에 붙여넣는 마이그레이션 후크 파일
  • 소스 공급자의 시크릿 이 포함된 파일
  • 후크에서 호출하고 작업 중인 네임스페이스에 대한 쓰기 액세스 권한이 있는 Red Hat OpenShift 서비스 계정
  • VM에 설치된 공개 키를 사용하여 마이그레이션하려는 VM용 SSH 액세스
  • Microsoft Server에서만 실행되는 VM: 원격 실행이 활성화됨

추가 리소스

서비스 계정 생성에 대한 지침은 서비스 계정 이해 및 생성을 참조하십시오.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 &gt ; 가상화 계획을 클릭한 다음 후크를 추가할 마이그레이션 계획을 클릭합니다.
  2. 후크 를 클릭합니다.

  3. 사전 마이그레이션 후크의 경우 다음 단계를 수행합니다.

    1. 사전 마이그레이션 후크 섹션에서 후크 활성화 스위치를 전환하여 사전 마이그레이션 후크를 활성화합니다.
    2. 후크 실행기 이미지를 입력합니다. spec.playbook 을 지정하는 경우 ansible-runner 가 있는 이미지를 사용해야 합니다.
    3. 후크를 Ansible 플레이북 텍스트 상자에 YAML 파일로 붙여넣습니다.

  4. 마이그레이션 후 후크의 경우 다음 단계를 수행합니다.

    1. Post migration hook 에서 Enable hook switch Enable post migration hook 를 전환합니다.
    2. 후크 실행기 이미지를 입력합니다. spec.playbook 을 지정하는 경우 ansible-runner 가 있는 이미지를 사용해야 합니다.
    3. 후크를 Ansible 플레이북 텍스트 상자에 YAML 파일로 붙여넣습니다.
  5. 탭 상단에서 업데이트 후크 를 클릭합니다.

  6. 터미널에서 다음 명령을 입력하여 각 후크를 Red Hat OpenShift 서비스 계정과 연결합니다. 

    $ oc -n openshift-mtv patch hook <name_of_hook> \
  -p '{"spec":{"serviceAccount":"<service_account>"}}' --type merge
    Copy to Clipboard Toggle word wrap

다음 예제 마이그레이션 후크는 SSH를 사용하여 VM에 액세스할 수 있도록 하며 SSH 키를 생성하며 2개의 작업을 실행합니다. 즉, database를 중지하고 텍스트 파일을 생성합니다.

마이그레이션 후크의 예

- name: Main
  hosts: localhost
  vars_files:
    - plan.yml
    - workload.yml
  tasks:
  - k8s_info:
      api_version: v1
      kind: Secret
      name: privkey
      namespace: openshift-mtv
    register: ssh_credentials

  - name: Ensure SSH directory exists
    file:
      path: ~/.ssh
      state: directory
      mode: 0750

  - name: Create SSH key
    copy:
      dest: ~/.ssh/id_rsa
      content: "{{ ssh_credentials.resources[0].data.key | b64decode }}"
      mode: 0600

  - add_host:
      name: "{{ vm.ipaddress }}"  # ALT "{{ vm.guestnetworks[2].ip }}"
      ansible_user: root
      groups: vms

- hosts: vms
  vars_files:
    - plan.yml
    - workload.yml
  tasks:
  - name: Stop MariaDB
    service:
      name: mariadb
      state: stopped

  - name: Create Test File
    copy:
      dest: /premigration.txt
      content: "Migration from {{ provider.source.name }}
                of {{ vm.vm1.vm0.id }} has finished\n"
      mode: 0644
Copy to Clipboard Toggle word wrap

7.3.3. CLI를 사용하여 마이그레이션 계획에 마이그레이션 후크 추가
링크 복사

후크 CR을 사용하여 MTV(Migration Toolkit for Virtualization) CLI를 사용하여 사전 마이그레이션 후크 또는 마이그레이션 후 후크를 기존 마이그레이션 계획에 추가할 수 있습니다.

예를 들어 Hook CR(사용자 정의 리소스)을 생성하여 VM에 cloud-init 서비스를 설치하고 마이그레이션 전에 파일을 작성할 수 있습니다.

참고

마이그레이션 전 후크 한 개, 마이그레이션 후 후크 한 개 또는 마이그레이션 계획당 하나씩 실행할 수 있습니다. 각 후크에는 자체 후크 CR이 필요하지만 Plan CR에는 사용하는 모든 후크에 대한 데이터가 포함되어 있습니다.

참고

k8s 모듈을 사용하여 시크릿 또는 ConfigMap 에 저장된 추가 정보를 검색할 수 있습니다.

사전 요구 사항

  • 마이그레이션 계획
  • 마이그레이션 후크 이미지 또는 후크 이미지가 포함된 플레이북
  • 소스 공급자의 시크릿이 포함된 파일
  • 후크에서 호출하고 작업 중인 네임스페이스에 대한 쓰기 액세스 권한이 있는 Red Hat OpenShift 서비스 계정
  • VM에 설치된 공개 키를 사용하여 마이그레이션하려는 VM용 SSH 액세스
  • Microsoft Server에서만 실행되는 VM: 원격 실행이 활성화됨

추가 리소스

서비스 계정 생성에 대한 지침은 서비스 계정 이해 및 생성을 참조하십시오.

프로세스

  1. 필요한 경우 VM의 SSH 개인 키를 사용하여 보안을 생성합니다.

    1. 기존 키를 선택하거나 키 쌍을 생성합니다.
    2. VM에 공개 키를 설치합니다.

    3. 시크릿의 개인 키를 base64로 인코딩합니다. 

      apiVersion: v1
data:
  key: VGhpcyB3YXMgZ2Vu...
kind: Secret
metadata:
  name: ssh-credentials
  namespace: openshift-mtv
type: Opaque
      Copy to Clipboard Toggle word wrap

  2. 파일을 연결하고 Base64 인코딩을 위해 파이핑하여 플레이북을 인코딩합니다. 예를 들면 다음과 같습니다. 

    $ cat playbook.yml | base64 -w0
    Copy to Clipboard Toggle word wrap

  3. 후크 CR을 생성합니다. 

    $  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 이미지를 사용하거나 사용자 정의 이미지를 지정할 수 있습니다. 사용자 지정 이미지를 지정하는 경우 플레이북을 지정할 필요가 없습니다.

    참고

    연결된 플레이북을 디코딩하려면 사용자 지정 출력으로 리소스를 검색하고 base64로 파이프합니다. 예를 들면 다음과 같습니다. 

    $ oc get -n konveyor-forklift hook playbook -o \
    go-template='{{ .spec.playbook }}' | base64 -d
    Copy to Clipboard Toggle word wrap

  4. 마이그레이션의 Plan CR에서 각 VM에 대해 CR 끝에 다음 섹션을 추가합니다. 

      vms:
    - id: <vm_id>
      hooks:
        - hook:
            namespace: <namespace>
            name: <name_of_hook>
          step: <type_of_hook>
    1
    Copy to Clipboard Toggle word wrap
    1
    옵션은 마이그레이션 전에 후크를 실행하는 사전 후크이며 후크 후 마이그레이션 후 후크를 실행합니다.
중요

사전 후크를 VM에서 실행하려면 VM을 시작하고 SSH를 통해 사용할 수 있어야 합니다.

다음 예제 마이그레이션 후크는 SSH를 사용하여 VM에 액세스할 수 있도록 하며 SSH 키를 생성하며 2개의 작업을 실행합니다. 즉, database를 중지하고 텍스트 파일을 생성합니다.

마이그레이션 후크의 예

- name: Main
  hosts: localhost
  vars_files:
    - plan.yml
    - workload.yml
  tasks:
  - k8s_info:
      api_version: v1
      kind: Secret
      name: privkey
      namespace: openshift-mtv
    register: ssh_credentials

  - name: Ensure SSH directory exists
    file:
      path: ~/.ssh
      state: directory
      mode: 0750

  - name: Create SSH key
    copy:
      dest: ~/.ssh/id_rsa
      content: "{{ ssh_credentials.resources[0].data.key | b64decode }}"
      mode: 0600

  - add_host:
      name: "{{ vm.ipaddress }}"  # ALT "{{ vm.guestnetworks[2].ip }}"
      ansible_user: root
      groups: vms

- hosts: vms
  vars_files:
    - plan.yml
    - workload.yml
  tasks:
  - name: Stop MariaDB
    service:
      name: mariadb
      state: stopped

  - name: Create Test File
    copy:
      dest: /premigration.txt
      content: "Migration from {{ provider.source.name }}
                of {{ vm.vm1.vm0.id }} has finished\n"
      mode: 0644
Copy to Clipboard Toggle word wrap

7.3.4. 사용자 정의 네트워크 정보
링크 복사

Migration Toolkit for Virtualization 2.10부터 OpenShift Virtualization을 제외한 모든 공급자의 마이그레이션에 필요한 사용자 정의 네트워크(UDN)를 기본 네트워크로 사용할 수 있습니다. 이러한 유연성을 통해 VM(가상 머신)을 OpenShift Virtualization으로 보다 일관되게 마이그레이션할 수 있습니다.

MTV는 VM을 UDN 네임스페이스로 쉽게 마이그레이션할 수 있도록 설계되었습니다. OpenShift Virtualization에서 UDN을 구성하면 마이그레이션 계획 매핑에서 기본 네트워크로 지정할 수 있습니다. MTV는 이제 UDN을 기존 pod 네트워크와 구별할 수 있습니다.

Red Hat OpenShift 웹 콘솔을 사용하거나 MTV 명령줄 인터페이스를 사용하여 마이그레이션 계획을 생성하는 데 이 기능을 사용할 수 있습니다. 새 기능을 포함하도록 마이그레이션 계획을 생성하는 절차가 업데이트되었습니다.

추가 리소스

가상 머신을 기본 사용자 정의 네트워크에 연결

8장. Migration Toolkit for Virtualization 업그레이드 또는 설치 제거
링크 복사

Red Hat OpenShift 웹 콘솔 또는 CLI(명령줄 인터페이스)를 사용하여 MCP(Migration Toolkit for Virtualization)를 업그레이드하거나 제거할 수 있습니다.

8.1. Migration Toolkit for Virtualization 업그레이드
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 새 버전을 설치하여 MTV Operator를 업그레이드할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 Operator → 설치된 Operator → Migration Toolkit for Virtualization Operator → 서브스크립션 을 클릭합니다.

  2. 업데이트 채널을 올바른 릴리스로 변경합니다.

    Red Hat OpenShift 문서의 업데이트 채널 변경을 참조하십시오.

  3. Upgrade 상태가 Up to date 에서 Upgrade available 로 변경되는지 확인합니다. 그러지 않으면 CatalogSource Pod를 다시 시작합니다.

    1. 카탈로그 소스(예: redhat-operators )를 확인합니다.

    2. 명령줄에서 카탈로그 소스 Pod를 검색합니다. 

      $ oc get pod -n openshift-marketplace | grep <catalog_source>
      Copy to Clipboard Toggle word wrap

    3. Pod를 삭제합니다. 

      $ oc delete pod -n openshift-marketplace <catalog_source_pod>
      Copy to Clipboard Toggle word wrap

      업그레이드 상태가 최신 에서 업그레이드 가능 으로 변경됩니다.

      서브스크립션 탭에서 업데이트 승인을 자동으로 설정하면 업그레이드 가 자동으로 시작됩니다.

  4. 서브스크립션 탭에서 업데이트 승인을 Manual 로 설정한 경우 업그레이드를 승인합니다.

    Red Hat OpenShift 설명서에서 보류 중인 업그레이드 수동 승인을 참조하십시오.

  5. MTV 2.2에서 업그레이드하고 VMware 소스 공급자를 정의한 경우 VDDK init 이미지를 추가하여 VMware 공급자를 편집합니다. 그렇지 않으면 업데이트가 VMware 공급 업체의 상태를 Critical 로 변경합니다. 자세한 내용은 VMSphere 소스 공급자 추가를 참조하십시오.
  6. MTV 2.2의 Red Hat OpenShift 대상 공급자의 NFS에 매핑된 경우 NFS 스토리지 프로필에서 AccessModes 및 VolumeMode 매개변수를 편집합니다. 그렇지 않으면 업그레이드가 NFS 매핑을 무효화합니다. 자세한 내용은 스토리지 프로필 사용자 지정을 참조하십시오.

8.2. Red Hat OpenShift 웹 콘솔을 사용하여 MTV 설치 제거
링크 복사

Red Hat OpenShift 웹 콘솔을 사용하여 MCP(Migration Toolkit for Virtualization)를 설치 제거할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 사용자로 로그인해야 합니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 Operator > 설치된 Operator를 클릭합니다.

  2. Migration Toolkit for Virtualization Operator 를 클릭합니다.

    Operator 세부 정보 페이지가 세부 정보 탭에 열립니다.

  3. ForkliftController 탭을 클릭합니다.

  4. 작업을 클릭하고 ForkLiftController 삭제 를 선택합니다.

    확인 창이 열립니다.

  5. 삭제를 클릭합니다.

    컨트롤러가 제거되었습니다.

  6. 세부 정보 탭을 엽니다.

    삭제한 컨트롤러 대신 ForkliftController 생성 버튼이 표시됩니다. 클릭할 필요가 없습니다.

  7. 페이지 오른쪽 상단에서 작업을 클릭하고 Operator 설치 제거를 선택합니다.

    피연산자 인스턴스가 표시되고 확인 창이 열립니다.

  8. 모든 인스턴스를 삭제하려면 이 Operator의 모든 피연산자 인스턴스 삭제 확인란을 선택합니다. 기본적으로 확인란은 선택 취소됩니다.

    중요

    Operator가 클러스터 외부 리소스를 구성한 경우 해당 리소스가 계속 실행되고 수동 정리가 필요합니다.

  9. 제거를 클릭합니다.

    설치된 Operator 페이지가 열리고 Migration Toolkit for Virtualization Operator가 설치된 Operator 목록에서 제거됩니다.

  10. 홈 > 개요를 클릭합니다.

  11. 페이지의 상태 섹션에서 동적 플러그인 을 클릭합니다.

    동적 플러그인 팝업이 열리고 forklift-console-plugin 이 실패한 플러그인으로 나열됩니다. forklift-console-plugin 이 실패한 플러그인으로 나타나지 않으면 웹 콘솔을 새로 고칩니다.

  12. forklift-console-plugin 을 클릭합니다.

    ConsolePlugin 세부 정보 페이지가 세부 정보 탭에 열립니다.

  13. 페이지 오른쪽 상단에 있는 작업을 클릭하고 목록에서 ConsolePlugin 삭제 를 선택합니다.

    확인 창이 열립니다.

  14. 삭제를 클릭합니다.

    플러그인은 개요 페이지의 동적 플러그인 목록에서 제거됩니다. 플러그인이 계속 표시되면 개요 페이지를 다시 시작합니다.

8.3. 명령줄에서 MTV 설치 제거
링크 복사

명령줄에서 MTC(Migration Toolkit for Virtualization)를 제거할 수 있습니다.

참고

이 작업은 CRD(사용자 정의 리소스 정의) 및 CR(사용자 정의 리소스)을 포함하여 MTV Operator에서 관리하는 리소스를 제거하지 않습니다. MTV Operator를 설치 제거한 후 이를 제거하려면 MTV Operator CRD를 수동으로 삭제해야 할 수 있습니다.

사전 요구 사항

  • cluster-admin 권한이 있는 사용자로 로그인해야 합니다.

프로세스

  1. 다음 명령을 실행하여 지게차 컨트롤러를 삭제합니다. 

    $ oc delete ForkliftController --all -n openshift-mtv
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 MTV Operator에 대한 서브스크립션을 삭제합니다. 

    $ oc get subscription -o name|grep 'mtv-operator'| xargs oc delete
    Copy to Clipboard Toggle word wrap

  3. 다음 명령을 실행하여 MTV Operator의 clusterserviceversion 을 삭제합니다. 

    $ oc get clusterserviceversion -o name|grep 'mtv-operator'| xargs oc delete
    Copy to Clipboard Toggle word wrap

  4. 다음 명령을 실행하여 플러그인 콘솔 CR을 삭제합니다. 

    $ oc delete ConsolePlugin forklift-console-plugin
    Copy to Clipboard Toggle word wrap

  5. 선택 사항: 다음 명령을 실행하여 CRD(사용자 정의 리소스 정의)를 삭제합니다. 

    oc get crd -o name | grep 'forklift.konveyor.io' | xargs oc delete
    Copy to Clipboard Toggle word wrap

  6. 선택 사항: 다음 명령을 실행하여 MTV 프로젝트를 삭제하여 정리를 수행합니다. 

    oc delete project openshift-mtv
    Copy to Clipboard Toggle word wrap

9장. 마이그레이션 문제 해결
링크 복사

마이그레이션 문제를 해결하고, CR(사용자 정의 리소스), 서비스 및 워크플로우로 이동하여 문제 해결을 위해 로그 및 CR을 다운로드합니다.

9.1. 오류 메시지
링크 복사

이 섹션에서는 오류 메시지와 해결 방법에 대해 설명합니다.

9.1.1. 웜 가져오기 재시도 제한에 도달했습니다.
링크 복사

VMware 가상 머신(VM)이 사전 복사 단계에서 변경된 블록 추적(CBT) 스냅샷의 최대 수(28)에 도달한 경우 웜 마이그레이션 중에 웜 가져오기 재시도 제한에 도달한 오류 메시지가 표시됩니다.

이 문제를 해결하려면 VM에서 일부 CBT 스냅샷을 삭제하고 마이그레이션 계획을 다시 시작하십시오.

9.1.2. 필요한 크기로 디스크 이미지의 크기를 조정할 수 없음
링크 복사

대상 공급자의 가상 머신은 블록 스토리지에서 EXT4 파일 시스템을 사용하여 영구 볼륨을 사용하므로 마이그레이션이 실패할 때 디스크 이미지의 크기를 조정할 수 없음 메시지가 표시됩니다. CDI에서 가정하는 기본 오버헤드에는 루트 파티션에 예약된 위치가 완전히 포함되지 않기 때문에 문제가 발생합니다.

이 문제를 해결하려면 CDI의 파일 시스템 오버헤드를 10% 이상으로 늘립니다.

9.2. must-gather 툴 사용
링크 복사

must-gather 툴을 사용하여 MTV CR(사용자 정의 리소스)에 대한 로그 및 정보를 수집할 수 있습니다. must-gather 데이터 파일을 모든 고객 사례에 연결해야 합니다.

필터링 옵션을 사용하여 특정 네임스페이스, 마이그레이션 계획 또는 VM(가상 머신)에 대한 데이터를 수집할 수 있습니다.

참고

필터링된 must-gather 명령에 존재하지 않는 리소스를 지정하는 경우 아카이브 파일이 생성되지 않습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 OpenShift Virtualization 클러스터에 로그인해야 합니다.
  • Red Hat OpenShift CLI(oc) 가 설치되어 있어야 합니다.

프로세스

  1. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

  2. oc adm must-gather 명령을 실행합니다. 

    $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0
    Copy to Clipboard Toggle word wrap

    데이터는 /must-gather/must-gather.tar.gz로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

  3. 선택 사항: oc adm must-gather 명령을 다음 옵션과 함께 실행하여 필터링된 데이터를 수집합니다.

    • namespace: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- NS=<namespace> /usr/bin/targeted
      Copy to Clipboard Toggle word wrap

    • 마이그레이션 계획: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- PLAN=<migration_plan> /usr/bin/targeted
      Copy to Clipboard Toggle word wrap

    • 가상 머신: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- VM=<vm_id> NS=<namespace> /usr/bin/targeted
      1
      Copy to Clipboard Toggle word wrap
      1
      Plan CR에 표시되는 대로 VM ID 를 지정합니다.

9.3. MTV 사용자 정의 리소스 및 서비스
링크 복사

MTV(Migration Toolkit for Virtualization)는 Red Hat OpenShift Operator로 제공됩니다. 다음 CR(사용자 정의 리소스) 및 서비스를 생성하고 관리합니다.

9.3.1. MTV 사용자 정의 리소스
링크 복사

  • 공급자 CR은 MTV가 소스 및 대상 공급자에 연결하고 상호 작용할 수 있는 속성을 저장합니다.
  • NetworkMapping CR은 소스 및 대상 공급자의 네트워크를 매핑합니다.
  • StorageMapping CR은 소스 및 대상 공급자의 스토리지를 매핑합니다.
  • plan CR에는 동일한 마이그레이션 매개변수 및 관련 네트워크 및 스토리지 매핑이 있는 VM 목록이 포함되어 있습니다.

  • Migration CR은 마이그레이션 계획을 실행합니다.

    마이그레이션 계획당 하나의 마이그레이션 CR만 지정된 시간에 실행할 수 있습니다. 단일 계획 CR에 대해 여러 마이그레이션 CR을 생성할 수 있습니다.

9.3.2. MTV 서비스
링크 복사

  • 인벤토리 서비스는 다음 작업을 수행합니다.

    • 소스 및 대상 공급자에 연결합니다.
    • 매핑 및 계획을 위한 로컬 인벤토리를 유지 관리합니다.
    • VM 구성을 저장합니다.
    • VM 구성 변경이 감지되면 유효성 검사 서비스를 실행합니다.
  • 유효성 검사 서비스는 규칙을 적용하여 마이그레이션을 위한 VM의 적합성을 확인합니다.

  • Migration Controller 서비스는 마이그레이션을 오케스트레이션합니다.

    마이그레이션 계획을 생성할 때 Migration Controller 서비스는 계획의 유효성을 검사하고 status 레이블을 추가합니다. 계획 검증에 실패하면 계획 상태가 Not ready 이고 마이그레이션을 수행하는 데 계획을 사용할 수 없습니다. 계획이 검증을 통과하면 계획 상태가 Ready 이며 마이그레이션을 수행하는 데 사용할 수 있습니다. 마이그레이션에 성공하면 Migration Controller 서비스가 계획 상태를 Completed 로 변경합니다.

  • Populator Controller 서비스는 Volume Populators를 사용하여 디스크 전송을 오케스트레이션합니다.
  • Kubevirt 컨트롤러 및 CDI(Containerized Data Import) 컨트롤러 서비스는 대부분의 기술 작업을 처리합니다.

9.4. 고급 마이그레이션 워크플로
링크 복사

상위 수준 워크플로는 사용자 관점에서 마이그레이션 프로세스를 보여줍니다.

  1. 소스 공급자, 대상 공급자, 네트워크 매핑 및 스토리지 매핑을 생성합니다.

  2. 다음 리소스가 포함된 Plan CR(사용자 정의 리소스)을 생성합니다.

    • 소스 제공자
    • 대상 공급자( MTV가 대상 클러스터에 설치되지 않은 경우)
    • 네트워크 매핑
    • 스토리지 매핑
    • 하나 이상의 VM(가상 머신)

  3. Plan CR을 참조하는 Migration CR을 생성하여 마이그레이션 계획을 실행합니다.

    어떠한 이유로든 모든 VM을 마이그레이션할 수 없는 경우 모든 VM이 마이그레이션될 때까지 동일한 Plan CR에 대해 여러 개의 Migration CR을 생성할 수 있습니다.

  4. Plan CR의 각 VM에 대해 Migration Controller 서비스는 Migration CR의 VM 마이그레이션 진행 상황을 기록합니다.

  5. Plan CR의 각 VM의 데이터 전송이 완료되면 Migration Controller 서비스에서 VirtualMachine CR을 생성합니다.

    모든 VM이 마이그레이션되면 Migration Controller 서비스는 Plan CR의 상태를 Completed 로 업데이트합니다. 각 소스 VM의 전원 상태는 마이그레이션 후 유지됩니다.

9.4.1. 자세한 마이그레이션 워크플로
링크 복사

자세한 마이그레이션 워크플로를 사용하여 마이그레이션 실패 문제를 해결할 수 있습니다.

워크플로우는 다음 단계를 설명합니다.

원격 OpenShift 클러스터의 웜 마이그레이션 또는 마이그레이션:

  1. 마이그레이션 계획을 실행하기 위해 마이그레이션 CR(사용자 정의 리소스)을 생성하면 Migration Controller 서비스에서 각 소스 VM 디스크에 대한 DataVolume CR을 생성합니다.

    각 VM 디스크의 경우:

  2. CDI(Containerized Data Importer) 컨트롤러 서비스는 DataVolume CR에 지정된 매개변수를 기반으로 PVC(영구 볼륨 클레임)를 생성합니다.
  3. StorageClass 에 동적 프로비저너가 있는 경우 StorageClass 프로비전 프로그램에 의해 PV(영구 볼륨)가 동적으로 프로비저닝됩니다.
  4. CDI 컨트롤러 서비스는 가져오기 Pod를 생성합니다.

  5. 가져오기 Pod는 VM 디스크를 PV로 스트리밍합니다.

    VM 디스크가 전송된 후 다음을 수행합니다.

  6. Migration Controller 서비스는 VMware에서 가져올 때 연결된 PVC를 사용하여 변환 Pod를 생성합니다.

    변환 Pod는 virt-v2v 를 실행하여 대상 VM의 PVC에 장치 드라이버를 설치하고 구성합니다.

  7. Migration Controller 서비스는 PVC에 연결된 각 소스 VM(가상 머신)에 대한 VirtualMachine CR을 생성합니다.

  8. VM이 소스 환경에서 실행된 경우 마이그레이션 컨트롤러는 VM의 전원을 켜면 KubeVirt 컨트롤러 서비스에서 virt-launcher Pod 및 VirtualMachineInstance CR을 생성합니다.

    virt-launcher Pod는 VM 디스크로 연결된 PVC를 사용하여 QEMU-KVM 을 실행합니다.

RHV 또는 OpenStack에서 로컬 OpenShift 클러스터로 콜드 마이그레이션:

  1. 마이그레이션 계획을 실행하기 위해 Migration Controller(사용자 정의 리소스)를 생성할 때 Migration Controller 서비스는 PersistentVolumeClaim CR 각 소스 VM 디스크에 대해 생성되며 소스가 RHV일 때 OvirtVolumePopulator CR 또는 소스가 OpenStack인 경우 OpenstackVolumePopulator CR을 생성합니다.

    각 VM 디스크의 경우:

  2. Populat or 컨트롤러 서비스는 임시 PVC(영구 볼륨 클레임)를 생성합니다.

  3. StorageClass 에 동적 프로비저너가 있는 경우 StorageClass 프로비전 프로그램에 의해 PV(영구 볼륨)가 동적으로 프로비저닝됩니다.

    • Migration Controller 서비스는 모든 PVC 를 바인딩할 더미 Pod를 생성합니다. Pod 이름에 pvcinit 가 포함되어 있습니다.
  4. Populator Controller 서비스는 팝업 Pod 를 생성합니다.

  5. 팝업 Pod 는 디스크 데이터를 PV로 전송합니다.

    VM 디스크가 전송된 후 다음을 수행합니다.

  6. 임시 PVC가 삭제되고 초기 PVC는 데이터와 함께 PV를 가리킵니다.
  7. Migration Controller 서비스는 PVC에 연결된 각 소스 VM(가상 머신)에 대한 VirtualMachine CR을 생성합니다.

  8. VM이 소스 환경에서 실행된 경우 마이그레이션 컨트롤러는 VM의 전원을 켜면 KubeVirt 컨트롤러 서비스에서 virt-launcher Pod 및 VirtualMachineInstance CR을 생성합니다.

    virt-launcher Pod는 VM 디스크로 연결된 PVC를 사용하여 QEMU-KVM 을 실행합니다.

VMware에서 로컬 OpenShift 클러스터로 콜드 마이그레이션:

  1. 마이그레이션 계획을 실행하기 위해 마이그레이션 CR(사용자 정의 리소스)을 생성하면 Migration Controller 서비스에서 각 소스 VM 디스크에 대한 DataVolume CR을 생성합니다.

    각 VM 디스크의 경우:

  2. CDI(Containerized Data Importer) 컨트롤러 서비스는 DataVolume CR에 지정된 매개변수를 기반으로 빈 PVC(영구 볼륨 클레임)를 생성합니다.
  3. StorageClass 에 동적 프로비저너가 있는 경우 StorageClass 프로비전 프로그램에 의해 PV(영구 볼륨)가 동적으로 프로비저닝됩니다.

모든 VM 디스크의 경우:

  1. Migration Controller 서비스는 모든 PVC 를 바인딩할 더미 Pod를 생성합니다. Pod 이름에 pvcinit 가 포함되어 있습니다.
  2. Migration Controller 서비스는 모든 PVC에 대한 변환 Pod를 생성합니다.

  3. 변환 Pod는 virt-v2v 를 실행하여 VM을 KVM 하이퍼바이저로 변환하고 디스크의 데이터를 해당 PV로 전송합니다.

    VM 디스크가 전송된 후 다음을 수행합니다.

  4. Migration Controller 서비스는 PVC에 연결된 각 소스 VM(가상 머신)에 대한 VirtualMachine CR을 생성합니다.

  5. VM이 소스 환경에서 실행된 경우 마이그레이션 컨트롤러는 VM의 전원을 켜면 KubeVirt 컨트롤러 서비스에서 virt-launcher Pod 및 VirtualMachineInstance CR을 생성합니다.

    virt-launcher Pod는 VM 디스크로 연결된 PVC를 사용하여 QEMU-KVM 을 실행합니다.

9.4.2. MTV에서 virt-v2v 툴을 사용하는 방법
링크 복사

MCP(Migration Toolkit for Virtualization)는 virt-v2v 툴을 사용하여 VM(가상 머신)의 디스크 이미지를 OpenShift Virtualization과 호환되는 형식으로 변환합니다. 이 툴을 사용하면 VM이 OpenShift Virtualization에서 작동하도록 하는 데 필요한 작업을 자동으로 수행하기 때문에 마이그레이션이 더 쉬워집니다. 예를 들어 가능한 경우 변환된 VM에서 반가상화 VirtIO 드라이버를 활성화하고 QEMU 게스트 에이전트를 설치합니다.

virt-v2v 는 RHEL(Red Hat Enterprise Linux) 버전 7 이상에 포함되어 있습니다.

9.4.2.1. MTV 마이그레이션에서 virt-v2v의 주요 기능
링크 복사

마이그레이션 중에 MTV는 virt-v2v 를 사용하여 VM에 대한 메타데이터를 수집하고, VM 디스크에 필요한 변경을 수행하고, VM이 포함된 디스크를 OpenShift Virtualization에 복사합니다.

virt-v2v 는 VM 디스크를 다음과 같이 변경하여 마이그레이션을 준비합니다.

  • 추가 사항:

    • VirtIO 드라이버(예: 네트워크 또는 디스크 드라이버)
    • 하이퍼바이저별 툴 또는 에이전트 준비(예: QEMU 게스트 에이전트 설치).
    • 부팅 구성 수정 (예: 부트 로더 또는 부팅 항목).

  • 제거:

    • 불필요한 또는 이전 하이퍼바이저별 파일(예: VMware 툴 또는 Cryostat 추가)
    • 예를 들어 이전 네트워크 드라이버 구성(예: VMware별 NIC 드라이버 제거)
    • 대상 시스템과 호환되지 않는 구성 설정(예: 이전 부팅 설정)

VMware 또는 OVA(Open Virtual Appliances) 파일에서 마이그레이션하는 경우 virt-v2v 는 마이그레이션 중 또는 마이그레이션 후 VM을 처음 재부팅하는 동안 IP 주소를 설정합니다. s

참고

MTV를 사용하여 마이그레이션 전후에 사전 정의된 Ansible 후크를 실행할 수도 있습니다. 자세한 내용은 MTV 마이그레이션 계획에 후크 추가를 참조하십시오.

이러한 후크는 virt-v2v 를 사용할 필요가 없습니다.

9.4.2.2. 파일 사용자 정의, 제거 및 설치
링크 복사

MTV는 virt-v2v 를 사용하여 변환 중에 다음 동작과 같이 추가 게스트 사용자 정의를 수행합니다.

  • IP 주소를 유지하기 위한 사용자 정의
  • 드라이브 문자를 유지하기 위한 사용자 정의
참고

RHEL(Red Hat Enterprise Linux) 기반 게스트의 경우 virt-v2v 는 Red Hat 레지스트리에서 게스트 에이전트를 설치하려고 합니다. 마이그레이션이 분리된 환경에서 실행되는 경우 설치 프로그램이 실패하고 후크 또는 기타 자동화를 사용하여 게스트 에이전트를 설치해야 합니다.

자세한 내용은 도움말 참조 페이지를 참조하십시오.

9.4.2.3. 권한 및 virt-v2v
링크 복사

virt-v2v 는 실행 중인 VM에 대해 실행되지 않고 VM의 디스크에만 실행되기 때문에 virt-v2v 에는 게스트 운영 체제 자체에 대한 권한 또는 액세스 인증 정보가 필요하지 않습니다.

9.5. 수집된 로그 및 사용자 정의 리소스 정보
링크 복사

Red Hat OpenShift 웹 콘솔 또는 CLI(명령줄 인터페이스)를 사용하여 다음 대상에 대한 로그 및 CR(사용자 정의 리소스) yaml 파일을 다운로드할 수 있습니다.

  • 마이그레이션 계획: 웹 콘솔 또는 CLI.
  • 가상 머신: 웹 콘솔 또는 CLI.
  • 네임스페이스: CLI만 해당

must-gather 툴은 아카이브 파일에서 다음 로그 및 CR 파일을 수집합니다.

  • CRs:

    • DataVolume CR: 마이그레이션된 VM에 마운트된 디스크를 나타냅니다.
    • VirtualMachine CR: 마이그레이션된 VM을 나타냅니다.
    • CR 계획: VM 및 스토리지 및 네트워크 매핑을 정의합니다.
    • 작업 CR: 선택 사항: 사전 마이그레이션 후크, 마이그레이션 후 후크 또는 둘 다를 나타냅니다.

  • 로그:

    • Importer pod: Disk-to-data-volume 변환 로그 가져오기 Pod 이름 지정 규칙은 importer-<migration_plan>-<vm_id><5_char_id >입니다(예: importer-mig-plan-ed90dfc6-9a17-4a17-4anfh. 여기서 ed90dfc6-9a17-4a17-4a8 은 잘린 RHV VM ID이고 btnfh 는 생성된 5자 ID입니다.
    • 변환 pod: VM 변환 로그. 변환 Pod는 virt-v2v 를 실행하여 VM의 PVC에 장치 드라이버를 설치하고 구성합니다. 변환 Pod 이름 지정 규칙은 < migration_plan>-<vm_id><5_char_id >입니다.
    • virt-launcher Pod: VM 시작 관리자 로그. 마이그레이션된 VM의 전원이 켜지면 virt-launcher Pod는 VM 디스크로 연결된 PVC를 사용하여 QEMU-KVM 을 실행합니다.
    • Forklift-controller Pod: must-gather 명령으로 지정된 마이그레이션 계획, 가상 머신 또는 네임스페이스에 대해 로그가 필터링됩니다.
    • Forklift-must-gather-api Pod: must-gather 명령으로 지정된 마이그레이션 계획, 가상 머신 또는 네임스페이스에 대해 로그가 필터링됩니다.

    • hook-job pod: 로그는 후크 작업으로 필터링됩니다. hook-job 이름 지정 규칙은 < migration_plan>-<vm_id><5_char_id >입니다(예: plan2j-vm-3696-posthook-4mx85 또는 plan2j-vm-3696-mwqnl ).

      참고

      must-gather 아카이브 파일에 비어 있거나 제외된 로그 파일이 포함되지 않습니다.

VMware 마이그레이션 계획에 대한 must-gather 아카이브 구조의 예

must-gather
└── namespaces
    ├── target-vm-ns
    │   ├── crs
    │   │   ├── datavolume
    │   │   │   ├── mig-plan-vm-7595-tkhdz.yaml
    │   │   │   ├── mig-plan-vm-7595-5qvqp.yaml
    │   │   │   └── mig-plan-vm-8325-xccfw.yaml
    │   │   └── virtualmachine
    │   │       ├── test-test-rhel8-2disks2nics.yaml
    │   │       └── test-x2019.yaml
    │   └── logs
    │       ├── importer-mig-plan-vm-7595-tkhdz
    │       │   └── current.log
    │       ├── importer-mig-plan-vm-7595-5qvqp
    │       │   └── current.log
    │       ├── importer-mig-plan-vm-8325-xccfw
    │       │   └── current.log
    │       ├── mig-plan-vm-7595-4glzd
    │       │   └── current.log
    │       └── mig-plan-vm-8325-4zw49
    │           └── current.log
    └── openshift-mtv
        ├── crs
        │   └── plan
        │       └── mig-plan-cold.yaml
        └── logs
            ├── forklift-controller-67656d574-w74md
            │   └── current.log
            └── forklift-must-gather-api-89fc7f4b6-hlwb6
                └── current.log
Copy to Clipboard Toggle word wrap

9.5.1. 웹 콘솔에서 로그 및 사용자 정의 리소스 정보 다운로드
링크 복사

Red Hat OpenShift 웹 콘솔에서 완료, 실패 또는 취소된 마이그레이션 계획 또는 마이그레이션된 VM(가상 머신)의 로그 및 정보를 다운로드할 수 있습니다.

프로세스

  1. Red Hat OpenShift 웹 콘솔에서 마이그레이션 → 가상화 계획을 클릭합니다.
  2. 마이그레이션 계획 이름 옆에 있는 로그 가져오기를 클릭합니다.

  3. 로그 가져오기 창에서 로그 가져오기 를 클릭합니다.

    로그가 수집됩니다. 로그 컬렉션 전체 메시지가 표시됩니다.

  4. 로그 다운로드를 클릭하여 아카이브 파일을 다운로드합니다.
  5. 마이그레이션된 VM의 로그를 다운로드하려면 마이그레이션 계획 이름을 클릭한 다음 VM 옆에 있는 로그 가져오기를 클릭합니다.

9.5.2. 명령줄에서 로그 및 사용자 정의 리소스 정보에 액세스
링크 복사

must-gather 툴을 사용하여 명령줄에서 사용자 정의 리소스(CR)에 대한 로그 및 정보에 액세스할 수 있습니다. must-gather 데이터 파일을 모든 고객 사례에 연결해야 합니다.

필터링 옵션을 사용하여 특정 네임스페이스, 완료, 실패 또는 취소된 마이그레이션 계획 또는 마이그레이션된 VM(가상 머신)에 대한 데이터를 수집할 수 있습니다.

참고

필터링된 must-gather 명령에 존재하지 않는 리소스를 지정하는 경우 아카이브 파일이 생성되지 않습니다.

사전 요구 사항

  • cluster-admin 역할의 사용자로 OpenShift Virtualization 클러스터에 로그인해야 합니다.
  • Red Hat OpenShift CLI(oc) 가 설치되어 있어야 합니다.

프로세스

  1. must-gather 데이터를 저장하려는 디렉터리로 이동합니다.

  2. oc adm must-gather 명령을 실행합니다. 

    $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0
    Copy to Clipboard Toggle word wrap

    데이터는 /must-gather/must-gather.tar.gz로 저장됩니다. Red Hat 고객 포털에서 해당 지원 사례에 이 파일을 업로드할 수 있습니다.

  3. 선택 사항: oc adm must-gather 명령을 다음 옵션과 함께 실행하여 필터링된 데이터를 수집합니다.

    • namespace: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- NS=<namespace> /usr/bin/targeted
      Copy to Clipboard Toggle word wrap

    • 마이그레이션 계획: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- PLAN=<migration_plan> /usr/bin/targeted
      Copy to Clipboard Toggle word wrap

    • 가상 머신: 

      $ oc adm must-gather --image=registry.redhat.io/migration-toolkit-virtualization/mtv-must-gather-rhel8:2.10.0 \
  -- VM=<vm_name> NS=<namespace> /usr/bin/targeted
      1
      Copy to Clipboard Toggle word wrap
      1
      Plan CR에 표시되는 VM ID가 아닌 VM 이름을 지정해야 합니다.

10장. MTV 성능 권장 사항
링크 복사

네트워크 및 스토리지 성능, 콜드 및 웜 마이그레이션, 여러 마이그레이션 또는 단일 마이그레이션에 대한 권장 사항을 검토합니다.

10.1. MTV 성능 권장 사항
링크 복사

이 섹션의 목적은 테스트를 통해 관찰된 결과에 따라 MCP(Migration Toolkit for Virtualization)를 사용하여 VM(가상 머신)의 효율적이고 효과적인 마이그레이션을 위한 권장 사항을 공유하는 것입니다.

여기에 제공된 데이터는 Red Hat 랩의 테스트에서 수집되었으며 참조용으로만 제공됩니다. 

전반적으로 이러한 숫자는 최상의 시나리오를 표시하도록 고려해야 합니다.

마이그레이션의 성능은 이러한 결과와 다를 수 있으며 여러 요인에 따라 달라집니다.

10.1.1. 빠른 스토리지 및 네트워크 속도 보장
링크 복사

VMware 및 Red Hat OpenShift(OCP) 환경 모두에 대해 빠른 스토리지 및 네트워크 속도를 보장합니다.

  • 빠른 마이그레이션을 수행하려면 VMware가 데이터 저장소에 대한 빠른 읽기 액세스 권한이 있어야 합니다. VMware ESXi 호스트 간의 네트워킹은 빨라야 하며 10GiB 네트워크 연결을 확인하고 네트워크 병목 현상을 방지해야 합니다.

    • VMware 네트워크를 OCP 작업자 인터페이스 네트워크 환경으로 확장합니다.
    • VMware 네트워크가 높은 처리량(10Gigabit Ethernet) 및 빠른 네트워킹을 제공하여 수신 속도가 ESXi 데이터 저장소의 읽기 속도와 일치하도록 하는 것이 중요합니다.
    • 마이그레이션 프로세스에서는 상당한 네트워크 대역폭을 사용하고 마이그레이션 네트워크가 활용된다는 점에 유의하십시오. 다른 서비스에서 해당 네트워크를 사용하는 경우 해당 서비스와 마이그레이션 속도에 영향을 줄 수 있습니다.
    • 예를 들어 200에서 325MiB/s는 OCP 인터페이스로 데이터를 전송하는 것과 관련된 각 ESXi 호스트에 대한 vmnic 의 평균 네트워크 전송 속도였습니다.

데이터 저장소 읽기 속도는 총 전송 시간에 영향을 미치므로 ESXi 데이터 저장소에서 ESXi 호스트로 빠른 읽기를 가능하게 하는 것이 중요합니다.  

예: 200~300MiB/s는 단일 ESXi 서버의 vSphere 및 ESXi 끝점 모두에 대한 평균 읽기 속도였습니다. 여러 ESXi 서버를 사용하면 데이터 저장소 읽기 속도가 높을 수 있습니다.

10.1.3. 끝점 유형 
링크 복사

MTV 2.6에서는 다음 vSphere 공급자 옵션을 사용할 수 있습니다.

  • MTV 2.6에 도입된 ESXi 엔드포인트( ESXi에서 인벤토리 및 디스크 전송)
  • vCenter Server 엔드포인트; ESXi 호스트용 네트워크 없음( vCenter에서 인벤토리 및 디스크 전송)
  • vCenter 엔드포인트 및 ESXi 네트워크를 사용할 수 있습니다( vCenter의 인벤토리, ESXi에서 디스크 전송).

여러 ESXi 호스트에 등록된 많은 VM을 전송하는 경우 vCenter 엔드포인트 및 ESXi 네트워크를 사용하는 것이 좋습니다.

참고

vSphere 7.0에서 ESXi 호스트는 NBD(Network Block Device) 전송에 사용할 네트워크에 레이블을 지정할 수 있습니다. 이 작업은 적절한 vSphereBackupNFC 라벨을 사용하여 원하는 NIC(가상 네트워크 인터페이스 카드)를 태그하여 수행됩니다. 이 작업이 완료되면 작업자 및 ESXi 호스트 인터페이스에 연결할 수 있는 경우 MTV는 OpenShift로 네트워크 전송에 ESXi 인터페이스를 사용할 수 있습니다. 이는 마이그레이션 사용자가 ESXi 자격 증명에 액세스할 수 없지만 마이그레이션에 사용되는 ESXi 인터페이스를 제어하려는 경우 특히 유용합니다. 

자세한 내용은 (MTV-1230)를 참조하십시오.

NBD 백업의 인터페이스 vmk2 를 지정하는 다음 ESXi 명령을 사용할 수 있습니다. 

esxcli network ip interface tag add -t vSphereBackupNFC -i vmk2
Copy to Clipboard Toggle word wrap

가능한 경우 마이그레이션 수행에 사용되는 호스트가 최대 성능과 관련된 BIOS 프로필로 설정되어 있는지 확인합니다. vSphere에서 제어되는 Host Power Management를 사용하는 호스트는 High Performance 가 설정되어 있는지 확인해야 합니다.

테스트 결과 BIOS 및 호스트 전원 관리 세트를 모두 사용하여 VM 10개를 전송할 때 마이그레이션은 평균 데이터 저장소 읽기 속도에서 15MiB를 늘렸습니다.

10.1.5. VMware 네트워크에서 추가 네트워크 로드 방지
링크 복사

ESXi 엔드포인트를 사용할 때 마이그레이션 네트워크를 선택하여 VMware 네트워크에서 네트워크 부하를 줄일 수 있습니다.

MTV는 가상화 공급자를 통합하여 가상 머신을 OpenShift로 마이그레이션하기 위해 ESXi 호스트에서 액세스할 수 있는 특정 네트워크를 선택할 수 있습니다. MTV UI의 ESXi 호스트에서 이 마이그레이션 네트워크를 선택하면 선택한 네트워크를 ESXi 엔드포인트로 사용하여 전송이 수행됩니다.

선택한 네트워크가 OCP 인터페이스에 연결되어 있고, 마이그레이션에 적합한 대역폭이 있고, 네트워크 인터페이스가 포화되지 않도록 하는 것이 중요합니다.

10GbE 네트워크와 같은 빠른 네트워크가 있는 환경에서는 마이그레이션 네트워크가 ESXi 데이터 저장소 읽기 비율과 일치할 것으로 예상할 수 있습니다.

10.1.6. ESXi 호스트당 최대 동시 디스크 마이그레이션 제어
링크 복사

MAX_VM_INFLIGHT MTV 변수를 설정하여 ESXi 호스트에 허용되는 최대 동시 VM 전송 수를 제어합니다. 

MTV를 사용하면 이 변수를 사용하여 동시성을 제어할 수 있습니다. 기본적으로 20으로 설정됩니다.

MAX_VM_INFLIGHT 을 설정하는 경우 ESXi 호스트에 대해 최대 동시 VM 전송 수를 고려해야 합니다. 동시에 전송될 마이그레이션 유형을 고려해야 합니다. 예약된 시간 동안 마이그레이션할 실행 중인 VM의 마이그레이션으로 정의된 웜 마이그레이션입니다.

웜 마이그레이션은 스냅샷을 사용하여 이전 디스크 스냅샷 간의 차이점만 비교하고 마이그레이션합니다. 스냅샷 간의 차이점에 대한 마이그레이션은 실행 중인 VM을 OpenShift로 완전히 제거하기 전에 특정 간격으로 수행됩니다. 

MTV 2.6에서 MAX_VM_INFLIGHT 은 특정 스냅샷의 현재 마이그레이션 활동이나 단일 VM에 속한 디스크 수에 관계없이 VM당 하나의 전송 슬롯을 예약합니다. MAX_VM_INFLIGHT 에 의해 설정된 총 세트는 ESXi 호스트당 동시 VM 트랜퍼 수를 나타내는 데 사용됩니다.

예

  • MAX_VM_INFLIGHT = 20 및 2 ESXi 호스트는 각 호스트가 20개의 VM을 전송할 수 있음을 의미합니다.

특정 ESXi 호스트의 여러 VM을 마이그레이션해야 하는 경우 여러 VM의 동시 마이그레이션을 시작하면 마이그레이션 시간이 단축됩니다. 

테스트 결과 단일 호스트에서 총 크기가 50GiB인 VM 10개를 마이그레이션하는 것이 동일한 수의 VM을 순차적으로 마이그레이션하는 것보다 훨씬 빠릅니다. 

단일 호스트에서 10개 이상의 가상 시스템으로 동시 마이그레이션을 늘릴 수 있지만 상당한 개선은 표시되지 않습니다. 

예

  • 단일 디스크 VM 1개에 6분이 소요되었으며 마이그레이션 속도는 100MiB/s입니다.
  • 10개의 단일 디스크 VM은 22분이 소요되었으며 마이그레이션 속도는 272MiB/s입니다.
  • 20개의 단일 디스크 VM이 42분 정도 소요되었으며 마이그레이션 속도는 284MiB/s입니다.
참고

앞서 언급한 예에서 10개의 가상 머신의 마이그레이션이 동일한 가상 시스템의 마이그레이션보다 순차적으로 3배 더 빠릅니다.

10개 또는 20개의 가상 머신을 동시에 이동할 때 마이그레이션 속도가 거의 동일했습니다.

10.1.8. 여러 호스트를 사용하여 마이그레이션 완료
링크 복사

마이그레이션에 사용되는 ESXi 호스트 간에 등록된 VM과 함께 여러 호스트를 사용하면 마이그레이션 시간이 단축됩니다.

테스트 결과 10개 이상의 단일 디스크 VMS를 전송할 때 각각 총 50G 중 35GiB의 데이터가 포함되어 추가 호스트를 사용하면 마이그레이션 시간을 줄일 수 있습니다.

예

  • 단일 호스트를 사용하여 각각 35GiB의 데이터를 포함하는 80개의 단일 디스크 VM은 마이그레이션 속도 294MiB/s입니다.
  • 8 ESXi 호스트를 사용하여 각각 35GiB의 데이터를 포함하는 단일 디스크 VM은 마이그레이션 속도가 1,173MiB/s인 41분이 걸렸습니다.
참고

앞서 언급한 예에서 8 ESXi 호스트에서 VM 80개를 마이그레이션하는 것은 각 호스트에서 10개의 VM을 동시에 마이그레이션하는 것이 단일 ESXi 호스트에서 동일한 VM을 실행하는 것보다 4배 빠른 속도입니다. 

동시에 8개 이상의 ESXi 호스트에서 VM을 마이그레이션하면 성능이 향상될 수 있습니다. 그러나 이 테스트는 테스트되지 않았으므로 권장되지 않습니다.

단일 마이그레이션 계획에서 참조할 수 있는 최대 디스크 수는 500개입니다. 자세한 내용은 (MTV-1203) 을 참조하십시오. 

단일 마이그레이션 계획에서 많은 VM을 마이그레이션하려고 할 때 모든 마이그레이션을 시작하는 데 시간이 걸릴 수 있습니다. 하나의 마이그레이션 계획을 여러 마이그레이션 계획으로 분할하면 동시에 시작할 수 있습니다.

마이그레이션 비교:

  • 1개의 계획으로 8 ESXi 호스트를 사용하는 500개의 VM, max_vm_inflight=100.
  • 8개의 계획이 있는 8개의 ESXi 호스트를 사용하는 800개의 VM, max_vm_inflight=100, 57분 정도 걸립니다.

테스트 결과, 하나의 대규모 계획을 계획당 100개의 VM을 사용하여 여러 가지 조정된 계획으로 분리함으로써 총 마이그레이션 시간을 줄일 수 있습니다.

10.1.10. 콜드 마이그레이션에 대해 테스트된 최대 값
링크 복사

  • 테스트된 최대 ESXi 호스트 수: 8
  • 단일 마이그레이션 계획의 최대 VM 수: 500
  • 단일 테스트에서 마이그레이션된 최대 VM 수: 5000
  • 동시에 수행되는 최대 마이그레이션 계획 수: 40
  • 마이그레이션된 최대 단일 디스크 크기: 3TB의 데이터가 포함된 6TB 디스크
  • 단일 VM의 최대 디스크 수: 50
  • 단일 ESXi 서버에서 관찰된 최대 단일 데이터 저장소 읽기 속도: 312MiB/초
  • 8개의 ESXi 서버와 두 개의 데이터 저장소를 사용하여 가장 많이 관찰된 멀티 데이터 저장소 읽기 속도: 1,242MiB/초
  • 가장 많이 관찰된 가상 NIC 전송률을 OpenShift 작업자로 전송: 327MiB/초
  • 단일 디스크의 최대 마이그레이션 전송 속도: 162MiB/초(동시가 아닌 마이그레이션의 1.5TB 사용 데이터 전송 시 관찰됨)
  • 단일 ESXi 호스트에서 여러 VM(단일 디스크)의 최대 콜드 마이그레이션 속도: 294MiB/s(Single ESXi에서 사용되는 30개의 VM, 35/50GiB의 마이그레이션)
  • 여러 ESXi 호스트의 여러 VM(단일 디스크)의 최대 콜드 마이그레이션 속도: 1173MB/s(현재 80개의 VM, 35/50GiB, 각 ESXi에서 VM 10개)

10.1.11. 웜 마이그레이션 권장 사항
링크 복사

다음 권장 사항은 웜 마이그레이션에 따라 다릅니다.

  • 병렬로 최대 400개의 디스크 마이그레이션

총 400개의 디스크에 대해 각각 8 ESXi 호스트를 사용하는 디스크 2개를 사용하여 병렬로 200개의 VM 마이그레이션과 관련된 테스트입니다. 400개 이상의 디스크를 병렬로 마이그레이션하는 마이그레이션 계획에서는 테스트가 실행되지 않았으므로 이 디스크 수를 병렬로 마이그레이션하는 것은 권장되지 않습니다.

  • 가장 빠른 속도를 위해 최대 200개의 디스크를 병렬로 마이그레이션

200, 300 및 400개의 디스크가 있는 병렬 디스크 마이그레이션에서 테스트가 성공적으로 수행되었습니다. 200개의 디스크를 마이그레이션하는 테스트와 300개와 400개의 디스크를 마이그레이션하는 테스트 사이에 사전 마이그레이션 속도가 약 25% 감소했습니다.

따라서 사전 복사 속도에서 25%를 감소해도 컷오버 계획에 영향을 미치지 않는 한 300개에서 400개의 디스크로 구성된 200 이하의 그룹에서 병렬 디스크 마이그레이션을 수행하는 것이 좋습니다.

  • 가능한 경우 마이그레이션 계획이 시작된 직후에 컷오버 시간을 설정합니다.

웜 마이그레이션의 전체 시간을 줄이려면 마이그레이션 계획을 시작한 직후 컷오버를 발생하도록 설정하는 것이 좋습니다. 이로 인해 MTV는 VM당 하나의 사전 복사만 실행됩니다. 이 권장 사항은 마이그레이션 계획에 있는 VM 수에 관계없이 유효합니다.

  • 스냅샷 간 사전 복사 간격 증가

단일 VM을 사용하여 많은 마이그레이션 계획을 생성하고 마이그레이션 시작과 컷오버 사이에 충분한 시간이 있는 경우 controller_precopy_interval 매개변수의 값을 120분에서 240분으로 늘립니다. 설정이 길수록 컷오버 전에 VM당 총 스냅샷 및 디스크 전송 수가 줄어듭니다.

10.1.12. 웜 마이그레이션을 위해 테스트된 최대 값
링크 복사

  • 테스트된 최대 ESXi 호스트 수: 8
  • 최대 작업자 노드 수: 12
  • 단일 마이그레이션 계획의 최대 VM 수: 200
  • 최대 총 병렬 디스크 전송 수: 400개, VM 200개, ESXi 6개, 전송 속도 667MB/s
  • 마이그레이션된 최대 단일 디스크 크기: 3TB의 데이터가 포함된 6TB 디스크
  • 단일 VM의 최대 디스크 수: 3
  • ESXi 호스트당 최대 병렬 디스크 전송 수: 68
  • 동시 마이그레이션이 없는 단일 디스크의 최대 전송 속도: 76.5MB/s
  • 단일 ESXi 호스트에서 여러 디스크의 최대 전송 속도: 253MB/s(디스크당 사용된 디스크당 1개 디스크 1개, 디스크당 35/50GiB 마이그레이션)
  • 8 ESXi 호스트의 여러 디스크(210)에서 관찰된 총 전송 속도: 802MB/s(동시 70개의 VM으로의 마이그레이션, 디스크당 3개의 디스크, 디스크당 35/50GiB)

10.1.13. 대규모 디스크로 VM 마이그레이션을 위한 권장 사항
링크 복사

개별 디스크에 대해 총 1TB 이상의 디스크 데이터가 있는 VM에 대해 다음 권장 사항이 권장됩니다.

  • 대용량 VM(가상 머신)을 마이그레이션하기 위한 적절한 유지 관리 기간을 예약합니다. 이러한 마이그레이션은 민감한 작업이며 특히 더 낮은 스토리지 및 네트워크 활동 기간에는 유지 관리 창 및 다운타임을 신중하게 계획해야 할 수 있습니다.
  • 이러한 대규모 VM(가상 머신) 마이그레이션 중에 다른 마이그레이션 활동이나 기타 과도한 네트워크 또는 스토리지 활동이 실행되지 않는지 확인합니다. 이러한 대규모 가상 머신 마이그레이션을 특수한 사례로 처리해야 합니다. 이러한 마이그레이션 중에 MTV 활동 우선 순위를 지정합니다. 해당 VM 및 관련 데이터 저장소에 활동이 적을 때 해당 VM을 마이그레이션할 계획입니다.
  • churn 속도가 높은 대규모 VM의 경우 스냅샷 간에 데이터가 100GB 이상 자주 변경되는 것을 의미하며, 기본값에서 웜 마이그레이션 controller_precopy_interval 을 줄이는 것이 좋습니다. 이는 60분입니다. 이 프로세스가 예약된 컷오버보다 최소 24시간 전에 시작하여 여러 개의 성공적인 사전 복사 스냅샷을 완료할 수 있도록 하는 것이 중요합니다. 컷오버를 예약할 때 유지 관리 창에서 변경 사항의 마지막 스냅샷을 복사할 충분한 시간을 허용하고 해당 유지 관리 기간의 시작 부분에서 컷오버 프로세스가 시작되도록 해야 합니다.
  • 일부 다운타임이 가능한 대규모 단일 디스크 VM의 경우 특히 VM 스냅샷이 큰 경우 웜 마이그레이션 대신 콜드 마이그레이션을 선택합니다.
  • 특히 큰 디스크의 데이터를 여러 디스크에 분할하여 웜 마이그레이션을 사용할 때 MTV를 사용하여 병렬 디스크 마이그레이션을 가능하게 하는 것이 좋습니다.
  • 다운타임 및 VM 스냅샷을 사용할 수 없는 대량의 데이터를 지속적으로 쓰는 데이터베이스 디스크가 있는 경우 MTV 외부의 특정 마이그레이션을 대상으로 하는 데이터베이스 데이터의 데이터베이스 벤더별 복제 옵션을 고려해야 할 수 있습니다. 이 케이스가 적용되는 경우 데이터베이스의 벤더별 옵션을 참조하십시오.

10.1.14. NBD 전송 모드의 AIO 크기 및 버퍼 수 증가
링크 복사

MTV(Migration Toolkit for Virtualization)와 함께 AIO(Asynchronous Input/Output) 버퍼링을 사용할 때 마이그레이션 성능을 높이기 위해 NBD(Network Block Device) 전송 네트워크 파일 복사(NFC) 매개변수를 변경할 수 있습니다.

주의

AIO 버퍼링을 사용하는 것은 콜드 마이그레이션 사용 사례에만 적합합니다.

웜 마이그레이션을 초기화하기 전에 AIO 설정을 비활성화합니다. 자세한 내용은 AIO 버퍼 구성 비활성화를 참조하십시오.

10.1.14.1. 주요 결과
링크 복사

  • 최상의 마이그레이션 성능은 다음 값을 사용하여 단일 ESXi 호스트에서 여러 가상 머신(VM)을 마이그레이션하여 달성되었습니다.

    • VixDiskLib.nfcAio.Session.BufSizeIn64KB=16
    • vixDiskLib.nfcAio.Session.BufCount=4

  • AIO 버퍼 설정(동기 버퍼 수)을 사용할 때 다음과 같은 개선 사항이 기록되었습니다.

    • 마이그레이션 시간이 31.1% 로 단축되었으며 0:24:32에서 0:16:54로 단축되었습니다.
    • 읽기 속도가 347.83MB/s에서 504.93MB/s로 증가했습니다.
  • 단일 VM과 함께 AIO 버퍼 설정을 사용할 때 상당한 개선이 관찰되지 않았습니다.
  • 여러 호스트의 여러 VM과 함께 AIO 버퍼 설정을 사용할 때 상당한 개선이 관찰되지 않았습니다.
10.1.14.2. AIO 크기 및 버퍼 수 지원에 대한 주요 요구 사항
링크 복사

지원은 다음 버전을 사용하여 수행되는 테스트를 기반으로 합니다.

  • vSphere 7.0.3
  • VDDK 7.0.3

10.1.15. AIO 버퍼링 활성화 및 구성
링크 복사

MCP(Migration Toolkit for Virtualization)와 함께 사용할 비동기 입력/출력(AIO) 버퍼링을 활성화하고 구성할 수 있습니다.

프로세스

  1. openshift-mtv 네임스페이스의 forklift-controller Pod가 AIO 버퍼 값을 지원하는지 확인합니다. Pod 이름 접두사가 동적이므로 다음 명령을 실행하여 Pod 이름을 확인합니다. 

    oc get pods -n openshift-mtv | grep forklift-controller | awk '{print $1}'
    Copy to Clipboard Toggle word wrap

    예를 들어 Pod 이름 접두사가 "forklift-controller-667f57c8f8-qllnx"인 경우 출력은 다음과 같습니다. 

    forklift-controller-667f57c8f8-qllnx
    Copy to Clipboard Toggle word wrap

  2. 다음 명령을 실행하여 Pod의 환경 변수를 확인합니다. 

    oc get pod forklift-controller-667f57c8f8-qllnx -n openshift-mtv -o yaml
    Copy to Clipboard Toggle word wrap

  3. 출력에서 다음 행을 확인합니다. 

    ...
\- name: VIRT\_V2V\_EXTRA\_ARGS
\- name: VIRT\_V2V\_EXTRA\_CONF\_CONFIG\_MAP
...
    Copy to Clipboard Toggle word wrap

  4. openshift-mtv 네임스페이스 에서 다음 단계를 수행하여 ForkliftController CR(사용자 정의 리소스)을 편집합니다.

    1. 다음 명령을 실행하여 편집을 위해 ForkliftController CR에 액세스합니다. 

      oc edit forkliftcontroller -n openshift-mtv
      Copy to Clipboard Toggle word wrap

    2. ForkliftController CR의 spec 섹션에 다음 행을 추가합니다. 

      virt_v2v_extra_args: "--vddk-config /mnt/extra-v2v-conf/input.conf"
virt_v2v_extra_conf_config_map: "perf"
      Copy to Clipboard Toggle word wrap

  5. 다음 명령을 실행하여 필요한 구성 맵 perf 를 생성합니다. 

    oc -n openshift-mtv create cm perf
    Copy to Clipboard Toggle word wrap

  6. 원하는 버퍼 구성 값을 Base64로 변환합니다. 예를 들어 16/4의 경우 다음 명령을 실행합니다. 

    echo -e "VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nvixDiskLib.nfcAio.Session.BufCount=4" | base64
    Copy to Clipboard Toggle word wrap

    출력은 다음과 유사합니다. 

    Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=
    Copy to Clipboard Toggle word wrap

  7. 구성 맵 perf 에서 binaryData 섹션에 Base64 문자열을 입력합니다. 예를 들면 다음과 같습니다. 

    apiVersion: v1
kind: ConfigMap
binaryData:
  input.conf: Vml4RGlza0xpYi5uZmNBaW8uU2Vzc2lvbi5CdWZTaXplSW42NEtCPTE2CnZpeERpc2tMaWIubmZjQWlvLlNlc3Npb24uQnVmQ291bnQ9NAo=
metadata:
  name: perf
  namespace: openshift-mtv
    Copy to Clipboard Toggle word wrap
  8. forklift-controller Pod를 다시 시작하여 새 구성을 적용합니다.
  9. VIRT_V2V_EXTRA_ARGS 환경 변수가 업데이트된 설정을 반영하는지 확인합니다.

  10. 마이그레이션 계획을 실행하고 마이그레이션 Pod의 로그를 확인합니다. AIO 버퍼 설정이 매개 변수, 특히 --vddk-config 값으로 전달되는지 확인합니다.

    예를 들어 다음 명령을 실행하는 경우 다음을 수행합니다. 

    exec: /usr/bin/virt-v2v … --vddk-config /mnt/extra-v2v-conf/input.conf
    Copy to Clipboard Toggle word wrap

    debug_level = 4 인 경우 로그에 다음과 유사한 섹션이 포함됩니다. 

    Buffer size calc for 16 value:
(16 * 64 * 1024 = 1048576)
nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAio_OpenSession:
Opening an AIO session.
nbdkit: vddk[1]: debug: [NFC INFO] NfcAioInitSession:
Disabling
read-ahead buffer since the AIO buffer size of 1048576 is >=
the read-ahead buffer size of 65536. Explicitly setting flag
'`NFC_AIO_SESSION_NO_NET_READ_AHEAD`'
nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAioInitSession: AIO Buffer Size is 1048576
nbdkit: vddk[1]: debug: [NFC VERBOSE] NfcAioInitSession: AIO Buffer
Count is 4
    Copy to Clipboard Toggle word wrap

  11. 올바른 구성 맵 값이 마이그레이션 Pod에 있는지 확인합니다. 마이그레이션 Pod에 로그인하고 다음 명령을 실행하여 이 작업을 수행합니다. 

    cat /mnt/extra-v2v-conf/input.conf
    Copy to Clipboard Toggle word wrap

    출력 예는 다음과 같습니다. 

    VixDiskLib.nfcAio.Session.BufSizeIn64KB=16
vixDiskLib.nfcAio.Session.BufCount=4
    Copy to Clipboard Toggle word wrap

  12. 선택 사항: 다음 명령을 실행하여 디버그 로그를 활성화합니다. 이 명령은 높은 로그 수준을 포함하여 구성을 Base64로 변환합니다. 

    echo -e
"`VixDiskLib.nfcAio.Session.BufSizeIn64KB=16\nVixDiskLib.nfcAio.Session.BufCount=4\nVixDiskLib.nfc.LogLevel=4`"
| base64
    Copy to Clipboard Toggle word wrap
    참고

    높은 로그 수준을 추가하면 성능이 저하되고 디버깅 목적으로만 사용됩니다.

10.1.16. AIO 버퍼링 비활성화
링크 복사

MCP(Migration Toolkit for Virtualization)를 사용하여 콜드 마이그레이션에 대한 AIO 버퍼링을 비활성화할 수 있습니다. MTV를 사용하여 웜 마이그레이션에 대해 AIO 버퍼링을 비활성화해야 합니다.

참고

다음 절차에서는 AIO 버퍼링 활성화 및 구성의 절차에 따라 AIO 버퍼링 이 활성화되고 구성되어 있다고 가정합니다.

프로세스

  1. openshift-mtv 네임스페이스 에서 다음 단계를 수행하여 ForkliftController CR(사용자 정의 리소스)을 편집합니다.

    1. 다음 명령을 실행하여 편집을 위해 ForkliftController CR에 액세스합니다. 

      oc edit forkliftcontroller -n openshift-mtv
      Copy to Clipboard Toggle word wrap

    2. ForkliftController CR의 spec 섹션에서 다음 행을 제거합니다. 

      virt_v2v_extra_args: "`–vddk-config /mnt/extra-v2v-conf/input.conf`"
virt_v2v_extra_conf_config_map: "`perf`"
      Copy to Clipboard Toggle word wrap

  2. perf 라는 구성 맵을 삭제합니다. 

    oc delete cm perf -n openshift-mtv
    Copy to Clipboard Toggle word wrap
  3. 선택 사항: forklift-controller Pod를 다시 시작하여 변경 사항이 적용되었는지 확인합니다.

10.2. MTV 성능 애드온
링크 복사

여기에 제공된 데이터는 Red Hat 랩의 테스트에서 수집되었으며 참조용으로만 제공됩니다. 

전반적으로 이러한 숫자는 최상의 시나리오를 표시하도록 고려해야 합니다.

마이그레이션의 성능은 이러한 결과와 다를 수 있으며 여러 요인에 따라 달라집니다.

11장. telemetry
링크 복사

Red Hat은 Telemetry를 사용하여 MTV의 유용성과 효율성을 개선하는 데 도움이 되도록 MTV(Migration Toolkit for Virtualization) 설치에서 익명 사용 데이터를 수집합니다.

MTV는 다음 데이터를 수집합니다.

  • 마이그레이션 계획 상태: 마이그레이션의 수입니다. 실패, 성공 또는 취소된 항목을 포함합니다.
  • 공급자: 공급자당 마이그레이션 수입니다. Red Hat Virtualization, vSphere, OpenStack, OVA 및 OpenShift Virtualization 공급자가 포함되어 있습니다.
  • mode: 모드별 마이그레이션 수입니다. 콜드 및 웜 마이그레이션이 포함되어 있습니다.
  • target: 대상별 마이그레이션 수입니다. 로컬 및 원격 마이그레이션 포함.
  • 계획 ID: 마이그레이션 계획의 ID 번호입니다. 이 번호는 MTV에 의해 할당됩니다.

메트릭은 10초마다 계산되며 주, 월 및 연간 보고됩니다.

법적 공지
링크 복사

Copyright © 2025 Red Hat, Inc.
The text of and illustrations in this document are licensed by Red Hat under a Creative Commons Attribution–Share Alike 3.0 Unported license ("CC-BY-SA"). An explanation of CC-BY-SA is available at http://creativecommons.org/licenses/by-sa/3.0/. In accordance with CC-BY-SA, if you distribute this document or an adaptation of it, you must provide the URL for the original version.
Red Hat, as the licensor of this document, waives the right to enforce, and agrees not to assert, Section 4d of CC-BY-SA to the fullest extent permitted by applicable law.
Red Hat, Red Hat Enterprise Linux, the Shadowman logo, the Red Hat logo, JBoss, OpenShift, Fedora, the Infinity logo, and RHCE are trademarks of Red Hat, Inc., registered in the United States and other countries.
Linux® is the registered trademark of Linus Torvalds in the United States and other countries.
Java® is a registered trademark of Oracle and/or its affiliates.
XFS® is a trademark of Silicon Graphics International Corp. or its subsidiaries in the United States and/or other countries.
MySQL® is a registered trademark of MySQL AB in the United States, the European Union and other countries.
Node.js® is an official trademark of Joyent. Red Hat is not formally related to or endorsed by the official Joyent Node.js open source or commercial project.
The OpenStack® Word Mark and OpenStack logo are either registered trademarks/service marks or trademarks/service marks of the OpenStack Foundation, in the United States and other countries and are used with the OpenStack Foundation's permission. We are not affiliated with, endorsed or sponsored by the OpenStack Foundation, or the OpenStack community.
All other trademarks are the property of their respective owners.
맨 위로 이동
Red Hat logoGithubredditYoutubeTwitter

자세한 정보

평가판, 구매 및 판매

커뮤니티

Red Hat 문서 정보

Red Hat을 사용하는 고객은 신뢰할 수 있는 콘텐츠가 포함된 제품과 서비스를 통해 혁신하고 목표를 달성할 수 있습니다. 최신 업데이트를 확인하세요.

보다 포괄적 수용을 위한 오픈 소스 용어 교체

Red Hat은 코드, 문서, 웹 속성에서 문제가 있는 언어를 교체하기 위해 최선을 다하고 있습니다. 자세한 내용은 다음을 참조하세요.Red Hat 블로그.

Red Hat 소개

Red Hat은 기업이 핵심 데이터 센터에서 네트워크 에지에 이르기까지 플랫폼과 환경 전반에서 더 쉽게 작업할 수 있도록 강화된 솔루션을 제공합니다.

Theme

© 2025 Red Hat