MIG에서 스테이트풀(Stateful) 영구 디스크 구성

콘솔

1. Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.

   인스턴스 그룹으로 이동

2. 프로젝트를 선택하고 계속을 클릭합니다.

3. 인스턴스 그룹 만들기를 클릭합니다.

4. 새 관리형 인스턴스 그룹(스테이트풀(Stateful))을 선택합니다.

5. 인스턴스 그룹의 이름을 지정합니다.

6. 인스턴스 템플릿을 선택합니다. 사용할 수 있는 템플릿이 없으면 인스턴스 템플릿을 만듭니다.

7. 인스턴스 수에서 인스턴스 그룹에 대한 인스턴스 수를 지정합니다.

8. 스테이트풀(Stateful) 구성 섹션에 인스턴스 템플릿에 지정된 디스크가 표시됩니다. 디스크를 클릭하여 해당 스테이트풀(Stateful) 구성을 수정합니다.

   1. 스테이트풀(Stateful)에서 예를 선택합니다.

   2. 영구 인스턴스 삭제 시 드롭다운에서 VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행할 작업을 선택합니다. 사용 가능한 옵션은 다음과 같습니다.

      • 디스크 분리: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.
      • 디스크 삭제: VM이 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

   3. 스테이트풀(Stateful) 구성을 마친 후 완료를 클릭합니다.

9. 만들기를 클릭합니다.

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: 인스턴스를 만들 때 사용할 인스턴스 템플릿의 이름입니다.
• SIZE: 이 그룹에 필요한 초기 VM 수입니다.
• DEVICE_NAME: 인스턴스 템플릿에 지정된 디스크의 기기 이름입니다.

• DELETE_RULE: VM이 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 VM이 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: VM 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 디스크를 삭제합니다.

  삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 VM 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.

예시

각각 운영체제 및 데이터베이스 바이너리가 포함된 스테이트리스(Stateless) 부팅 디스크와 스테이트풀(Stateful) 데이터 디스크가 있는 12개의 샤드를 포함한 데이터베이스를 배포하려고 합니다. 다음 단계를 따르세요.

1. OS와 데이터베이스가 미리 설치된 img-example-db-v01 이미지에 기반한 스테이트리스(Stateless) 부팅 디스크와 스테이트풀(Stateful) 데이터 디스크로 인스턴스 템플릿을 만듭니다.

   gcloud compute instance-templates create example-database-template-v01 \
       --image img-example-db-v01 \
       --create-disk device-name=data-disk,mode=rw,image=empty10GBext4
   

   --create-disk 플래그는 다음을 수행하도록 MIG에 지시합니다.

   1. 미리 준비된 빈 ext4 이미지에서 각 VM 인스턴스를 위한 새 10GB 디스크를 만듭니다.
   2. 기기 이름 data-disk를 사용하여 디스크를 VM에 읽기/쓰기 모드로 연결합니다.

2. 인스턴스 템플릿에서 MIG를 만들고 데이터 디스크를 스테이트풀(Stateful)로 정의합니다.

   gcloud compute instance-groups managed create example-database-group \
     --template example-database-template-v01 \
     --base-instance-name shard \
     --size 12 \
     --stateful-disk device-name=data-disk,auto-delete=on-permanent-instance-deletion
   

   기기 이름 data-disk는 인스턴스 템플릿에서 가져옵니다. 데이터 디스크는 (수동 인스턴스 삭제 또는 그룹 크기 수동 축소로 인해) VM이 영구적으로 삭제될 때 VM 인스턴스와 함께 삭제되도록 구성됩니다. 데이터 디스크는 자동 복구, 업데이트, VM 재생성 시 보존됩니다.

3. 데이터 디스크가 스테이트풀(Stateful) 정책에서 구성되어 있는지 확인합니다.

   gcloud compute instance-groups managed describe example-database-group
   
   
   baseInstanceName: shard
   ...
   name: example-database-group
   ...
   statefulPolicy:
     preservedState:
       disks:
         data-disk:
           autoDelete: ON_PERMANENT_INSTANCE_DELETION
   ...
   

   스테이트풀(Stateful) 정책에서 기기 이름이 data-disk인 디스크를 스테이트풀(Stateful)로 선언하고 영구 VM 삭제 시 이러한 디스크를 삭제하는 규칙이 적용된 것을 볼 수 있습니다.

Terraform

MIG의 각 VM에 대해 원하는 머신 유형, 부팅 디스크 이미지, 네트워크, 기타 VM 속성을 지정하는 인스턴스 템플릿을 아직 만들지 않았으면 인스턴스 템플릿을 만듭니다.

다음 샘플은 스테이트풀(Stateful) 디스크가 있는 영역 MIG를 만듭니다. MIG 생성 시 인스턴스 템플릿에서 어느 디스크가 스테이트풀(Stateful)이어야 하는지 지정하려면 stateful_disk 블록을 포함합니다. 샘플에 사용된 리소스에 관한 자세한 내용은 google_compute_instance_group_manager 리소스를 참조하세요. 리전 MIG를 만들려면 google_compute_region_instance_group_manager 리소스를 사용합니다.

resource "google_compute_instance_group_manager" "default" {
  name               = "example-database-group"
  base_instance_name = "shard"
  target_size        = 12
  zone               = "us-central1-f"
  version {
    instance_template = google_compute_instance_template.default.id
    name              = "primary"
  }
  stateful_disk {
    device_name = "data-disk"
    delete_rule = "ON_PERMANENT_INSTANCE_DELETION"
  }
}

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

REST

MIG 생성 시 인스턴스 템플릿에서 어느 디스크가 스테이트풀(Stateful)이어야 하는지 지정하려면 instanceGroupManagers.insert 메서드 요청 본문의 statefulPolicy 필드에 해당 디스크를 포함합니다.

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의 리전을 지정합니다.
• NAME: 만들려는 MIG의 이름입니다.
• TEMPLATE: 인스턴스를 만들 때 사용할 인스턴스 템플릿의 이름입니다.
• SIZE: 이 그룹에 필요한 초기 인스턴스 수입니다.
• DEVICE_NAME: 인스턴스 템플릿에 지정된 디스크의 기기 이름입니다.

