이 문서에서는 MIG의 VM이 자동 복구, 업데이트, 다시 생성될 때와 같이 VM이 재생성될 때에도 MIG의 VM 모두에 대해 특정 기기 이름의 디스크에 데이터를 보존하는 관리형 인스턴스 그룹(MIG)을 만드는 방법을 설명합니다. 디스크 보존은 데이터베이스 또는 기존 애플리케이션의 경우와 같은 특정 워크로드에 유용합니다.
그룹의 모든 VM에 대해 디스크를 보존하는 것 외에도 다음에 대해 스테이트풀(Stateful) MIG를 구성할 수 있습니다.
- 인스턴스별로 디스크를 추가하고 보존할 수 있습니다.
- 인스턴스별로 메타데이터를 추가하고 보존할 수 있습니다.
- IP 주소를 추가 및 보존할 수 있습니다.
자세한 내용은 스테이트풀(Stateful) MIG 개요를 참조하세요.
MIG를 만드는 다른 기본 시나리오도 참조하세요.
시작하기 전에
- 관리형 인스턴스 그룹을 만드는 데 필요한 인스턴스 템플릿을 만듭니다.
-
아직 인증을 설정하지 않았다면 설정합니다.
인증은 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.
- Install the Google Cloud CLI.
-
To initialize the gcloud CLI, run the following command:
gcloud init
-
If you're using a local shell, then create local authentication credentials for your user account:
gcloud auth application-default login
You don't need to do this if you're using Cloud Shell.
Terraform
로컬 개발 환경에서 이 페이지의 Terraform 샘플을 사용하려면 gcloud CLI를 설치 및 초기화한 다음 사용자 인증 정보로 애플리케이션 기본 사용자 인증 정보를 설정하세요.
자세한 내용은 다음을 참조하세요: Set up authentication for a local development environment.
REST
로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.
Install the Google Cloud CLI, then initialize it by running the following command:
gcloud init
자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.
-
제한사항
스테이트풀(Stateful) 구성(스테이트풀(Stateful) MIG)을 사용하는 MIG에는 다음 제한사항이 있습니다.
- MIG에 스테이트풀(Stateful) 구성이 있는 경우 자동 확장을 사용할 수 없습니다.
- 자동화된 순차적 업데이트를 사용하려면
RECREATE
에 대해 대체 메서드를 설정해야 합니다. - 스테이트풀(Stateful) 리전 MIG의 경우 사전 재배포를 중지(재배포 유형을
NONE
으로 설정)하여 자동 교차 영역 재배포에 의한 스테이트풀(Stateful) 인스턴스 삭제를 방지해야 합니다. - 모든 인스턴스 구성을 사용하여 인스턴스 템플릿 속성을 재정의하는 경우 어떤 인스턴스별 구성에서도 이러한 속성을 지정할 수 없으며 마찬가지로 그룹의 전체 인스턴스 구성에서 이러한 속성을 지정할 수 없습니다.
사용하는 구성에 따라 달라지는 MIG 제한사항의 전체 목록을 보려면 MIG 제한사항을 참조하세요.
스테이트풀(Stateful) 디스크가 있는 MIG 만들기
Google Cloud 콘솔, gcloud CLI, Terraform 또는 REST를 사용합니다.
콘솔
-
인스턴스 그룹 페이지로 ���동합니다.
나머지 단계는 Google Cloud console에서 자동으로 표시됩니다.
-
인스턴스 그룹 만들기 를 클릭합니다. -
새 관리형 인스턴스 그룹(스테이트풀(Stateful)) 옵션을 선택합니다. - 인스턴스 그룹에 이름과 설명(선택사항)을 할당합니다.
- 인스턴스 그룹의 인스턴스 템플릿을 선택하거나 새로 만듭니다.
인스턴스 수 필드에 이 그룹에 필요한 초기 VM 수를 지정합니다.스테이트풀(Stateful) 구성 섹션의 그룹 구성에서 스테이트풀(Stateful)로 만들 디스크를 클릭한 후 다음 단계를 수행합니다.- 스테이트풀(Stateful) 섹션에서 예를 선택합니다.
- 영구 인스턴스 삭제 시 목록에서 VM을 영구적으로 삭제할 때 디스크를 분리할지 아니면 디스크를 삭제할지 선택합니다.
- 설정을 저장하려면 완료를 클릭합니다.
- MIG를 만들려면
만들기 를 클릭합니다.
gcloud
MIG 생성 시 인스턴스 템플릿에서 어느 디스크가 스테이트풀(Stateful)이어야 하는지 지정하려면 gcloud compute instance-groups managed create
명령어와 함께 --stateful-disk
플래그를 사용합니다.
gcloud compute instance-groups managed create INSTANCE_GROUP_NAME \ --template INSTANCE_TEMPLATE \ --size SIZE \ --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]
다음을 바꿉니다.
INSTANCE_GROUP_NAME
: 만들려는 관리형 인스턴스 그룹의 이름입니다.INSTANCE_TEMPLATE
: 인스턴스를 만들 때 사용할 인스턴스 템플릿의 이름입니다. 리전 인스턴스 템플릿의 경우 템플릿의 전체 또는 부분 URL을 지정해야 합니다. 전체 URL 예시는https://www.googleapis.com/compute/v1/projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
이고 부분 URL은projects/example-project/regions/us-central1/instanceTemplates/example-regional-instance-template
입니다.SIZE
: 이 그룹에 필요한 초기 VM 수입니다.DEVICE_NAME
: 인스턴스 템플릿에 지정된 디스크의 기기 이름입니다.DELETE_RULE
: VM이 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.never
: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 VM이 삭제될 때 디스크를 분리합니다.on-permanent-instance-deletion
: VM 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 디스크를 삭제합니다.
삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 VM 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.
Terraform
MIG의 각 VM에 대해 원하는 머신 유형, 부팅 디스크 이미지, 네트워크, 기타 VM 속성을 지정하는 인스턴스 템플릿을 아직 만들지 않았으면 인스턴스 템플릿을 만듭니다.
MIG 생성 시 인스턴스 템플릿에서 어느 디스크가 스테이트풀(Stateful)이어야 하는지 지정하려면 stateful_disk
블록을 포함합니다. 다음 샘플은 스테이트풀(Stateful) 디스크가 있는 영역 MIG를 만듭니다. 샘플에 사용되는 리소스에 대한 자세한 내용은 google_compute_instance_group_manager
리소스를 참조하세요.
Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.
REST
MIG를 생성할 때 인스턴스 템플릿에서 스테이트풀(Stateful)이어야 하는 디스크를 지정하려면 이를 요청 본문의 statefulPolicy
필드에 포함합니다.
영역별 MIG의 경우 instanceGroupManagers.insert
메서드를 사용하고 리전별 MIG의 경우 regionInstanceGroupManagers.insert
메서드를 사용합니다.
POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers { "name": "NAME", "versions": [ { "instanceTemplate": "global/instanceTemplates/TEMPLATE" } ], "targetSize": SIZE, "statefulPolicy": { "preservedState": { "disks": { "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }, "DEVICE_NAME": {"autoDelete": "DELETE_RULE" } } } } }
다음을 바꿉니다.
PROJECT
: 요청의 프로젝트 ID입니다.ZONE
: MIG가 위치한 영역입니다(영역 MIG에 적용).- 리전 MIG의 경우
zones/ZONE
을regions/REGION
으로 바꾸고 MIG의 리전을 지정합니다.
- 리전 MIG의 경우
NAME
: 만들려는 MIG의 이름입니다.TEMPLATE
: 인스턴스를 만들 때 사용할 인스턴스 템플릿의 이름입니다.SIZE
: 이 그룹에 필요한 초기 인스턴스 수입니다.DEVICE_NAME
: 인스턴스 템플릿에 지정된 디스크의 기기 이름입니다.DELETE_RULE
: VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.never
: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.on_permanent_instance_deletion
: VM이 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.
삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 인스턴스 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.
다음 단계
- 스테이트풀(Stateful) MIG와 사용 시기에 대해 자세히 알아보기
- MIG에서 스테이트풀(Stateful) 디스크 구성 자세히 보기
- 스테이트풀(Stateful) MIG의 작동 방식 알아보기
- 디스크, 메타데이터, IP 주소에 대한 스테이트풀(Stateful) MIG 구성에 대해 자세히 알아보기