이 문서에서는 관리형 인스턴스 그룹(MIG)에서 오류가 발생하여 비정상적인 VM의 복구를 사용 중지하는 방법과 이미 사용 중지한 경우 VM을 복구하도록 MIG를 구성하는 방법을 설명합니다.
기본적으로 MIG는 VM을 다시 만들어 그룹의 실패한 VM을 자동으로 복구합니다. 애플리케이션 기반 상태 점검을 구성한 경우 MIG는 애플리케이션에서 상태 점검을 실패한 비정상 VM도 복구합니다. 애플리케이션 기반 상태 점검을 통해 VM을 복구하는 것을 자동 복구라고도 합니다.
MIG에서 실패한 VM 또는 비정상 VM을 복구하지 않으려면 MIG에서 복구를 사용 중지하면 됩니다. 복구 사용 중지는 실패한 VM 문제를 해결하거나 자체 복구 로직을 구현하거나 비정상 VM을 복구하지 않고 애플리케이션 상태를 모니터링하려는 시나리오에서 유용합니다.
복구가 이미 MIG에서 사용 중지되었는지 여부를 확인하려면 MIG에서 복구가 사용 중지되었는지 확인을 참조하세요.
MIG에서 복구에 대한 자세한 내용은 고가용성을 위한 VM 복구 정보를 참조하세요.
시작하기 전에
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 Trusted Cloud by S3NS 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다.
로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
- Set a default region and zone.
Trusted Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
복구를 사용 중지하려는 MIG의 이름을 클릭합니다.
수정을 클릭합니다.
VM 인스턴스 수명 주기 섹션에서 실패 시 기본 작업 필드를 작업 없음으로 설정합니다.
자동 복구를 구성했고 MIG에서 자동 복구를 사용 중지하지 않으려면 상태 점검 실패 시 필드를 인스턴스 복구로 설정합니다.
저장을 클릭합니다.
MIG_NAME
: 인스턴스 그룹의 이름ZONE
: MIG가 있는 영역 리전 MIG의 경우--region=REGION
플래그를 사용합니다.- 영역 MIG의 경우
instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
regionInstanceGroupManagers.patch
메서드를 사용합니다. - 영역 MIG의 경우
beta.instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
beta.regionInstanceGroupManagers.patch
메서드를 사용합니다. PROJECT_ID
: 프로젝트 ID입니다.MIG_NAME
: MIG 이름ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우 URL에regions/REGION
을 사용합니다.Trusted Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
자동 복구를 사용 중지하려는 MIG의 이름을 클릭합니다.
수정을 클릭합니다.
VM 인스턴스 수명 주기 섹션에서 상태 점검 실패 시 필드를 작업 없음으로 설정합니다.
저장을 클릭합니다.
MIG_NAME
: MIG 이름ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우--region=REGION
플래그를 사용합니다.- 영역 MIG의 경우
beta.instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
beta.regionInstanceGroupManagers.patch
메서드를 사용합니다. PROJECT_ID
: 프로젝트 ID입니다.ZONE
: MIG가 있는 영역입니다. 리전 MIG의 경우 URL에regions/REGION
을 사용합니다.MIG_NAME
: 인스턴스 그룹의 이름Trusted Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.
복구를 사용 설정하려는 MIG의 이름을 클릭합니다.
수정을 클릭합니다.
VM 인스턴스 수명 주기 섹션에서 다음을 수행합니다.
- 실패한 VM을 복구하려면 실패 시 기본 작업 필드를 인스턴스 복구로 설정합니다.
- 비정상 VM을 복구하려면 상태 점검 실패 시 필드를 인스턴스 복구로 설정합니다. 이 값을 기본 작업으로 설정하면 자동 복구에서 실패 시 기본 작업 필드에 구성한 것과 동일한 설정을 사용합니다.
완료 후 저장을 클릭하여 변경사항을 적용합니다.
MIG_NAME
을 MIG 이름으로 바꿉니다.default-action
ORrepair
: 실패한 VM의 복구에 구성한 것과 동일한 설정을 자동 복구에 사용하려면 값을default-action
으로 설정합니다. 예를 들어 실패한 VM의 복구를 사용 중지하면 MIG에서도 자동 복구가 사용 중지됩니다. 비정상 VM의 복구를 별도로 제어하려면 값을repair
로 설정합니다.- 영역 MIG의 경우
instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
regionInstanceGroupManagers.patch
메서드를 사용합니다. - 영역 MIG의 경우
beta.instanceGroupManagers.patch
메서드를 사용합니다. - 리전 MIG의 경우
beta.regionInstanceGroupManagers.patch
메서드를 사용합니다. PROJECT_ID
: 프로젝트 ID입니다.ZONE
: MIG가 있는 영역 리전 MIG의 경우 URL에regions/REGION
을 사용합니다.MIG_NAME
: MIG 이름DEFAULT_ACTION
ORREPAIR
: 자동 복구에서 실패한 VM의 복구와 동일한 설정을 사용하려면 값을DEFAULT_ACTION
으로 설정합니다. 예를 들어 실패한 VM의 복구를 사용 중지하면 MIG에서도 자동 복구가 사용 중지됩니다. 자동 복구를 별도로 구성하려면 값을REPAIR
로 설정합니다.- MIG에서 복구가 사용 중지되었는지 확인
- 인스턴스 오류를 나열하여 실패한 VM에서 오류를 조사합니다.
- VM의 상태를 검사합니다.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공한 사용자 인증 정보를 사용합니다.
After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command:
gcloud init
자세한 내용은 Trusted Cloud 인증 문서의 REST 사용을 위한 인증을 참조하세요.
MIG에서 복구 사용 중지
MIG에서 복구를 사용 중지하면 기본적으로 실패한 VM 복구와 자동 복구 모두 사용 중지됩니다. 자동 복구만 사용 중지하려면 자동 복구 사용 중지를 참조하세요.
콘솔
gcloud
MIG에서 복구를 사용 중지하려면 다음과 같이
update
명령어를 사용합니다. 이렇게 하면 기본적으로 자동 복구가 사용 중지됩니다.gcloud compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=do-nothing \ --zone=ZONE
MIG에서 자동 복구가 구성되어 있고 기본적으로 자동 복구를 사용 중지하지 않으려면 베타
update
명령어를 사용하여--action-on-vm-failed-health-check
플래그를repair
로 설정합니다. 이렇게 하면 실패한 VM 복구가 사용 중지되어도 비정상 VM의 자동 복구가 계속 작동합니다.gcloud beta compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=do-nothing \ --action-on-vm-failed-health-check=repair \ --zone=ZONE
다음을 바꿉니다.
REST
MIG에서 복구를 사용 중지하려면 다음과 같이 API 메서드를 사용합니다. 이렇게 하면 기본적으로 자동 복구가 사용 중지됩니다.
예를 들어 영역 MIG에서 다음 호출을 수행합니다. 이렇게 하면 기본적으로 자동 복구가 사용 중지됩니다.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING" } }
MIG에서 자동 복구가 구성되어 있고 기본적으로 자동 복구를 사용 중지하지 않으려면 다음과 같이 API 메서드를 사용하여
onFailedHealthCheck
플래그를REPAIR
로 설정하세요. 이렇게 하면 실패한 VM 복구가 사용 중지되어도 비정상 VM의 자동 복구가 계속 작동합니다.예를 들어 영역 MIG에서 다음 호출을 수행합니다.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "DO_NOTHING", "onFailedHealthCheck": "REPAIR" } }
다음을 바꿉니다.
제한사항
MIG에 다음 중 하나가 있는 경우
defaultActionOnFailure
필드를DO_NOTHING
으로 설정하여 MIG에서 복구를 사용 중지할 수 없습니다.자동 복구 사용 중지
MIG에 애플리케이션 상태 점검을 구성한 경우 MIG에서 비정상 VM을 복구하지 않도록 하려면 자동 복구를 별도로 사용 중지하면 됩니다. 실패한 VM의 복구는 사용 중지되지 않습니다.
콘솔
gcloud
MIG에서 자동 복구를 사용 중지하려면 베타
update
명령어를 사용하고--action-on-vm-failed-health-check
플래그를do-nothing
으로 설정합니다.예를 들어 영역 MIG의 경우 다음 명령어를 사용합니다.
gcloud beta compute instance-groups managed update MIG_NAME \ --action-on-vm-failed-health-check=do-nothing \ --zone=ZONE
다음을 바꿉니다.
REST
MIG에서 자동 복구를 사용 중지하려면 다음과 같이 API 메서드를 사용하고
--action-on-vm-failed-health-check
플래그를do-nothing
으로 설정합니다.예를 들어 영역 MIG에서 자동 복구를 사용 중지하려면 다음 요청을 실행합니다.
POST https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers { "instanceLifecyclePolicy": { "onFailedHealthCheck": "DO_NOTHING" } }
다음을 바꿉니다.
복구 또는 자동 복구 사용 설정
기본적으로 MIG는 실패한 VM을 복구하고 자동 복구가 구성된 경우 비정상 VM도 복구합니다. 복구 또는 자동 복구 또는 둘 다 사용 중지한 경우 다시 사용 설정할 수 있습니다.
콘솔
gcloud
MIG에서 복구를 사용 설정하려면
update
명령어를 사용합니다.--action-on-vm-failed-health-check
플래그 값이default-action
인 경우 자동 복구도 사용 설정됩니다.gcloud compute instance-groups managed update MIG_NAME \ --default-action-on-vm-failure=repair
자동 복구를 별도로 사용 중지했다가 다시 사용 설정하려면 베타
update
명령어를 사용하세요.gcloud beta compute instance-groups managed update MIG_NAME \ --action-on-vm-failed-health-check=
default-action
ORrepair
다음을 바꿉니다.
REST
MIG에서 복구를 사용 설정하려면 다음과 같이 API 메서드를 사용합니다.
onFailedHealthCheck
필드 값이DEFAULT_ACTION
이면 자동 복구도 사용 설정됩니다.예를 들어 영역 MIG에서 다음 요청을 수행합니다.
PATCH https://compute.s3nsapis.fr/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "defaultActionOnFailure": "REPAIR" } }
자동 복구를 별도로 사용 중지했다가 다시 사용 설정하려면 다음과 같이 베타 API 메서드를 사용하세요.
PATCH https://compute.s3nsapis.fr/compute/beta/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/MIG_NAME { "instanceLifecyclePolicy": { "onFailedHealthCheck": "
DEFAULT_ACTION
ORREPAIR
" } }다음을 바꿉니다.
다음 단계
달리 명시되지 않는 한 이 페이지의 콘텐츠에는 Creative Commons Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 Oracle 계열사의 등록 상표입니다.
최종 업데이트: 2025-07-30(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-30(UTC)"],[[["\u003cp\u003eThis document provides instructions on how to disable automatic VM repairs in a Managed Instance Group (MIG), which can be useful for troubleshooting, custom repair logic, or application health monitoring.\u003c/p\u003e\n"],["\u003cp\u003eBy default, MIGs automatically repair failed or unhealthy VMs, but this feature can be turned off through the Google Cloud console, gcloud CLI, or REST API, by setting the "Default action on failure" to "No action".\u003c/p\u003e\n"],["\u003cp\u003eDisabling repairs will halt both automatic and application-based health check repairs, and it cannot be done on MIGs that have autoscaling configurations or suspended/stopped VMs.\u003c/p\u003e\n"],["\u003cp\u003eIf repairs are turned off, you can re-enable the automatic repair of failed or unhealthy VMs by using the console, gcloud CLI, or REST API, by setting the "Default action on failure" to "Repair instances".\u003c/p\u003e\n"],["\u003cp\u003eThe document offers guidance on authenticating to Google Cloud services and lists required permissions to complete these tasks.\u003c/p\u003e\n"]]],[],null,[]] -