• DELETE_RULE: VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.
  • on_permanent_instance_deletion: VM이 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

예시

각각 운영체제 및 데이터베이스 바이너리가 포함된 스테이트리스(Stateless) 부팅 디스크와 스테이트풀(Stateful) 데이터 디스크가 있는 12개의 샤드를 포함한 데이터베이스를 배포하려고 합니다. 다음 단계를 따르세요.

1. instanceTemplates.insert 메서드를 사용하여 OS와 데이터베이스가 미리 설치된 img-example-db-v01 이미지에 기반한 스테이트리스(Stateless) 부팅 디스크와 스테이트풀(Stateful) 데이터 디스크로 인스턴스 템플릿을 만듭니다.

   POST https://compute.googleapis.com/compute/v1/projects/example-project/global/instanceTemplates
   
   {
     "name": "example-database-template-v01",
     "properties": {
       "machineType":"e2-standard-2",
       "disks": [
         {
           "boot": true,
           "deviceName": "boot-disk",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/mg-example-db-v01"
           }
         },
         {
           "deviceName": "data-disk",
           "mode": "READ_WRITE",
           "initializeParams": {
             "sourceImage": "projects/example-project/global/images/empty10GBext4"
           }
         }
       ],
       "networkInterfaces": [
         {
           "network": "global/networks/default"
         }
       ]
     }
   }
   

   인스턴스 템플릿의 데이터 디스크는 기기 이름이 data-disk이며, 미리 준비된 비어 있는 ext4 이미지에서 생성되고 읽기/쓰기 모드로 연결되도록 구성됩니다.

2. instanceGroupManagers.insert 메서드를 사용하여 인스턴스 템플릿에서 MIG를 만들고 데이터 디스크를 스테이트풀(Stateful)로 정의합니다.

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers
   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     "versions": [
       {
         "instanceTemplate": "global/instanceTemplates/example-database-template-v01"
       }
     ],
     "targetSize": 12,
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
   }
   

   MIG는 각각 다음 속성을 가진 디스크가 있는 12개의 인스턴스를 만듭니다.

   • 인스턴스 템플릿에서 가져온 기기 이름 data-disk
   • (수동 인스턴스 삭제 또는 그룹 크기 수동 축소로 인해) VM이 삭제될 때 데이터 디스크를 삭제하는 삭제 규칙
   • 자동 복구, 업데이트, 인스턴스 재생성 시 데이터 디스크가 보존되도록 하는 각 관리형 인스턴스 정책(preservedStateFromPolicy)의 보존 상태 항목

3. instanceGroupManagers.get 메서드를 사용하여 데이터 디스크가 새 instanceGroupManagers 리소스의 스테이트풀(Stateful) 정책에 구성되어 있는지 확인합니다.

   GET https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   

   
   {
     "name": "example-database-group",
     "baseInstanceName": "shard",
     ...
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "ON_PERMANENT_INSTANCE_DELETION" }
         }
       }
     }
     ...
   }
   

   스테이트풀(Stateful) 정책에서 기기 이름이 data-disk인 디스크를 스테이트풀(Stateful)로 선언하고 영구 인스턴스 삭제 시 이러한 디스크를 삭제하는 규칙이 적용된 것을 볼 수 있습니다.

콘솔

1. Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.

   인스턴스 그룹으로 이동

2. 디스크에 스테이트풀(Stateful) 구성을 지정하려는 인스턴스 그룹 이름을 클릭합니다.

3. 수정을 클릭하여 관리형 인스턴스 그룹을 수정합니다.

4. 스테이트풀(Stateful) 구성에서 스테이트풀(Stateful)로 설정하려는 디스크를 확장합니다.

   1. 스테이트풀(Stateful)에서 예를 선택합니다.

   2. 영구 인스턴스 삭제 시 드롭다운에서 VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행할 작업을 선택합니다.

      • 디스크 분리: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.

      • 디스크 삭제: VM이 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

   3. 스테이트풀(Stateful) 구성을 업데이트한 후 완료를 클릭합니다.

5. 저장을 클릭하여 업데이트를 완료합니다.

gcloud

인스턴스 템플릿에서 스테이트풀(Stateful)이어야 하는 디스크를 지정하거나 기존 MIG의 스테이트풀(Stateful) 디스크 구성을 업데이트하려면 하나 이상의 --stateful-disk 플래그와 함께 gcloud compute instance-groups managed update 명령어를 사용합니다.

gcloud compute instance-groups managed update NAME \
  --stateful-disk device-name=DEVICE_NAME[,auto-delete=DELETE_RULE]

다음을 바꿉니다.

• NAME: 업데이트할 관리형 인스턴스 그룹의 이름입니다.
• DEVICE_NAME: 인스턴스 템플릿에 지정된 디스크의 기기 이름입니다.

• DELETE_RULE: VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 관리형 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

지정된 기기 이름이 스테이트풀(Stateful) 정책에서 이미 구성된 경우 이 명령어는 구성을 업데이트합니다.

예시

example-database- group이라는 MIG에서 여러 샤드가 있는 데이터베이스를 실행합니다. MIG의 각 VM은 인스턴스 템플릿이 정의한 기기 이름이 data-disk인 추가 디스크에 샤드를 저장합니다. MIG에는 스테이트풀(Stateful) 구성이 없으며, 인스턴스 재생성, 자동 복구, 업데이트 시 데이터 디스크를 보존하려고 합니다. 또한 VM이 삭제될 때 데이터 디스크를 삭제에서 보호하려고 합니다.

