이 페이지에서는 VM 인스턴스를 한 네트워크에서 다른 네트워크로 마이그레이션하는 방법을 설명합니다. 네트워크 인터페이스 여러 개를 사용하여 네트워크 두 개 이상에 연결된 VM의 경우 이 프로세스는 인터페이스 중 하나를 업데이트하고 나머지 인터페이스는 그대로 둡니다.
지원되는 마이그레이션은 다음과 같습니다.
- 동일한 프로젝트의 기존 네트워크에서 VPC 네트워크로
- 동일한 프로젝트의 한 VPC 네트워크에서 다른 VPC 네트워크로
- VPC 네트워크의 한 서브넷에서 동일한 네트워크의 다른 서브넷으로
- 서비스 프로젝트 네트워크에서 공유 VPC 호스트 프로젝트의 공유 네트워크로
위 모든 경우 VM은 이전과 동일한 리전과 영역에서 유지됩니다. 연결된 네트워크만 변경됩니다.
시작하기 전에
- Virtual Private Cloud 문서를 참조하세요.
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음과 같이 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
- Set a default region and zone.
- 마이그레이션은 '콜드' 마이그레이션입니다. VM을 마이그레이션하려면 중지해야 합니다.
- VM이 인스턴스 그룹이나 네트워크 엔드포인트 그룹(NEG)에 있으면 안 됩니다.
- VM이 비관리형 인스턴스 그룹이나 NEG에 있는 경우 마이그레이션하기 전에 그룹에서 VM을 제외해야 합니다.
- 관리형 인스턴스 그룹의 VM을 마이그레이션할 수 없습니다. 대신 인스턴스 템플릿을 새 네트워크에 복사하고 이를 사용하여 관리형 인스턴스 그룹을 다시 빌드해야 합니다.
- 인스턴스를 먼저 삭제하지 않고 대상 풀에서 이동할 수 있습니다. 그러면 대상 풀이 확장되어 두 네트워크를 모두 포함합니다.
- VM 인터페이스를 기존 네트워크로 마이그레이션할 수 없습니다.
- 네트워크 인터페이스에 할당된 MAC 주소는 마이그레이션 중에 변경됩니다. 이는 타사 라이선스 계약과 같은 MAC 주소와 밀접하게 연결된 서비스에 영향을 줄 수 있습니다.
- VM을 IP 범위가 다른 네트워크나 서브넷으로 마이그레이션하는 경우 인스턴스의 내부 IP 주소를 변경해야 합니다. 동일한 IP 범위의 서브넷으로 마이그레이션하는 경우 대상 위치에서 이미 사용 중이지 않는 한 마이그레이션 중에 IP 주소를 지정하여 이전 IP 주소를 유지할 수 있습니다.
- 대상 서브넷에 소스와 동일한 IP 범위가 없으면 인터페이스의 IP 주소가 새 서브넷 범위와 일치하도록 변경됩니다.
- VM의 기존 외부 IP 주소를 새 위치에서 유지할 수 있습니다. 이렇게 하려면 대상 네트워크에 대한
compute.subnetworks.useExternalIp
권한이 있어야 하며 대상 네트워크에는 constraints/compute.vmExternalIpAccess 제약조건으로 인해 중지된 외부 IP 주소가 있을 수 없습니다. Google Cloud 콘솔에서 VM 인스턴스 페이지로 이동합니다.
VM 인스턴스 이름을 클릭하여 세부정보 페이지를 엽니다.
중지
를 클릭합니다.확인 대화상자가 표시되면 중지를 클릭합니다.
VM이 중지되면 수정
을 클릭합니다.네트워크 인터페이스에서 이동할 인터페이스를 클릭합니다.
인터페이스의 네트워크 필드에서 인터페이스의 새 네트워크를 선택합니다.
인터페이스의 서브네트워크 필드에서 인터페이스의 새 서브넷을 선택합니다.
내부 IP 주소 필드에서 시스템에서 서브넷 범위의 IP 주소를 할당하도록 하려면 자동을, 사용되지 않은 IP 주소를 직접 지정하려면 커스텀을 지정합니다.
완료를 클릭하여 네트워크 인터페이스 수정 패널을 닫습니다.
저장을 클릭합니다.
VM 저장이 완료되면 시작
을 클릭합니다.확인 대화상자가 표시되면 시작을 클릭합니다.
VM 중지
gcloud compute instances stop INSTANCE_NAME \ --zone=ZONE_NAME
각 항목의 의미는 다음과 같습니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
VM을 마이그레이션합니다.
gcloud compute instances network-interfaces update INSTANCE_NAME \ --zone=ZONE_NAME \ --network-interface=NIC \ --network=NETWORK_NAME \ --subnetwork=SUBNET_NAME
각 항목의 의미는 다음과 같습니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
- NIC는 업데이트할 인터페이스의 이름입니다. 단일 인터페이스 VM에서 NIC는
nic0
입니다. - NETWORK_NAME은 대상 네트워크 이름입니다. 서비스 프로젝트 네트워크에서 호스트 프로젝트 네트워크로 VM을 마이그레이션하는 경우 대상 네트워크에 정규화된 이름을 사용해야 합니다.
projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME
- SUBNET_NAME은 대상 서브넷 이름입니다. 이 서브넷은 VM과 같은 리전에 있어야 합니다. 서비스 프로젝트 네트워크에서 호스트 프로젝트 네트워크로 VM을 마이그레이션하는 경우 서브넷에 정규화된 이름을 사용해야 합니다.
projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
VM을 시작합니다.
마이그레이션에 몇 분 정도 걸릴 수 있으므로 새 위치에서 VM을 시작하기 전에 잠시 기다립니다.
gcloud compute instances start INSTANCE_NAME \ --zone=ZONE_NAME
각 항목의 의미는 다음과 같습니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
VM 중지
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE_NAME/instances/INSTANCE_NAME/stop
각 항목의 의미는 다음과 같습니다.
- PROJECT_ID는 프로젝트 ID입니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
인스턴스의 세부정보를 확인합니다.
GET https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE_NAME/instances/INSTANCE_NAME
각 항목의 의미는 다음과 같습니다.
- PROJECT_ID는 프로젝트 ID입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
인터페이스의 디지털 지문을 찾습니다.
네트워크 인터페이스를 업데이트하려면 지문이 필요합니다.
명령어 출력을 검토하고
networkInterfaces
필드 콘텐츠를 찾습니다. 업데이트하려는 인터페이스의 이름이 있는 항목을 찾습니다(단일 인터페이스 VM의 경우 이름은nic0
). 다음 단계에서 사용할 수 있도록 이 항목의fingerprint
필드에 문자열을 복사합니다.VM을 마이그레이션합니다.
PATCH https://www.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE_NAME/instances/INSTANCE_NAME/updateNetworkInterface?networkInterface=NIC { "network": NETWORK_NAME, "subnetwork": SUBNET_NAME, "networkIP": IP_ADDRESS, "name": NIC, "fingerprint": FINGERPRINT }
- PROJECT_ID는 프로젝트 ID입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- NIC는 업데이트할 인터페이스의 이름입니다. 단일 인터페이스 VM에서 NIC는
nic0
입니다. - NETWORK_NAME은 대상 네트워크 이름입니다. 서비스 프로젝트 네트워크에서 호스트 프로젝트 네트워크로 VM을 마이그레이션하는 경우 대상 네트워크에 정규화된 이름을 사용해야 합니다.
projects/HOST_PROJECT_ID/global/networks/NETWORK_NAME
- SUBNET_NAME은 대상 서브넷 이름입니다. 이 서브넷은 VM과 같은 리전에 있어야 합니다. 서비스 프로젝트 네트워크에서 호스트 프로젝트 네트워크로 VM을 마이그레이션하는 경우 서브넷에 정규화된 이름을 사용해야 합니다.
projects/HOST_PROJECT_ID/regions/REGION/subnetworks/SUBNET_NAME
- IP_ADDRESS는 새 위치에서 인스턴스에 할당할 내부 IP 주소입니다. 이 필드를 생략하면 인터페이스에 자동으로 할당됩니다.
- FINGERPRINT는 이전 단계에서 가져온 디지털 지문입니다.
VM을 시작합니다.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE_NAME/instances/INSTANCE_NAME/start
각 항목의 의미는 다음과 같습니다.
- PROJECT_ID는 프로젝트 ID입니다.
- INSTANCE_NAME은 VM 인스턴스 이름입니다.
- ZONE_NAME은 인스턴스가 포함된 영역의 이름입니다.
- 인스턴스를 다른 영역으로 이동하는 방법 알아보기
- 라이브 마이그레이션에 대해 알아보기
- VM 상태 확인
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.
요구사항
VM을 이동하기 전에 다음 요구사항을 충족해야 합니다.
제한사항
VM 마이그레이션
VM을 마이그레이션하기 전에 요구사항과 제한사항을 검토합니다.
VM을 마이그레이션하기 전에 필요한 방화벽 규칙, 경로, 부하 분산기, 기타 네트워크 인프라 리소스를 새 네트워크에 만드는 것이 좋습니다. 이렇게 하면 VM이 오프라인 상태인 시간을 줄일 수 있습니다.
콘솔
gcloud
REST
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-11-22(UTC)
-