버전 4.10

런북 참조

런북에는 마이그레이션할 VM, 순서, 추가 구성 매개변수가 정의됩니다. 이 페이지에서는 런북에 포함될 수 있는 열을 설명합니다. 런북에 대한 자세한 내용은 마이그레이션 웨이브 개요를 참조하세요.

예시 런북을 참조하세요.

런북의 필드는 다음 표에 정의되어 있습니다.

필드 필수 형식 참고
BlockOnFailure Y TRUE 또는 FALSE TRUE로 설정되고 작업이 실패하면 웨이브 중지되고 후속 RunGroups이 실행되지 않습니다. 기본값은 FALSE입니다.
BootFirmware N UEFI 또는 BIOS. 런북이 생성될 때 Migrate for Compute Engine에서 생성됩니다. 이 값이 UEFI이면 Compute Engine에서 TRUEGcpSecureBoot 열에 지정하여 마이그레이션된 VM에 대해 보안 부팅을 사용 설정할 수 있습니다.

값에는 UEFI 기반 소스 VM을 위한 UEFI와 vSphere BIOS VM, AWS, Azure VM을 위한 BIOS가 있습니다.

추가 정보

feature-flags:migrate-storage-ha N TRUE(기본값) 또는 FALSE

Compute Engine에서Windows VM 마이그레이션을 시작할 때 Migrate for Compute Engine은 Compute Engine 환경에 맞게 VM을 조정하는 코드를 실행합니다. 고가용성 지원을 설치할 수 없는 경우 다음과 같은 오류가 표시될 수 있습니다.

"Operation system adaptation process failed to install packages required for storage high availability. This can be overridden by setting migrate-storage-ha to FALSE, or by running Offline Migration."

feature-flags:migrate-storage-haFALSE로 설정하거나 오프라인 마이그레이션을 사용하여 오류를 재정의할 수 있습니다.

GcpDiskType 전체 마이그레이션, 오프라인 마이그레이션 standard 또는 SSD PrepareToDetach 작업에서만 디스크 생성에 사용됩니다.
GcpEphemeralPublicIp N TRUE 또는 FALSE 임시 공개용 IP 주소를 할당합니다.
GcpInstanceServiceAccount N 새 인스턴스에 적용할 서비스 계정입니다. 런북을 만들 때 기본 Cloud Extension 체크박스가 선택된 경우 해당 Cloud Extension의 기본 네트워크가 채워집니다.
GcpNetworkTags N

새 인스턴스에 적용할 워크로드 네트워크 태그입니다. 비어 있으면 인스턴스에 태그가 추가되지 않습니다. 런북을 만들 때 기본 Cloud Extension 체크박스가 선택된 경우 해당 Cloud Extension의 기본 네트워크가 채워집니다.

마이그레이션 환경에서 네트워크 태그가 하는 역할에 대한 자세한 내용은 네트워크 액세스 요구사항을 참조하세요.

GcpProject Y 문자열 마이그레이션된 VM을 실행할 Google Cloud 프로젝트.
GcpSecureBoot N TRUE 또는 FALSE. 기본값은 FALSE입니다. 마이그레이션된 후 UEFI 기반 소스 VM에 보안 부팅이 사용 설정되도록 지정하려면 TRUE를 사용합니다. 기본값은 FALSE입니다. GcpSecureBoot TRUE 값을 수락하려면 BootFirmware 필드 값이 UEFI여야 합니다.
license:os 소프트웨어 라이선스 소스를 변경하는 경우에만 해당 문자열

마이그레이션된 VM의 라이선스 유형을 지정합니다. 기본적으로 런북을 생성할 때 이 필드는 비어 있습니다. 빈 값은 다음 라이선스 유형에 해당합니다.

  • Linux VM: BYOL(Bring Your Own License, 사용자 라이선스 사용) 라이선스
  • Windows VM: PAYG(사용한 만큼만 지불) 라이선스