1. 다음 명령어로 MIG를 업데이트하여 데이터 디스크를 스테이트풀(Stateful)로 정의합니다.

   gcloud compute instance-groups managed update example-database-group \
     --stateful-disk device-name=data-disk,auto-delete=never
   

   그 결과 MIG는 스테이트풀(Stateful) 정책 구성 업데이트를 모든 인스턴스의 데이터 디스크에 비동기식으로 자동 적용합니다. 이제 데이터 디스크는 자동 복구, 업데이트, 인스턴스 재생성 시 보존되며, auto-delete 규칙이 never로 설정되어 있으므로 인스턴스 삭제 시 데이터 디스크가 분리됩니다.

2. gcloud compute instance-groups managed describe example-database-group 명령어를 실행하여 스테이트풀(Stateful) 정책에 데이터 디스크가 구성되어 있는지 확인합니다.

REST

인스턴스 템플릿에서 스테이트풀(Stateful)이어야 하는 디스크를 지정하거나 기존 MIG의 스테이트풀(Stateful) 디스크 구성을 업데이트하려면 instanceGroupManagers.patch 메서드를 사용하여 MIG의 스테이트풀(Stateful) 정책에서 디스크를 구성합니다.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" },
        "DEVICE_NAME": {"autoDelete": "DELETE_RULE" }
      }
    }
  }
}

다음을 바꿉니다.

• PROJECT: 요청의 프로젝트 ID입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
  • 리전 MIG의 경우 zones/ZONE을 regions/REGION으로 바꾸고 MIG의 리전을 지정합니다.
• NAME: 업데이트할 MIG의 이름입니다.
• DEVICE_NAME: 인스턴스 템플릿에 지정되어 스테이트풀(Stateful) 구성을 업데이트하려는 디스크의 기기 이름입니다.

• DELETE_RULE: VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. VM이 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

지정된 기기 이름이 스테이트풀(Stateful) 정책에서 이미 구성된 경우 patch 메서드가 구성을 업데이트합니다.

예시

example-database- group이라는 MIG에서 여러 샤드가 있는 데이터베이스를 실행합니다. MIG의 각 VM은 인스턴스 템플릿이 정의한 기기 이름이 data-disk인 추가 디스크에 샤드를 저장합니다. MIG에는 스테이트풀(Stateful) 구성이 없으며, 인스턴스 재생성, 자동 복구, 업데이트 시 데이터 디스크를 보존하려고 합니다. 또한 VM이 삭제될 때 데이터 디스크를 삭제에서 보호하려고 합니다.

1. MIG를 패치하여 데이터 디스크를 스테이트풀(Stateful)로 정의합니다.

   PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-group
   
   {
     "statefulPolicy": {
       "preservedState": {
         "disks": {
           "data-disk": {"autoDelete": "NEVER" }
         }
       }
     }
   }
   

   MIG는 이 스테이트풀(Stateful) 구성을 모든 인스턴스의 데이터 디스크에 비동기식으로 자동 적용합니다. 데이터 디스크는 자동 복구, 업데이트, 인스턴스 재생성 시 보존됩니다. autoDelete 규칙이 NEVER로 설정되어 있으므로 데이터 디스크는 인스턴스 삭제 시 분리됩니다.

2. instanceGroupManagers.get 메서드가 반환하는 instanceGroupManagers 리소스를 보고 스테이트풀(Stateful) 정책에서 데이터 디스크가 구성되었는지 확인합니다.

콘솔

1. Google Cloud 콘솔에서 인스턴스 그룹 페이지로 이동합니다.

   인스턴스 그룹으로 이동

2. 디스크의 스테이트풀(Stateful) 구성을 삭제할 인스턴스 그룹의 이름을 클릭합니다.

3. 수정을 클릭하여 관리형 인스턴스 그룹을 수정합니다.

4. 스테이트풀(Stateful) 구성에서 스테이트리스(Stateless)로 설정하려는 스테이트풀(Stateful) 디스크를 확장합니다.

   1. 스테이트풀(Stateful) 옵션을 아니요로 변경합니다.
   2. 완료를 클릭합니다.

5. 수정을 완료한 후 저장을 클릭합니다.

gcloud

MIG의 스테이트풀(Stateful) 정책에서 스테이트리스(Stateless)로 만들 디스크를 지정하려면 gcloud compute instance-groups managed update 명령어에 --remove-stateful-disks 플래그를 사용합니다.

gcloud compute instance-groups managed update NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...]

다음을 바꿉니다.

• NAME: 업데이트할 MIG의 이름입니다.
• DEVICE_NAME: 스테이트풀(Stateful) 정책에서 삭제하고 스테이트리스(Stateless)로 취급할 디스크의 기기 이름입니다. 목록에 하나 이상의 기기 이름을 제공할 수 있습니다.

예시

example-legacy-group이라는 MIG에서 여러 노드가 있는 레거시 애플리케이션을 실행합니다. MIG의 각 VM은 MIG의 스테이트풀(Stateful) 정책에서 스테이트풀(Stateful)로 구성하고 기기 이름이 boot-disk인 부팅 디스크에 애플리케이션 데이터를 저장합니다. 애플리케이션 데이터를 추가 디스크로 이동했고 이제 새로운 이미지로 쉽게 업데이트할 수 있도록 부팅 디스크를 스테이트리스(Stateless)로 만들려고 합니다.

부팅 디스크의 스테이트풀(Stateful) 구성을 삭제하려면 관리형 인스턴스 그룹을 업데이트합니다.

gcloud compute instance-groups managed update example-legacy-group \
  --remove-stateful-disks boot-disk

MIG는 그룹에 있는 모든 인스턴스의 부팅 디스크에서 기기 이름 boot-disk의 스테이트풀(Stateful) 구성을 비동기식으로 자동 삭제합니다. 부팅 디스크는 인스턴스에 계속 연결되어 있지만 더 이상 스테이트풀(Stateful)이 아닙니다. 인스턴스를 다시 만들거나 업데이트하거나 인스턴스가 자동 복구되면 MIG는 인스턴스 템플릿에 지정된 이미지에서 부팅 디스크를 다시 만듭니다.

