관리형 인스턴스 작업

관리형 인스턴스 그룹(MIG)은 사용하는 구성 구성요소(인스턴스 템플릿, 모든 인스턴스 구성(선택사항), 스테이트풀(Stateful) 구성(선택사항))를 기반으로 각 관리형 인스턴스를 만듭니다.

각 관리형 인스턴스는 MIG에서 실제 가상 머신(VM) 인스턴스의 의도된 상태를 나타내는 데이터 항목입니다.

이 문서를 읽고 MIG의 관리형 인스턴스를 안정적으로 다루는 방법을 알아보세요. 예를 들어 특정 인스턴스에 대한 정보를 추가, 삭제, 업데이트 또는 확인해야 할 수 있습니다.

구성 변경사항이 MIG에 의해 되돌려지지 않도록 이 문서에 설명된 메서드를 사용하는 것이 중요합니다. MIG의 VM을 수정하기 위해 그룹 메서드 외부에서 작업하는 경우에는 MIG에서 해당 VM이 그룹에 의도된 구성을 더 이상 사용하지 않는지 여부를 감지하거나 감지하지 못할 수 있으며, 예상치 않은 결과가 발생할 수 있습니다. 예를 들어 필요한 인스턴스 그룹 관리자 API 대신 인스턴스 API를 사용하여 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

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      로컬 개발 환경에서 이 페이지의 REST API 샘플을 사용하려면 gcloud CLI에 제공하는 사용자 인증 정보를 사용합니다.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      자세한 내용은 Google Cloud 인증 문서의 REST 사용 인증을 참조하세요.

관리형 인스턴스란 무엇인가요?

관리형 인스턴스는 실제 VM 인스턴스의 현재 상태와 원하는 상태가 포함된 MIG 내 데이터 항목입니다.

관리형 인스턴스의 현재 상태에는 다음 필드가 포함됩니다.

  • 인스턴스 수명 주기 상태(예: RUNNING, STOPPING)
  • 인스턴스에서 MIG가 수행하는 현재 작업(예: RESTARTING, VERIFYING, NONE)
  • 인스턴스 상태(예: HEALTHY, UNHEALTHY)

실제 VM 인스턴스에 대한 관리형 인스턴스의 원하는 상태에는 다음이 포함됩니다.

  • 원하는 버전. 즉, 인스턴스에 사용할 버전 이름과 인스턴스 템플릿
  • 보존할 항목(예: 디스크, 메타데이터)의 보존 상태

그림 1에 표시된 것처럼, MIG의 각 관리형 인스턴스에 대해 MIG는 관리형 인스턴스의 사양에 따라 실제 VM을 준비하고 실행합니다.

구성에 따라 MIG는 관리형 인스턴스를 자동으로 생성합니다. 이 인스턴스는 MIG가 사용자를 대신하여 유지하는 실제 VM 인스턴스에 해당합니다.

그림 1. 관리형 인스턴스와 해당 VM 간의 관계

관리형 인스턴스의 사양을 보려면 MIG의 관리형 인스턴스에 대한 정보 확인을 참조하세요.

MIG에 인스턴스 추가

MIG에 인스턴스를 추가하는 방법은 다음과 같습니다.

새로 추가된 인스턴스가 준비되고 실행 중인지 확인하려면 그룹의 상태를 확인하거나 관리형 인스턴스의 상태를 확인하세요.

수동 크기 조절

관리형 인스턴스 그룹이 아직 자동 확장되도록 설정되지 않았으면 그룹 크기를 수동으로 설정하여 그룹에 있는 인스턴스 수를 변경할 수 있습니다. 수동으로 MIG 크기 조절을 참조하세요.

자동 확장

워크로드에 따라 자동으로 인스턴스를 추가하거나 삭제하도록 관리형 인스턴스 그룹을 구성할 수 있습니다. 그러면 애플리케이션에서 트래픽 증가 처리가 원활해지고, 컴퓨팅 리소스에 대한 요구가 줄면 비용을 절감할 수 있습니다. MIG의 자동 확장에 대한 자세한 내용은 인스턴스 그룹 자동 확장을 참조하세요.

특정 이름으로 인스턴스 추가