이 기본값을 재정의하려면 이 필드를 운영체제 유형에 따라 특정 라이선스를 적용합니다.

  • Linux VM
    • 이 필드를 설정하여 기본 BYOL(사용자 라이선스 사용) 라이선스를 Google Cloud를 통해 청구되는 PAYG 라이선스로 전환할 프리미엄 라이선스가 있는 Linux VM을 표시합니다. Red Hat Enterprise Linux(RHEL) 또는 Suse Linux Enterprise Server(SLES)에서 프리미엄 라이선스를 사용할 수 있습니다.

      자세한 내용은 프리미엄 OS 라이선스 사용을 참조하세요.

  • Windows VM
    • 이 필드를 설정하여 BYOL 라이선스가 있는 Windows VM을 지정합니다. 다양한 Windows 버전 값 목록은 VM OS 라이선스 지원을 참조하세요.
    • Windows Server 2008 R2 VM을 Windows Server 2012로 업그레이드하는 경우에는 이 필드를 https://www.googleapis.com/compute/v1/projects/windows-cloud/global/licenses/windows-server-2012-r2-byol로 설정합니다.
    • Windows BYOL(사용자 라이선스 사용) 라이선스의 경우 마이그레이션된 VM을 호스팅하는 데 단독 테넌트 노드를 사용하는 것이 좋습니다.
MemoryGB N 정수, GB 소스 VM의 현재 메모리 크기입니다.
NumCPU N 정수 소스 VM의 현재 CPU 수입니다.
NumDisks N 정수 소스 VM의 현재 디스크 수입니다.
OSType N 문자열 VM 운영체제. vSphere에서 채워집니다.
ProbeTCPPort Y 부호 없는 정수 VM을 프로브할 TCP 포트입니다. Windows VM에는 3389(RDP)를 사용하고 Linux VM에는 22(SSH)를 사용하는 것이 좋습니다.

프로빙은 RunInCloud 및 Detach 단계에서 수행됩니다.

ProvisionedSpaceGB N 정수 VM에 할당된 총 저장 용량입니다.
ProbeWaitMinutes Y 부호 없는 정수 포트 프로브가 응답할 때까지 기다리는 시간(분)입니다. 그 후에는 프로브 검사가 실패한 것으로 간주됩니다. 기본값은 0분입니다(대기 없음). RunInCloud가 사용하며, 단계를 분리합니다.
RunGroup Y 부호 있는 정수 마이그레이션할 VM을 그룹으로 묶습니다. 동일 그룹에 있는 VM이 병렬로 마이그레이션됩니다. 다른 그룹에 있는 VM은 오름차순으로 순차적으로 마이그레이션됩니다.
SoleTenancy-NodeAffinity:[KEY] N 문자열 단독 테넌트 노드에 사용합니다. VM을 배치할 위치를 정의하는 노드 어피니티 라벨 목록입니다.
SoleTenancy-NodeAffinityNot:[KEY] N 문자열 단독 테넌트 노드에 사용합니다. VM을 배치하지 을 위치를 정의하는 노드 어피니티 라벨 목록입니다.
SoleTenancy-RestartOnFailure N Yes(기본값) 또는 No 단독 테넌트 노드에 사용합니다. 동일한 물리적 호스트에서 VM을 다시 시작하려고 시도합니다. 라이선스에 이 필드를 설정하는 방법에 대한 자세한 내용은 단독 테넌트 문서를 참조하세요.
SoleTenancy-VmHostMaintenancePolicy N migrate(기본값) 또는 terminate 단독 테넌트 노드에 사용합니다. 호스트 변경으로 추가 소프트웨어 라이선스 비용이 발생할 때 유용합니다. migrate로 설정된 경우 유지보수 중에 VM이 새 호스트로 마이그레이션됩니다. terminate로 설정된 경우 호스트가 60분 이상 작동 중지될 때까지 Compute Engine이 VM 마이그레이션을 시도하지 않습니다. 라이선스에 이 필드를 설정하는 방법에 대한 자세한 내용은 단독 테넌트 문서를 참조하세요.

Windows BYOL에 대해서는 현재 migrate 정책이 지원되지 않습니다. BYOL을 사용할 때 terminate 옵션이 명시적으로 설정되지 않았으면 웨이브 마이그레이션을 진행할 수 없습니다.