REST

MIG의 스테이트풀(Stateful) 정책에서 스테이트리스(Stateless)로 만들 디스크를 지정하려면 instanceGroupManagers.patch 메서드를 사용하여 MIG의 스테이트풀(Stateful) 정책에서 각 디스크의 구성을 삭제합니다.

PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/instanceGroupManagers/NAME

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "DEVICE_NAME": null,
        ...
      }
    }
  }
}

다음을 바꿉니다.

• PROJECT: 요청의 프로젝트 ID입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
  • 리전 MIG의 경우 zones/ZONE을 regions/REGION으로 바꾸고 MIG의 리전을 지정합니다.
• NAME: 업데이트할 MIG의 이름입니다.
• DEVICE_NAME: 스테이트풀(Stateful) 정책에서 삭제할 디스크의 기기 이름입니다. null 값을 제공하면 해당 디스크의 스테이트풀(Stateful) 구성이 삭제됩니다. 삭제할 기기 이름을 하나 이상 제공할 수 있습니다.

예시

example-legacy-group이라는 MIG에서 여러 노드가 있는 레거시 애플리케이션을 실행합니다. MIG의 각 VM은 MIG의 스테이트풀(Stateful) 정책에서 스테이트풀(Stateful)로 구성하고 기기 이름이 boot-disk인 부팅 디스크에 애플리케이션 데이터를 저장합니다. 애플리케이션 데이터를 추가 디스크로 이동했고 이제 새로운 이미지로 쉽게 업데이트할 수 있도록 부팅 디스크를 스테이트리스(Stateless)로 만들려고 합니다.

부팅 디스크의 스테이트풀(Stateful) 구성을 삭제하려면 관리형 인스턴스 그룹을 패치합니다.

PATCH https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group

{
  "statefulPolicy": {
    "preservedState": {
      "disks": {
        "boot-disk": null
      }
    }
  }
}

MIG는 그룹에 있는 모든 인스턴스의 부팅 디스크에서 기기 이름 boot-disk의 스테이트풀(Stateful) 구성을 비동기식으로 자동 삭제합니다. 부팅 디스크는 인스턴스에 계속 연결되어 있지만 더 이상 스테이트풀(Stateful)이 아닙니다. 인스턴스를 다시 만들거나 업데이트하거나 인스턴스가 자동 복구되면 MIG는 인스턴스 템플릿에 지정된 이미지에서 부팅 디스크를 다시 만듭니다.

gcloud

커스텀 이름으로 VM을 만들고 해당 VM에 하나 이상의 기존 스테이트풀(Stateful) 디스크를 연결하려면 gcloud compute instance-groups managed create-instance 명령어를 하나 이상의 --stateful-disk 플래그와 함께 사용합니다.

gcloud compute instance-groups managed create-instance NAME \
  --instance VM_NAME \
  [--zone ZONE | --region REGION] \
  --stateful-disk device-name=DEVICE_NAME,source=DISK[,mode=MODE][,auto-delete=DELETE_RULE]

다음을 바꿉니다.

• NAME: 인스턴스를 만들어야 하는 MIG의 이름입니다.
• VM_NAME: 만들려는 새 인스턴스의 이름입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
• REGION: MIG가 위치한 리전입니다(리전 MIG에 적용).
• DEVICE_NAME: 디스크를 연결할 때 사용할 기기 이름입니다.
• DISK: 지정된 DEVICE_NAME 아래에 영역 디스크는 projects/project-id/zones/zone/disks/disk-name 형식, 리전 디스크는 projects/project-id/regions/region/disks/disk-name 형식으로 연결할 기존 영구 디스크의 URI입니다.
• MODE: 디스크의 모드를 지정합니다. 지원되는 옵션은 다음과 같습니다.
  • ro: 읽기 전용
  • rw: (기본값) 읽기/쓰기

• DELETE_RULE: VM 인스턴스가 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 인스턴스가 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

  삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 인스턴스 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.

예시

현재 db-instance라는 독립형 VM에서 실행 중이고 db-data-disk-1이라는 디스크에 데이터를 저장하는 데이터베이스 서버에 자동 복구를 사용하려고 합니다.

자동 복구를 사용하여 스테이트풀(Stateful) MIG를 만들고, MIG 내에 유사한 VM을 만들고, 기존 데이터 디스크 db-data-disk-1을 새 인스턴스에 스테이트풀(Stateful) 디스크로 연결합니다.

1. 유지보수 기간 동안 VM db-instance를 중지합니다.
2. db-instance 구성을 사용하여 db-template이라는 인스턴스 템플릿을 만듭니다.
3. db-instance에서 db-data-disk-1을 분리하고 db-instance를 삭제합니다.
4. db-template에서 빈 MIG example-database-mig를 만들고 자동 복구를 구성합니다.

5. 원래의 db-instance 이름으로 관리형 인스턴스를 만들고 db-data-disk-1을 스테이트풀(Stateful) 디스크로 연결합니다.

   gcloud compute instance-groups managed create-instance example-database-mig \
     --instance db-instance \
     --zone us-east1-c \
     --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/db-data-disk-1,auto-delete=never
   

   이 명령어는 MIG에 인스턴스 db-instance를 만들고 db-data-disk-1 스테이트풀(Stateful) 디스크로 해당 인스턴스별 구성을 만들며 data-disk를 기기 이름으로 사용하여 디스크를 새 VM에 연결합니다.

REST

MIG에 하나 이상의 인스턴스를 만들고, 커스텀 VM 이름을 설정하고, 이러한 인스턴스에 하나 이상의 기존 스테이트풀(Stateful) 디스크를 연결하려면 instanceGroupManagers.createInstances 메서드를 사용합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/createInstances

