VM 호스트 유지보수 정책 설정

콘솔

1. Google Cloud 콘솔에서 인스턴스 만들기 페이지로 이동합니다.

   인스턴스 만들기로 이동

2. VM의 이름을 지정합니다.

3. VM의 리전 및 영역을 선택합니다.

4. 머신 구성 섹션에서 다음을 수행합니다.

   1. VM의 머신 유형 세부정보를 지정합니다.
   2. VM 프로비저닝 모델 고급 설정 메뉴를 펼칩니다.
   3. 호스트 유지보수 시 메뉴에서 다음 단계 중 하나를 선택합니다.
   4. 유지보수 이벤트 중에 VM을 마이그레이션하려면 VM 인스턴스 마이그레이션을 선택합니다.
   5. 유지보수 이벤트 중에 VM을 중지하려면 VM 인스턴스 종료를 선택합니다.

5. 만들기를 클릭하여 VM을 만듭니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

새 VM의 호스트 유지보수 정책을 설정하려면 gcloud compute instances create 명령어를 사용합니다. 다음 파라미터 중 하나 이상을 포함합니다.

• --maintenance-policy: 호스트 유지보수 중에 VM이 마이그레이션되는지 또는 중지되는지를 나타냅니다. 이 속성을 생략하면 기본적으로 VM이 마이그레이션됩니다.
• --no-restart-on-failure 또는 --restart-on-failure: 호스트 오류 후 VM이 자동으로 다시 시작되는지 여부입니다. 기본적으로 VM은 실패가 감지될 때마다 항상 다시 시작됩니다.
• --local-ssd-recovery-timeout: Compute Engine이 호스트 오류 후 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간입니다. 기본값은 1시간입니다.

다음 명령어를 사용하여 새 VM의 호스트 유지보수 정책을 설정합니다. 플래그를 생략하면 플래그의 기본값이 사용됩니다.

  gcloud compute instances create VM_NAME \
      --maintenance-policy=MAINTENANCE_POLICY \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT

다음을 바꿉니다.

• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_ON_FAILURE_BEHAVIOR: VM의 동작을 다시 시작합니다(--no-restart-on-failure 또는 --restart-on-failure로 설정).
• SSD_RECOVERY_TIMEOUT: 응답하지 않는 VM에 연결된 로컬 SSD를 복구하는 데 걸리는 시간입니다. 유효한 값은 0시간~168시간(1시간 단위)입니다.

호스트 오류 감지 제한 시간 설정

Compute Engine이 응답이 없는 VM을 다시 시작하거나 종료하기 위해 대기하는 최대 시간을 설정하려면 gcloud compute instances create 명령어를 사용합니다. --host-error-timeout-seconds 플래그로 제한 시간을 지정합니다.

  gcloud beta compute instances create VM_NAME \
      --maintenance-policy=MAINTENANCE_POLICY \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT \
      --host-error-timeout-seconds=ERROR_DETECTION_TIMEOUT

다음을 바꿉니다.

• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_ON_FAILURE_BEHAVIOR: VM의 동작을 다시 시작합니다(--no-restart-on-failure 또는 --restart-on-failure로 설정).
• SSD_RECOVERY_TIMEOUT: Compute Engine이 응답하지 않는 VM에 연결된 로컬 SSD를 복구하는 데 걸린 시간입니다. 유효한 값은 0시간~168시간(1시간 단위)입니다.
• ERROR_DETECTION_TIMEOUT: Compute Engine이 응답하지 않는 VM을 다시 시작하기 전에 대기하는 시간(초)이며, 90부터 330까지의 값(30초 단위)입니다.

REST

Compute Engine API를 사용하여 새 VM의 호스트 유지보수 정책을 설정하려면 instances.insert 메서드를 사용합니다. 요청 본문의 scheduling 객체에 다음 속성 중 하나 이상을 포함합니다.