특정 이름에 의존하는 시스템을 사용하는 경우 해당 이름으로 기존 MIG에 VM을 추가할 수 있습니다. 이러한 관리형 인스턴스에 할당한 이름은 MIG가 VM을 다시 만드는 경우 그대로 유지됩니다. 자세한 내용은 MIG에서 특정 이름을 사용해 인스턴스 만들기를 참조하세요.

MIG 인스턴스 상태 보존에 대한 자세한 내용은 스테이트풀(Stateful) MIG를 참조하세요.

MIG에서 인스턴스 삭제

관리형 인스턴스를 삭제할 때 MIG는 그룹의 targetSize를 줄이고 해당하는 VM 인스턴스를 삭제합니다.

스테이트풀(Stateful) MIG를 설정하면 MIG가 인스턴스의 보존된 상태 구성을 삭제합니다. MIG는 인스턴스가 속한 모든 대상 풀에서 인스턴스도 삭제합니다.

그룹이 연결 드레이닝을 사용 설정한 백엔드 서비스의 일부인 경우 연결 드레이닝 기간 경과 후 VM 인스턴스가 삭제될 때까지 최대 60초가 소요될 수 있습니다.

관리형 인스턴스를 삭제하려면 다음을 수행합니다.

MIG에서 VM 구성 업데이트

부팅 디스크 또는 머신 유형 수정, 디스크 추가, 다른 VM 속성 변경과 같이 MIG에서 VM 구성을 변경해야 할 경우에는 MIG에서 VM 구성 업데이트를 참조하세요.

MIG에서 인스턴스 다시 만들기

이 방법을 사용하여 선택한 VM이 그룹의 최신 VM 구성 구성요소를 사용하도록 업데이트하세요. 관리형 인스턴스 그룹의 모든 VM을 다시 만들어야 하는 경우에는 대신 순차적 업데이트를 시작합니다.

그룹이 연결 드레이닝을 사용 설정한 백엔드 서비스의 일부인 경우 연결 드레이닝 기간 경과 후 VM 인스턴스가 삭제될 때까지 최대 60초가 소요될 수 있습니다.

gcloud CLI 또는 REST를 사용하여 관리형 인스턴스 그룹에서 선택한 VM 인스턴스를 다시 만듭니다.

gcloud

instance-groups managed recreate-instances 명령어를 사용합니다.

gcloud compute instance-groups managed recreate-instances INSTANCE_GROUP_NAME \
    --instances INSTANCE_NAME_1,INSTANCE_NAME_2 \
    [--region REGION | --zone ZONE]

REST

API에서 regionInstanceGroupManagers.recreateInstances 메서드에 대한 POST 요청을 실행합니다. 영역 관리형 인스턴스 그룹의 경우 instanceGroupManagers.recreateInstances 메서드를 사용합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/instanceGroupManagers/INSTANCE_GROUP_NAME/recreateInstances

{
 "instances": [
  "zones/ZONE/instances/INSTANCE_NAME_1",
  "zones/ZONE/instances/INSTANCE_NAME_2"
 ]
}

관리형 인스턴스 그룹에서 인스턴스 다시 만들기를 요청한 후 시스템에서 VM을 프로비저닝할 수 있게 되면 새 VM이 즉시 시작됩니다. 이 프로세스는 다시 만드는 인스턴스 수에 따라 상당한 시간이 걸릴 수 있습니다. 그룹의 상태를 확인하거나 해당 인스턴스의 상태를 확인하세요.

재생성 작업은 VM 인스턴스 이름을 보존하지만 인스턴스 생성 타임스탬프는 변경되지 않을 수 있습니다. 인스턴스 생성 타임스탬프가 변경되지 않았을 때 다시 만들기 작업이 새 인스턴스를 만들었는지 확인하려면 인스턴스에 연결된 부팅 디스크의 생성 타임스탬프를 확인합니다.

MIG에 인스턴스에 대한 정보 확인

MIG에 관리형 인스턴스에 대한 정보 확인을 참조하세요.

MIG에서 스테이트풀(Stateful) 인스턴스 구성

스테이트풀(Stateful) MIG 구성을 참조하세요.

다음 단계