{
  "instances": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      }
    },
    ...
  ]
}

다음을 바꿉니다.

• PROJECT_ID: 요청의 프로젝트 ID입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
  • 리전 MIG의 경우 zones/ZONE을 regions/REGION으로 바꾸고 MIG의 리전을 지정합니다.
• NAME: 인스턴스를 만들려는 MIG의 이름입니다.
• VM_NAME: 만들려는 인스턴스의 이름입니다.
• DEVICE_NAME: 디스크를 연결할 때 사용할 기기 이름입니다.
• DISK: 지정된 DEVICE_NAME 아래에 영역 디스크는 projects/project-id/zones/zone/disks/disk-name 형식, 리전 디스크는 projects/project-id/regions/region/disks/disk-name 형식으로 연결할 기존 영구 디스크의 URI입니다.
• MODE: 디스크의 모드를 지정합니다. 지원되는 옵션은 다음과 같습니다.
  • READ_ONLY: 읽기 전용
  • READ_WRITE: (기본값) 읽기/쓰기

• DELETE_RULE: VM이 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 VM이 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

  삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 인스턴스 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.

예시

현재 db-instance라는 독립형 VM에서 실행 중이고 db-data-disk-1이라는 디스크에 데이터를 저장하는 데이터베이스 서버에 자동 복구를 사용하려고 합니다.

자동 복구를 사용하여 스테이트풀(Stateful) MIG를 만들고 MIG 내에 유사한 인스턴스를 만들며 기존 데이터 디스크 db-data-disk-1을 새 VM에 스테이트풀(Stateful) 디스크로 연결합니다.

1. 유지보수 기간 동안 VM db-instance를 중지합니다.
2. db-instance 구성을 사용하여 db-template이라는 인스턴스 템플릿을 만듭니다.
3. db-instance에서 db-data-disk-1을 분리하고 db-instance를 삭제합니다.
4. db-template에서 빈 MIG example-database-mig를 만들고 자동 복구를 구성합니다.

5. 원래의 db-instance 이름으로 인스턴스를 만들고 db-data-disk-1을 스테이트풀(Stateful) 디스크로 연결합니다.

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/createInstances
   
   {
     "instances": [
       {
         "name": "db-instance",
         "preservedState" : {
           "disks": {
             "data-disk" : {
               "source": "projects/example-project/zones/us-east1-c/disks/db-data-disk-1",
               "mode": "READ_WRITE",
               "autoDelete": "never"
             }
           }
         }
       }
     ]
   }
   

   이 메서드는 MIG에 인스턴스 db-instance를 만들고 db-data-disk-1 스테이트풀(Stateful) 디스크로 해당 인스턴스별 구성을 만들며 data-disk를 기기 이름으로 사용하여 디스크를 새 인스턴스에 연결합니다.

gcloud

MIG의 VM에 스테이트풀(Stateful) 디스크를 개별적으로 구성하려면 연결된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 추가하거나 업데이트합니다. 그런 다음 인스턴스를 업데이트하여 구성을 적용합니다.

인스턴스에 대한 인스턴스별 구성이 아직 없다면 하나 이상의 --stateful-disk 플래그와 함께 gcloud compute instance-groups managed instance-configs create 명령어를 사용합니다.

gcloud compute instance-groups managed instance-configs create NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

인스턴스에 대한 인스턴스별 구성이 이미 있다면 하나 이상의 --stateful-disk 플래그와 함께 gcloud compute instance-groups managed instance-configs update 명령어를 사용합니다.

--update-instance 플래그(기본값)는 변경 사항을 즉시 인스턴스에 적용합니다. --no-update-instance를 사용하는 경우 변경 사항이 적용되지 않고 다음에 인스턴스를 다시 만들거나 업데이트할 때 적용됩니다.

gcloud compute instance-groups managed instance-configs update NAME \
--instance VM_NAME \
--stateful-disk device-name=DEVICE_NAME[,source=DISK][,mode=MODE][,auto-delete=DELETE_RULE] \
[--no-update-instance | --update-instance] \
[--instance-update-minimal-action MINIMAL_ACTION]

다음을 바꿉니다.

• NAME: 관리형 인스턴스 그룹의 이름입니다.
• VM_NAME: 스테이트풀(Stateful) 디스크를 구성할 VM 인스턴스의 이름입니다.
• DEVICE_NAME: 디스크를 연결하는 데 사용되는 기기 이름입니다.

• DISK: 지정된 DEVICE_NAME 아래에 영역 디스크는 projects/project-id/zones/zone/disks/disk-name 형식, 리전 디스크는 projects/project-id/regions/region/disks/disk-name 형식으로 연결할 기존 영구 디스크의 URI입니다.

  기기가 인스턴스의 인스턴스별 구성에서 이미 정의된 경우 source=DISK 하위 플래그는 선택사항입니다. 그렇지 않으면 필수사항입니다.

  생략해도 현재 구성된 디스크 URI는 변경되지 않습니다.

• MODE: 디스크의 모드를 지정합니다. source도 지정해야 mode를 지정할 수 있습니다. 지원되는 옵션은 다음과 같습니다.

  • ro: 읽기 전용
  • rw: (기본값) 읽기/쓰기

  생략하면 새 스테이트풀(Stateful) 디스크 구성에 기본값이 설정됩니다. 값은 기존 구성에서 변경되지 않습니다.

• DELETE_RULE: VM이 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 인스턴스가 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

  생략하면 새 스테이트풀(Stateful) 디스크 구성에 기본값이 설정됩니다. 값은 기존 구성에서 변경되지 않습니다.

  삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 인스턴스 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.