SourceCloudDetails RunInCloud, FullMigration, OfflineMigration용 문자열 클라우드 인증 정보가 포함된 클라우드 세부 정보의 이름입니다.
tag:* columns N 문자열 마이그레이션된 VM에 적용할 메타데이터입니다.
TargetCloudExtension RunInCloud, FullMigration, OfflineMigration용 문자열 VM을 마이그레이션하는 Cloud Extension의 이름입니다.
TargetEdgeNode RunInCloud, FullMigration, OfflineMigration용 NodeA 또는 NodeB 이 VM의 마이그레이션을 처리하는 Cloud Extension의 기본 에지 노드입니다.
TargetInstanceName RunInCloud, FullMigration, OfflineMigration용 문자열 소스 인스턴스에 이름 태그가 있는 경우 Google Cloud 이름 지정 제한에 따라 해당 값의 형식이 다시 적용되고 사용됩니다. 그렇지 않으면 AWS, vSphere, Azure 인스턴스 ID가 사용됩니다.
TargetInstanceType RunInCloud, FullMigration, OfflineMigration용 문자열 Google Cloud에서 만들 VM의 인스턴스 유형입니다(예: n1-standard-1). 인스턴스 유형의 전체 목록은 Compute Engine 문서를 참조하세요.
TargetPublicIP RunInCloud, FullMigration, OfflineMigration용 예약된 정적 IP 주소의 이름입니다. 클라우드의 인스턴스에 할당할 내부 정적 IPv4 IP 주소의 이름입니다. Google Cloud Console에서 IP를 만들 수 있습니다.
TargetStaticIP RunInCloud, FullMigration, OfflineMigration용 예약된 고정 내부 IP 주소의 이름입니다. 클라우드의 인스턴스에 할당할 내부 정적 IPv4 IP 주소의 이름입니다. Google Cloud Console에서 IP를 만들 수 있습니다.
TargetSubnet RunInCloud, FullMigration, OfflineMigration용 문자열 대상 인스턴스에 사용할 서브넷 ID입니다. 비워둔 경우 Cloud Extension을 만들 때 지정된 대로 기본 서브넷이 선택됩니다. 예를 들면 https://www.googleapis.com/compute/v1/projects/<project ID>/regions/europe-west1/subnetworks/<subnet> name>입니다.
UpgradeOS N TRUE 또는 FALSE. 기본값은 FALSE입니다. 마이그레이션 중에 VM OS를 업그레이드할 수 있는 경우 이 필드를 TRUE로 설정하면 Detach 단계 후 OS 업그레이드 작업을 실행할 때 이 VM을 업그레이드할 수 있습니다. 업그레이드할 수 없는 VM OS의 TRUE 값은 런북 유효성 검사 및 마이그레이션 런타임 시 오류가 발생합니다.

Migrate for Compute Engine은 Windows Server 2008R2에서 Windows Server 2012로 업그레이드를 지원합니다. 자세한 내용은 2008R2에서 2012로 Windows Server VM 업그레이드를 참조하세요.

VmID Y 문자열 온프레미스 CSV에서 마이그레이션하는 경우 소스 VM의 VM ID입니다.

AWS 또는 Azure에서 마이그레이션하는 경우 이것이 인스턴스 ID입니다.

VmName N 문자열 온프레미스 vSphere에서 마이그레이션하는 경우에는 소스 VM의 이름입니다.

AWS 또는 Azure에서 마이그레이션하는 경우 이것이 인스턴스 ID입니다.

WriteIsolation 온프레미스에서 클라우드로 마이그레이션 TRUE 또는 FALSE 온프레미스에서 클라우드로 마이그레이션하는 경우 TRUE(쓰기 격리 사용) 또는 FALSE(다시 쓰기 모드)를 선택할 수 있습니다.

클라우드에서 클라우드로 마이그레이션하는 경우에는 TRUE만 사용할 수 있습니다. 현재 클라우드에서 클라우드로 마이그레이션하는 경우에는 다시 쓰기 동기화가 지원되지 않습니다.