이 문서에서는 관리형 인스턴스 그룹(MIG)에서 복구를 사용 중지하는 방법과 이미 사용 중지한 경우 VM을 복구하도록 MIG를 다시 설정하는 방법을 설명합니다.
기본적으로 MIG는 VM을 다시 만들어 그룹의 실패한 VM을 자동으로 복구합니다. 애플리케이션 기반 상태 점검을 구성한 경우 MIG는 애플리케이션에서 상태 점검을 실패한 비정상 VM을 복구합니다.
MIG에서 실패 또는 비정상 VM을 복구하지 않으려면 복구를 사용 중지하면 됩니다. 복구 사용 중지는 실패한 VM 문제를 해결하거나 자체 복구 로직을 구현하거나 MIG에서 비정상 VM을 복구하지 않고 애플리케이션 상태를 모니터링하려는 시나리오에서 유용합니다.
복구가 이미 MIG에서 사용 중지되었는지 여부를 확인하려면 MIG에서 복구가 사용 중지되었는지 확인을 참조하세요.
MIG에서 복구에 대한 자세한 내용은 고가용성을 위한 VM 복구 정보를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 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.
Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
MIG가 이미 있으면 다음을 수행합니다.
- 복구를 사용 중지하려는 MIG의 이름을 클릭합니다.
- 수정을 클릭합니다.
아직 MIG가 없으면 다음을 수행합니다.
- 인스턴스 그룹 만들기를 클릭합니다.
- 이름을 입력합니다.
- 인스턴스 템플릿을 선택합니다.
- 다른 설정의 경우 기본값을 사용하거나 필드를 수정할 수 있습니다.
VM 인스턴스 수명 주기 섹션에서 실패 시 기본 작업을 작업 없음으로 설정합니다.
완료되면 기존 MIG의 경우에는 저장을 또는 새 MIG의 경우에는 만들기를 클릭합니다.
MIG_NAME
: 인스턴스 그룹의 이름입니다.INSTANCE_TEMPLATE
: 그룹에 사용할 인스턴스 템플릿의 이름입니다.SIZE
: 인스턴스 그룹의 대상 크기입니다.ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우--region
플래그를 사용합니다.- 영역 MIG의 경우
instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
regionInstanceGroupManagers.patch
메서드를 사용합니다. - 영역 MIG의 경우
instanceGroupManagers.insert
메서드를 사용합니다. - 리전 MIG의 경우
regionInstanceGroupManagers.insert
메서드를 사용합니다. PROJECT_ID
: 프로젝트 ID입니다.MIG_NAME
: 인스턴스 그룹의 이름입니다.INSTANCE_TEMPLATE_URL
: 그룹에서 VM을 만드는 데 사용할 인스턴스 템플릿의 부분 URL입니다. 예를 들면 다음과 같습니다.- 리전 인스턴스 템플릿:
projects/example-project/regions/us-central1/instanceTemplates/example-template
- 전역 인스턴스 템플릿:
projects/example-project/global/instanceTemplates/example-template
- 리전 인스턴스 템플릿:
SIZE
: 인스턴스 그룹의 대상 크기입니다.ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우 URL에regions/REGION
을 사용합니다.Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
복구를 설정하려는 MIG의 이름을 클릭합니다.
수정을 클릭합니다.
VM 인스턴스 수명 주기 섹션에서 실패 시 기본 작업을 인스턴스 복구로 설정합니다.
완료 후 저장을 클릭하여 변경사항을 적용합니다.
- 영역 MIG의 경우
instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
regionInstanceGroupManagers.patch
메서드를 사용합니다. PROJECT_ID
: 프로젝트 ID입니다.MIG_NAME
: 인스턴스 그룹의 이름입니다.ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우 URL에regions/REGION
을 사용합니다.- 인스턴스 오류를 나열하여 실패한 VM에서 오류를 조사합니다.
- VM의 상태를 검사합니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용을 위한 인증을 참고하세요.
제한사항
그룹에 다음 항목이 있으면 MIG에서 복구를 사용 중지할 수 없습니다.
MIG에서 복구 사용 중지
MIG에서 복구를 사용 중지하면 자동 복구와 애플리케이션 기반 상태 점검(자동 복구)에 따른 복구 모두 사용 중지됩니다.
복구를 사용 중지하려면 Google Cloud 콘솔, gcloud CLI 또는 REST를 사용합니다.
콘솔
gcloud
기존 MIG에서 복구를 사용 중지하려면
update
명령어를 사용합니다.예를 들어 다음 명령어를 사용하여 영역 MIG에서 복구를 사용 중지합니다.
gcloud compute instance-groups managed update MIG_NAME \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
MIG를 만들 때 복구를 중지하려면
create
명령어를 사용합니다.예를 들어 영역 MIG를 만들 때 다음 명령어를 사용하여 복구를 사용 중지합니다.
gcloud compute instance-groups managed create MIG_NAME \ --template=INSTANCE_TEMPLATE \ --size=SIZE \ --zone=ZONE \ --default-action-on-vm-failure=do_nothing
다음을 바꿉니다.
REST
기존 MIG에서 복구를 사용 중지하려면 다음과 같이 API 메서드를 사용합니다.
예를 들어 기존 영역 MIG에서 복구를 사용 중지하려면 다음 호출을 수행합니다.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
MIG를 만들 때 복구를 사용 중지하려면 다음과 같이 API 메서드를 사용합니다.
예를 들어 영역 MIG를 만들 때 복구를 사용 중지하려면 다음 호출을 수행합니다.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "versions": [ { "instanceTemplate": "INSTANCE_TEMPLATE_URL" } ], "name": "MIG_NAME", "targetSize": SIZE, "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
다음을 바꿉니다.
실패 및 비정상 VM을 복구하도록 MIG 설정
기본적으로 MIG는 실패 및 비정상 VM을 복구합니다. MIG에서 복구를 사용 중지한 경우 다시 VM 복구로 설정할 수 있습니다.
콘솔
gcloud
VM을 복구하도록 MIG를 설정하려면
update
명령어를 사용합니다.gcloud compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=repair
MIG_NAME
을 MIG 이름으로 바꿉니다.REST
VM을 복구하도록 MIG를 설정하려면 다음과 같이 API 메서드를 사용합니다.
예를 들어 영역 MIG에서 복구를 사용 중지하려면 다음 호출을 수행합니다.
PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "REPAIR" } }
다음을 바꿉니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2024-12-22(UTC)
-