• MINIMAL_ACTION: 인스턴스에 인스턴스별 구성 업데이트를 적용할 때 최소한 지정된 작업은 수행합니다. --update-instance 플래그와 함께 사용해야 합니다. 값은 다음 중 하나여야 합니다.

  • none: 적용할 작업이 없습니다.
  • refresh: VM을 중지하지 않고 적용할 수 있는 업데이트를 적용합니다.
  • restart: VM을 중지했다가 다시 시작합니다.
  • replace: VM을 다시 만듭니다.

  생략하면 업데이트에 필요한 중단이 가장 적은 작업이 사용됩니다.

예시

현재 연결된 스테이트풀(Stateful) 디스크 data-disk-1의 데이터가 손상되어 최신 백업에서 복원하려고 합니다. 스테이트풀(Stateful) MIG example-database-mig가 관리하는 db-instance-1 인스턴스의 손상된 디스크를 교체하기 위해 스냅샷에서 data-disk-2 디스크를 만들었습니다. 원본 디스크 data-disk-1은 디스크를 삭제하지 않는 자동 삭제 규칙과 함께 data-disk 기기 이름으로 연결되어 있습니다.

data-disk-1을 data-disk-2로 바꾸려면 다음 명령어를 실행합니다.

gcloud compute instance-groups managed instance-configs update example-database-mig \
  --instance db-instance-1 \
  --stateful-disk device-name=data-disk,source=projects/example-project/zones/us-east1-c/disks/data-disk-2 \
  --update-instance \
  --instance-update-minimal-action restart

이 명령은 다음을 수행합니다.

1. db-instance-1의 인스턴스별 구성을 업데이트합니다.
   1. 기기 이름이 data-disk인 디스크의 소스를 data-disk-1(이전 구성)에서 data-disk-2(새 구성)로 업데이트합니다.
   2. --stateful-disk 플래그에 auto-delete 매개변수가 생략되었고 기본적으로 삭제 규칙이 never이므로 디스크를 삭제하지 않는 자동 삭제 규칙을 유지합니다.
2. --update-instance 플래그가 포함되어 있으므로 인스턴스별 구성 업데이트를 db-instance-1 VM에 즉시 적용합니다. MIG는 data-disk-1을 분리하고 동일한 기기 이름 data-disk로 data-disk-2를 연결합니다.
3. 최소 작업이 restart로 설정되어 있으므로 MIG는 데이터베이스 애플리케이션이 새 디스크를 사용하는 데 도움이 되도록 db-instance-1 인스턴스를 다시 시작하여 VM을 업데이트합니다.

Terraform

MIG의 VM에 스테이트풀(Stateful) 디스크를 개별적으로 구성하려면 연결된 인스턴스별 구성에 스테이트풀(Stateful) 디스크 구성을 추가합니다. 그런 다음 인스턴스를 업데이트하여 구성을 적용합니다.

VM의 인스턴스별 구성을 추가하려면 google_compute_per_instance_config 리소스를 사용하고 다음 샘플과 같이 preserved_state 블록을 포함합니다.

resource "google_compute_per_instance_config" "default" {
  instance_group_manager = google_compute_instance_group_manager.default.name
  zone                   = google_compute_instance_group_manager.default.zone
  name                   = "db-instance"
  preserved_state {
    disk {
      device_name = "data-disk"
      source      = google_compute_disk.default.id
      delete_rule = "NEVER"
    }
  }
}

Terraform 구성을 적용하거나 삭제하는 방법은 기본 Terraform 명령어를 참조하세요.

REST

MIG의 VM에 스테이트풀(Stateful) 디스크를 개별적으로 구성하려면 연결된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 추가하거나 업데이트합니다. 그런 다음 인스턴스를 업데이트하여 구성을 적용합니다.

지정된 VM에 인스턴스별 구성이 아직 없다면 하나 이상의 디스크에 스테이트풀(Stateful) 구성으로 instanceGroupManagers.updatePerInstanceConfigs 메서드 또는 regionInstanceGroupManagers.updatePerInstanceConfigs 메서드를 사용합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/updatePerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

지정된 VM에 인스턴스별 구성이 이미 있다면 하나 이상의 디스크에 스테이트풀(Stateful) 구성으로 instanceGroupManagers.patchPerInstanceConfigs 메서드 또는 regionInstanceGroupManagers.patchPerInstanceConfigs 메서드를 사용합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : {
            "source": "DISK",
            "mode": "MODE",
            "autoDelete": "DELETE_RULE"
          },
          ...
        }
      },
      "fingerprint: "FINGERPRINT"
    },
    ...
  ]
}

다음을 바꿉니다.

• PROJECT_ID: 요청의 프로젝트 ID입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
  • 리전 MIG의 경우 zones/ZONE을 regions/REGION으로 바꾸고 MIG의 리전을 지정합니다.
• NAME: MIG의 이름입니다.
• VM_NAME: 스테이트풀(Stateful) 디스크를 구성할 VM의 이름입니다.
• DEVICE_NAME: 디스크를 연결하는 데 사용되는 기기 이름입니다.

• DISK: 지정된 DEVICE_NAME 아래에 영역 디스크는 projects/project-id/zones/zone/disks/disk-name 형식, 리전 디스크는 projects/project-id/regions/region/disks/disk-name 형식으로 연결할 기존 영구 디스크의 URI입니다.

  기기가 인스턴스의 인스턴스별 구성에서 이미 정의된 경우 "source": "DISK" 필드는 선택사항입니다. 그렇지 않으면 필수사항입니다.

  source 필드가 생략되면 현재 구성된 디스크 URI는 변경되지 않습니다.

• MODE: (선택사항) 디스크의 모드를 지정합니다. mode는 source가 제공된 경우에만 지정할 수 있습니다. 지원되는 옵션은 다음과 같습니다.

  • READ_ONLY: 읽기 전용
  • READ_WRITE: (기본값) 읽기/쓰기

  생략하면 새 스테이트풀(Stateful) 디스크 구성에 기본값이 설정됩니다. 값은 기존 구성에서 변경되지 않습니다.

