호스트 유지보수 이벤트 수동 시작

이 페이지에서는 지원되는 Compute Engine 인스턴스에서 호스트 유지보수 이벤트를 수동으로 시작하는 방법을 설명합니다. 이 기능을 사용하면 유지보수 이벤트를 시작하여 인스턴스의 유지보수 시점을 제어할 수 있습니다. 이는 성능 저하 또는 다운타임의 영향을 받을 수 있는 워크로드에 유용하며, 유지보수 기간이 특정 시간에 시작되어야 합니다.

유지보수 이벤트를 수동으로 시작하면 호스트 유지보수가 즉시 시작됩니다. 유지보수 이벤트의 시작 날짜 또는 시간을 지정할 수 없습니다. 이 기능을 사용하지 않으면 예정된 유지보수 알림에 표시된 시간에 유지보수 이벤트가 발생합니다.

애플리케이션이 유지보수 이벤트를 처리하는 방식을 먼저 테스트하려면 유지보수 이벤트를 시뮬레이션하면 됩니다.

제한사항

다음 머신 유형을 사용하는 인스턴스의 호스트 유지보수 이벤트를 수동으로 시작할 수 있습니다.

시작하기 전에

  • 아직 인증을 설정하지 않았다면 설정합니다. 인증은 Google Cloud 서비스 및 API에 액세스하기 위해 ID를 확인하는 프로세스입니다. 로컬 개발 환경에서 코드 또는 샘플을 실행하려면 다음 옵션 중 하나를 선택하여 Compute Engine에 인증하면 됩니다.

    Select the tab for how you plan to use the samples on this page:

    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 유지보수를 관리하는 데 필요한 권한을 얻으려면 관리자에게 프로젝트에 대한 Compute 인스턴스 관리자 (v1) (roles/compute.instanceAdmin.v1) IAM 역할을 부여해 달라고 요청하세요. 역할 부여에 대한 자세한 내용은 프로젝트, 폴더, 조직에 대한 액세스 관리를 참조하세요.

이 사전 정의된 역할에는 VM 유지보수를 관리하는 데 필요한 권한이 포함되어 있습니다. 필요한 정확한 권한을 보려면 필수 권한 섹션을 펼치세요.

필수 권한

VM 유지보수를 관리하려면 다음 권한이 필요합니다.

  • 컴퓨팅 인스턴스에 관한 정보를 가져오려면 다음을 실행합니다. compute.instances.get

커스텀 역할이나 다른 사전 정의된 역할을 사용하여 이 권한을 부여받을 수도 있습니다.

호스트 유지보수 이벤트 수동 시작

Compute Engine은 여러 방법을 통해 예정된 유지보수 이벤트에 대한 알림을 보냅니다. 알림의 정보를 사용하여 유지보수 이벤트를 수동으로 시작할 수 있는 기간을 결정할 수 있습니다.

알림 정보 확인

다음 방법으로 유지보수 이벤트 알림을 확인할 수 있습니다.

호스트 유지보수 이벤트에 관한 알림에 canReschedule=True 및 maintenanceStatus=Pending가 포함된 경우 원하는 시점에 유지보수를 시작하거나 windowStartTime에 지정된 시간에 유지보수 이벤트가 발생할 때까지 기다릴 수 있습니다.

알림이 없고 유지보수 이벤트를 수동으로 시작하려고 하면 다음 메시지가 표시됩니다.

There is no reschedulable upcoming maintenance.

이는 유지보수 이벤트가 예약되지 않았으며 조치를 취할 필요가 없음을 나타냅니다.

유지보수 이벤트 시작

예약된 시간을 기다리지 않고 원하는 시간에 호스트 유지보수를 시작할 수 있습니다. Google Cloud CLI 또는 REST를 사용하여 유지보수 이벤트를 트리거하면 즉시 시작됩니다.

gcloud

유지보수 이벤트를 시작하려면 compute instances perform-maintenance 명령어를 사용합니다. 명령어를 입력하면 즉시 호스트 유지보수가 시작됩니다.

gcloud compute instances perform-maintenance INSTANCE_NAME \
    --zone=ZONE

다음을 바꿉니다.

  • INSTANCE_NAME: 컴퓨팅 인스턴스의 이름입니다.
  • ZONE: 인스턴스가 있는 영역입니다.

응답은 다음 예시와 유사합니다.

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

응답에서 canReschedule은 false로 설정되고 maintenanceStatus는 ONGOING로 설정됩니다. 이는 호스트 유지보수 작업이 진행 중임을 나타냅니다.

REST

유지보수 이벤트를 시작하려면 instances.performMaintenance 메서드를 사용하여 POST 요청을 만듭니다.

POST: https://compute.googleapis.com/compute/v1/projects/PROJECT_NAME/zones/ZONE/instances/INSTANCE_NAME/performMaintenance

다음을 바꿉니다.

  • PROJECT_NAME: 프로젝트 이름
  • ZONE: 컴퓨팅 인스턴스가 있는 영역
  • INSTANCE_NAME: 인스턴스 이름

응답은 다음과 같습니다.

upcomingMaintenance:{
  "canReschedule":false
  "latestWindowStartTime": "2023-12-01T19:00:01Z"
  "maintenanceStatus":"ONGOING"
  "type":"SCHEDULED"
  "windowEndTime": "2023-12-01T22:00:00Z"
  "windowStartTime": "2023-12-01T19:00:00Z"
}

응답에서 canReschedule은 false로 설정되고 maintenanceStatus는 ONGOING로 설정됩니다. 이는 호스트 유지보수 작업이 진행 중임을 나타냅니다.

다음 단계