• onHostMaintenance: 호스트 유지보수 중에 VM이 마이그레이션되는지 또는 중지되는지를 나타냅니다. VM은 기본적으로 마이그레이션됩니다.
• automaticRestart: 호스트 오류 후 VM이 자동으로 다시 시작되는지 여부입니다. VM은 기본적으로 자동으로 다시 시작됩니다.
• localSsdRecoveryTimeout: Compute Engine이 호스트 오류를 감지한 후 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간입니다. 기본값은 1시간입니다.

      POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances

      {
        "name": "VM_NAME",

        "scheduling": {
          "onHostMaintenance": "MAINTENANCE_POLICY",
          "automaticRestart": "RESTART_POLICY,
          "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        }
      }

다음을 바꿉니다.

• PROJECT_ID: VM의 프로젝트입니다.
• ZONE: VM을 만들려는 영역입니다.
• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_POLICY: 이 VM의 다시 시작 정책입니다(true 또는 false).
• SSD_RECOVERY_TIMEOUT: Compute Engine이 응답하지 않는 VM에 연결된 로컬 SSD 디스크를 복구하는 데 걸린 시간입니다. 유효한 값은 0시간~168시간(1시간 단위)입니다.

호스트 오류 감지 제한 시간 설정

Compute Engine이 응답하지 않는 VM을 다시 시작하거나 종료하기 위해 대기하는 최대 시간을 설정하려면 베타 instances.insert 메서드를 사용합니다. 이 옵션은 미리보기에서 사용할 있기 때문입니다.

요청 본문의 scheduling 객체에 hostErrorTimeoutSeconds 속성을 추가합니다.

   POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances

   {
      "name": "VM_NAME",

      "scheduling": {
        "onHostMaintenance": "MAINTENANCE_POLICY",
        "automaticRestart": "RESTART_POLICY,
        "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
        "hostErrorTimeoutSeconds": HOST_ERROR_TIMEOUT,
      }
    }

다음을 바꿉니다.

• PROJECT_ID: VM의 프로젝트입니다.
• ZONE: VM을 만들려는 영역입니다.
• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_POLICY: 이 VM의 다시 시작 정책입니다(true 또는 false).
• SSD_RECOVERY_TIMEOUT: Compute Engine이 응답하지 않는 VM에 연결된 로컬 SSD 디스크를 복구하는 데 걸린 시간입니다. 유효한 값은 0시간~168시간(1시간 단위)입니다.
• HOST_ERROR_TIMEOUT: Compute Engine이 응답하지 않는 VM을 다시 시작하거나 종료하기 전에 대기하는 시간(초)입니다. 유효한 값은 90부터 330까지의 값(30초 단위)입니다.

콘솔

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

   VM 인스턴스로 이동

2. 설정을 변경할 VM을 클릭합니다. VM 세부정보 페이지가 표시됩니다.

3. VM 세부정보 페이지에서 다음 단계를 완료합니다.

   1. 페이지 상단에서 수정 버튼을 클릭합니다.
   2. 관리 섹션으로 이동합니다. 가용성 정책 섹션에서 호스트 유지보수 시 옵션과 자동 다시 시작 옵션을 설정할 수 있습니다.
   3. 저장을 클릭합니다.

gcloud

In the Google Cloud console, activate Cloud Shell.

Activate Cloud Shell

At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

gcloud compute instances set-scheduling 명령어를 사용하여 기존 VM의 호스트 유지보수 정책을 업데이트합니다. 이전 섹션의 VM 만들기 명령어에 설명된 것과 동일한 파라미터를 사용합니다.

    gcloud compute instances set-scheduling VM_NAME \
      --maintenance-policy=MAINTENANCE_POLICY \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT

다음을 바꿉니다.

• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_ON_FAILURE_BEHAVIOR: VM의 다시 시작 동작입니다(--no-restart-on-failure 또는 --restart-on-failure).
• SSD_RECOVERY_TIMEOUT: Compute Engine이 응답하지 않는 VM에 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간(시간 단위)입니다. 유효한 값은 0부터 168까지입니다.

호스트 오류 감지 제한 시간 업데이트

Compute Engine이 응답하지 않는 VM을 다시 시작하거나 종료하기 위해 대기하는 최대 시간을 업데이트하려면 gcloud beta compute instances set-scheduling 명령어를 사용합니다. 이 기능은 미리보기에서 사용할 수 있기 때문입니다.

--host-error-timeout-seconds 파라미터로 제한 시간을 업데이트합니다. 예를 들면 다음과 같습니다.

    gcloud beta compute instances set-scheduling VM_NAME \
      --maintenance-policy=MAINTENANCE_POLICY \
      --RESTART_ON_FAILURE_BEHAVIOR \
      --local-ssd-recovery-timeout=SSD_RECOVERY_TIMEOUT \
      --host-error-timeout-seconds=NUMBER_OF_SECONDS

다음을 바꿉니다.

• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_ON_FAILURE_BEHAVIOR: VM의 동작을 다시 시작합니다(--no-restart-on-failure 또는 --restart-on-failure로 설정).
• SSD_RECOVERY_TIMEOUT: Compute Engine이 응답하지 않는 VM에 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간(시간 단위)입니다. 유효한 값은 0부터 168까지입니다.
• NUMBER_OF_SECONDS: Compute Engine이 응답하지 않는 VM을 다시 시작하거나 종료하기 전에 대기하는 시간(초)이며, 90부터 330까지의 값(30초 단위)입니다.

REST

instances.setScheduling 메서드에 대한 POST 요청으로 기존 VM의 호스트 유지보수 정책을 업데이트합니다.

요청 본문에 다음 속성 중 하나 이상을 포함합니다.

• onHostMaintenance: 호스트 유지보수 중에 VM이 마이그레이션되는지 또는 중지되는지를 나타냅니다. VM은 기본적으로 마이그레이션됩니다.
• automaticRestart: 호스트 오류 후 VM이 자동으로 다시 시작되는지 여부입니다. VM은 기본적으로 자동으로 다시 시작됩니다.
• localSsdRecoveryTimeout: Compute Engine이 호스트 오류를 감지한 후 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간입니다. 생략할 경우 기본값은 1시간입니다.

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling

    {
      "onHostMaintenance": "MAINTENANCE_POLICY",
      "automaticRestart": RESTART_POLICY,
      "localSsdRecoveryTimeout": SSD_RECOVERY_TIMEOUT
    }

다음을 바꿉니다.

• PROJECT_ID: VM의 프로젝트입니다.
• ZONE: VM이 있는 영역입니다.
• VM_NAME: VM 이름입니다.
• MAINTENANCE_POLICY: 이 VM의 유지보수 정책입니다(TERMINATE 또는 MIGRATE).
• RESTART_POLICY: 이 VM의 다시 시작 정책입니다(true 또는 false).
• SSD_RECOVERY_TIMEOUT: Compute Engine에서 응답하지 않는 VM에 연결된 로컬 SSD 디스크를 복구하는 데 걸리는 시간(시간 단위)입니다. 유효한 값은 0부터 168까지입니다.

호스트 오류 감지 제한 시간 업데이트

Compute Engine은 응답이 없는 VM을 다시 시작하거나 종료하기 위해 대기하는 최대 시간을 업데이트하려면 베타 instances.setScheduling 메서드를 사용해야 합니다. 이 기능은 미리보기에서 사용할 수 있기 때문입니다.

요청 본문에 hostErrorTimeoutSeconds 파라미터를 추가합니다.

  POST https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setScheduling

  {
    "hostErrorTimeoutSeconds": NUMBER_OF_SECONDS,
  }

다음을 바꿉니다.

• PROJECT_ID: VM의 프로젝트입니다.
• ZONE: VM이 있는 영역입니다.
• VM_NAME: VM 이름입니다.
• NUMBER_OF_SECONDS: Compute Engine이 응답하지 않는 VM을 다시 시작하거나 종료하기 전에 대기하는 시간(초)이며, 90부터 330까지의 값(30초 단위)입니다.

콘솔

1. VM 인스턴스 페이지로 이동합니다.

   VM 인스턴스로 이동

2. 설정을 보려는 VM의 이름을 클릭합니다. VM 인스턴스 세부정보 페이지가 열립니다.

3. 관리 섹션으로 이동합니다. 가용성 정책 하위 섹션에 호스트 유지보수 시 및 자동으로 다시 시작에 대한 현재 설정이 표시됩니다.

gcloud

gcloud compute instances describe 명령어를 사용하여 VM의 호스트 유지보수 옵션 설정을 확인합니다.

    gcloud compute instances describe VM_NAME --format="yaml(scheduling)"

VM_NAME을 VM 이름으로 바꿉니다.

출력에는 VM의 호스트 오류 감지 제한 시간이 포함됩니다. 예를 들면 다음과 같습니다.

    scheduling:
      automaticRestart: true
      localSsdRecoveryTimeout:
        nanos: 0
        seconds: '10800'
      onHostMaintenance: MIGRATE
      preemptible: false
      provisioningModel: STANDARD

호스트 오류 감지 제한 시간 설정 보기

이 옵션은 미리보기에서만 사용할 수 있으므로 gcloud beta compute instances describe 명령어를 사용하여 hostErrorTimeoutSeconds의 현재 값을 확인합니다.

  gcloud beta compute instances describe VM_NAME --format="yaml(scheduling)"

VM_NAME을 VM 이름으로 바꿉니다.

출력에는 VM의 호스트 오류 감지 제한 시간이 포함됩니다. 예를 들면 다음과 같습니다.

  scheduling:
    automaticRestart: true
    hostErrorTimeoutSeconds: 120
    localSsdRecoveryTimeout:
      nanos: 0
      seconds: '10800'
    onHostMaintenance: MIGRATE
    preemptible: false
    provisioningModel: STANDARD

REST

VM의 호스트 유지보수 설정을 보려면 instances.get 메서드를 사용합니다.

  GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

다음을 바꿉니다.

• PROJECT_ID: VM이 있는 프로젝트입니다.
• ZONE: VM이 있는 영역입니다.
• VM_NAME: VM 이름입니다.

출력에서 scheduling 객체에는 VM의 호스트 유지보수 정책이 포함됩니다. 예를 들면 다음과 같습니다.

  "scheduling": {
      "onHostMaintenance": "MIGRATE",
      "automaticRestart": true,
      "preemptible": false,
      "provisioningModel": "STANDARD",
      "localSsdRecoveryTimeout": {
        "seconds": "10800",
        "nanos": 0
      }
    }

호스트 오류 제한 시간 설정 보기

이 옵션은 미리보기에서만 사용할 수 있으므로 베타 instances.get 메서드에 대한 GET 요청으로 현재 hostErrorTimeoutSeconds 설정을 확인합니다.

 GET https://compute.googleapis.com/compute/beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME

다음을 바꿉니다.

• PROJECT_ID: VM의 프로젝트입니다.
• ZONE: VM이 있는 영역입니다.
• VM_NAME: VM 이름입니다.

출력에서 scheduling 객체에는 VM의 호스트 오류 감지 제한 시간이 포함됩니다. 예를 들면 다음과 같습니다.

  "scheduling": {
    "hostErrorTimeoutSeconds": 120
  }