• DELETE_RULE: (선택사항) VM이 삭제될 때 스테이트풀(Stateful) 디스크에 수행해야 하는 작업을 규정하는 값입니다. 사용 가능한 옵션은 다음과 같습니다.

  • never: (기본값) 절대 디스크를 삭제하지 않습니다. 대신 인스턴스가 삭제될 때 디스크를 분리합니다.
  • on-permanent-instance-deletion: 인스턴스가 인스턴스 그룹에서 영구적으로 삭제될 때(예: 인스턴스가 수동으로 삭제될 때 또는 그룹 크기를 줄일 때) 스테이트풀(Stateful) 디스크를 삭제합니다.

  autoDelete 필드를 생략하면 새 스테이트풀(Stateful) 디스크 구성에 기본값이 설정됩니다. 값은 기존 구성에서 변경되지 않습니다.

  삭제 규칙의 값에 관계없이 스테이트풀(Stateful) 디스크는 인스턴스 자동 복구, 업데이트, 재생성 작업 시 항상 보존됩니다.

• FINGERPRINT: (선택사항) 지정된 구성의 지문입니다(이미 있는 경우). 낙관적 잠금에 사용됩니다. 최신 지문을 보려면 get() 요청을 수행하여 리소스를 검색합니다.

updatePerInstanceConfigs 및 patchPerInstanceConfigs 메서드는 지정된 인스턴스별 구성을 업데이트하지만 연결된 관리형 VM에 구성 업데이트를 적용하지 않습니다. 변경 사항은 MIG에게 인스턴스를 다시 만들거나 업데이트하도록 지시할 때 인스턴스에 적용됩니다. 인스턴스를 선택적으로 업데이트하여 변경사항을 적용할 수도 있습니다.

예시

현재 연결된 스테이트풀(Stateful) 디스크 data-disk-1의 데이터가 손상되어 최신 백업에서 복원하려고 합니다. 스테이트풀(Stateful) MIG example-database-mig가 관리하는 db-instance-1 인스턴스의 손상된 디스크를 교체하기 위해 스냅샷에서 data-disk-2 디스크를 만들었습니다. 원본 디스크 data-disk-1은 디스크를 삭제하지 않는 자동 삭제 규칙과 함께 data-disk 기기 이름으로 연결되어 있습니다.

db-instance-1의 인스턴스별 구성을 새 디스크로 업데이트하려면 patchPerInstanceConfigs 메서드를 호출합니다.

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "db-instance-1",
      "preservedState" : {
        "disks": {
          "data-disk" : {
            "source": "projects/example-project/zones/us-east1-c/disks/data-disk-2"
          }
        }
      }
    }
  ]
}

이 메서드는 db-instance-1의 인스턴스별 구성을 패치합니다.

1. 기기 이름이 data-disk인 디스크의 source를 data-disk-1(이전 구성)에서 data-disk-2(새 구성)로 업데이트합니다.
2. 요청에서 매개변수가 생략되므로 mode 및 autoDelete 매개변수는 변경되지 않습니다.

구성 업데이트는 아직 db-instance-1 VM에 적용되지 않습니다. MIG는 인스턴스를 다시 만들거나 업데이트할 때 구성 업데이트를 적용합니다.

인스턴스별 구성 업데이트를 db-instance-1 VM에 적용하려면 인스턴스에 대해 instanceGroupManagers.applyUpdatesToInstances 메서드를 호출합니다.

POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-database-mig/applyUpdatesToInstances
{
  "instances": ["/zones/us-east1-c/instances/db-instance-1"],
  "minimalAction": "RESTART"
}

이 메서드는 관리형 인스턴스의 보존 상태를 업데이트하여 data-disk-1을 분리하고 동일한 기기 이름 data-disk 으로 data-disk-2를 연결합니다. minimalAction이 RESTART로 설정되어 있으므로 이 메서드는 db-instance-1 VM을 다시 시작합니다. 그러면 데이터베이스 애플리케이션이 새 디스크 사용을 시작할 수 있습니다.

gcloud

MIG의 VM에서 스테이트풀(Stateful) 디스크를 분리하거나 개별적으로 스테이트리스(Stateless)로 선언하려면 연결된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 삭제하거나 다른 상태를 포함하지 않은 경우 전체 인스턴스별 구성을 삭제합니다. 인스턴스를 업데이트하여 구성을 적용합니다.

연결된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 삭제하려면 --remove-stateful-disks 플래그와 함께 gcloud compute instance-groups managed instance-configs update 명령어를 사용합니다. --update-instance 플래그(기본값)는 변경 사항을 즉시 인스턴스에 적용합니다. --no-update-instance를 사용하는 경우 변경 사항이 적용되지 않고 다음에 인스턴스를 다시 만들거나 업데이트할 때 적용됩니다.

gcloud compute instance-groups managed instance-configs update NAME \
  --instance VM_NAME \
  --remove-stateful-disks DEVICE_NAME[,DEVICE_NAME,...] \
  [--no-update-instance | --update-instance] \
  [--instance-update-minimal-action MINIMAL_ACTION]

다음을 바꿉니다.

• NAME: MIG의 이름입니다.
• VM_NAME: 스테이트풀(Stateful) 구성을 삭제할 VM의 이름입니다.
• DEVICE_NAME: 디스크를 연결하는 데 사용되는 기기 이름입니다.

• MINIMAL_ACTION: 인스턴스별 구성으로 VM을 업데이트할 때 최소한 지정된 작업을 수행합니다. --update-instance와 함께 사용해야 합니다. 값은 다음 중 하나여야 합니다.

  • none: 적용할 작업이 없습니다.
  • refresh: VM을 중지하지 않고 적용할 수 있는 업데이트를 적용합니다.
  • restart: VM을 중지했다가 다시 시작합니다.
  • replace: VM을 다시 만듭니다.

  생략하면 업데이트에 필요한 중단이 가장 적은 작업이 사용됩니다.

예시

example-legacy-group이라는 MIG에서 기존 애플리케이션을 실행합니다. MIG의 각 VM은 기기 이름이 boot-disk인 부팅 디스크에 애플리케이션 데이터를 저장합니다. 인스턴스별 구성을 사용하여 각 부팅 디스크를 스테이트풀(Stateful)로 구성했습니다. 이제 애플리케이션 데이터를 추가 디스크로 이동했고, 새 이미지로 쉽게 업데이트할 수 있도록 각 VM의 부팅 디스크를 스테이트리스(Stateless)로 만들려고 합니다.

각 인스턴스(예: node-1)마다 다음 명령어를 실행합니다.

gcloud compute instance-groups managed instance-configs update example-legacy-group \
  --instance node-1 \
  --remove-stateful-disks boot-disk \
  --update-instance

이 명령은 다음을 수행합니다.

1. 기기 이름이 boot-disk인 디스크의 구성을 node-1의 인스턴스별 구성에서 삭제합니다.
2. --update-instance 플래그가 포함되어 있으므로 인스턴스별 구성 업데이트를 node-1 VM에 즉시 적용합니다. MIG는 관리형 인스턴스의 preservedStateFromConfig에서 부팅 디스크를 삭제하고 이 부팅 디스크를 스테이트리스(Stateless)로 취급합니다. 즉, MIG는 이후 인스턴스 재생성, 업데이트 또는 자동 복구 이벤트 시 인스턴스 템플릿의 부팅 이미지에서 디스크를 다시 만듭니다.

REST

MIG의 VM에서 스테이트풀(Stateful) 디스크를 분리하거나 개별적으로 스테이트리스(Stateless)로 선언하려면 연결된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 삭제하거나 다른 상태를 포함하지 않은 경우 전체 인스턴스별 구성을 삭제합니다. 그런 다음 인스턴스를 업데이트하여 구성을 적용합니다.

연관된 인스턴스별 구성에서 스테이트풀(Stateful) 디스크 구성을 삭제하려면 instanceGroupManagers.patchPerInstanceConfigs 메서드 또는 regionInstanceGroupManagers.patchPerInstanceConfigs 메서드를 사용합니다.

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instanceGroupManagers/NAME/patchPerInstanceConfigs

{
  "perInstanceConfigs": [
    {
      "name": "VM_NAME",
      "preservedState" : {
        "disks": {
          "DEVICE_NAME" : null
        },
        ...
      },
      "fingerprint: "FINGERPRINT"
      ...
    }
  ]
}

다음을 바꿉니다.

• PROJECT_ID: 요청의 프로젝트 ID입니다.
• ZONE: MIG가 위치한 영역입니다(영역 MIG에 적용).
  • 리전 MIG의 경우 zones/ZONE을 regions/REGION으로 바꾸고 MIG의 리전을 지정합니다.
• NAME: MIG의 이름입니다.
• VM_NAME: 스테이트풀(Stateful) 구성을 삭제할 VM의 이름입니다.
• DEVICE_NAME: 디스크를 연결하는 데 사용되는 기기 이름입니다.
• FINGERPRINT: 지정된 구성의 지문입니다(이미 있는 경우). 낙관적 잠금에 사용됩니다. 최신 지문을 보려면 get() 요청을 수행하여 리소스를 검색합니다.

patchPerInstanceConfigs 메서드는 지정된 인스턴스별 구성을 패치하지만 연결된 VM에 변경사항을 적용하지 않습니다. 변경사항은 인스턴스를 다시 만들거나 업데이트할 때 VM에 적용됩니다. 변경사항을 수동으로 적용하거나 자동화된 순차적 업데이트를 사용할 수 있습니다.

예시

example-legacy-group이라는 MIG에서 기존 애플리케이션을 실행합니다. MIG의 각 VM은 기기 이름이 boot-disk인 부팅 디스크에 애플리케이션 데이터를 저장합니다. 독립형 VM을 MIG로 마이그레이션할 때 MIG의 인스턴스별 구성에서 부팅 디스크를 스테이트풀(Stateful)로 구성했습니다. 애플리케이션 데이터를 추가 디스크로 이동했고 이제 새로운 이미지로 간편하게 업데이트할 수 있도록 각 VM의 부팅 디스크를 스테이트리스(Stateless)로 만들려고 합니다.

1. 인스턴스(예: 부팅 디스크의 값이 null인 node-1 인스턴스)에 대해 patchPerInstanceConfigs 메서드를 호출합니다.

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/patchPerInstanceConfigs
   
   {
     "perInstanceConfigs": [
       {
         "name": "node-1",
         "preservedState" : {
           "disks": {
             "boot-disk" : null
           }
         }
       }
     ]
   }
   

   이 메서드는 기기 이름이 boot- disk인 디스크의 구성을 node-1의 인스턴스별 구성에서 삭제합니다. 구성 업데이트는 아직 node-1 VM 인스턴스에 적용되지 않습니다. 구성 업데이트는 다음 인스턴스 재생성 또는 업데이트 시 적용됩니다.

2. 인스턴스별 구성 업데이트를 node-1 VM 인스턴스에 적용하려면 인스턴스의 instanceGroupManagers.applyUpdatesToInstances 메서드를 호출합니다.

   POST https://compute.googleapis.com/compute/v1/projects/example-project/zones/us-east1-c/instanceGroupManagers/example-legacy-group/applyUpdatesToInstances
   {
     "instances": ["/zones/us-east1-c/instances/node-1"]
   }
   

   MIG는 node-1 인스턴스의 preservedStateFromConfig에서 부팅 디스크를 삭제하고 디스크를 스테이트리스(Stateless)로 취급합니다. 즉, MIG는 이후 인스턴스 재생성, 업데이트 또는 자동 복구 이벤트 시 인스턴스 템플릿의 부팅 이미지에서 디스크를 다시 만듭니다.