PostgreSQL용 AlloyDB 클러스터 유지보수 기간 관리

이 페이지에서는 PostgreSQL용 AlloyDB 클러스터 유지관리와 관련된 다음 작업을 수행하는 방법을 보여줍니다.

  • 유지보수 기간을 설정, 확인, 삭제합니다.
  • 예정된 유지보수 이벤트를 확인합니다.
  • 유지보수 거부 기간을 구성하고 삭제합니다.

나열된 모든 작업은 기본 클러스터와 보조 클러스터 모두에 적용됩니다.

AlloyDB 클러스터의 유지보수 작동 방식에 대한 개요는 유지보수 개요를 참고하세요.

클러스터 유지보수 기간 설정

콘솔

  1. 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터를 클릭합니다.

  3. 개요 페이지의 유지보수에서 수정을 클릭합니다.

  4. 유지보수 기간에서 이 유지보수 기간의 요일을 선택합니다.

    기본 옵션은 시스템 자동 선택 기간입니다. 클러스터를 만들면 클러스터에 이 기본 유지보수 기간이 할당됩니다.

  5. 이 유지보수 기간의 시간을 선택합니다.

  6. 업데이트를 클릭하여 변경사항을 저장합니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

클러스터에서 유지보수 기간을 설정하려면 --maintenance-window-day 및 --maintenance-window-hour 플래그와 함께 gcloud clusters update 명령어를 실행합니다.

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-day DAY_OF_WEEK \
  --maintenance-window-hour HOUR_OF_DAY

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 설정할 클러스터입니다.

  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

  • DAY_OF_WEEK: 이 유지보수 기간의 협정 세계시 (UTC) 시간대 기준 요일입니다. 유효한 값은 MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, SUNDAY입니다.

    기본값은 모든 창입니다. 클러스터를 만들면 클러스터에 이 기본 유지보수 기간이 할당됩니다.

  • HOUR_OF_DAY: 이 유지보수 기간의 UTC 시간대 기준 시간(0~23 사이의 정수)

클러스터 유지보수가 이미 진행 중이거나 예약된 상태에서 유지보수 기간 설정을 변경하면 현재 또는 예약된 유지보수가 완료된 후에 변경사항이 적용됩니다.

유지보수 기간 지우기

콘솔

  1. 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터를 클릭합니다.

  3. 개요 페이지의 유지보수에서 수정을 클릭합니다.

  4. 유지보수 기간에서 시스템 자동 선택 기간을 선택합니다.

  5. 업데이트를 클릭하여 변경사항을 저장합니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

클러스터에서 유지보수 기간을 삭제하려면 --maintenance-window-any 플래그와 함께 gcloud clusters update 명령어를 실행합니다.

gcloud alloydb clusters update CLUSTER_ID \
  --region LOCATION_ID \
  --maintenance-window-any

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 설정할 클러스터입니다.

  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

클러스터의 유지보수 기간 보기

콘솔

  1. 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터를 클릭합니다.

  3. 개요 페이지의 유지보수에서 클러스터의 유지보수 기간 세부정보를 확인합니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

클러스터의 현재 유지보수 기간을 검토하려면 gcloud alloydb clusters describe 명령어를 실행합니다.

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 설정할 클러스터입니다.

  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

클러스터에 유지보수 기간이 설정되어 있으면 명령어 출력에 다음과 유사한 줄이 포함됩니다.

maintenanceUpdatePolicy:
  maintenanceWindows:
  - day: TUESDAY
    startTime:
      hours: 23

출력에 maintenanceUpdatePolicy 섹션이 포함되지 않으면 클러스터에 유지보수 기간이 설정되지 않은 것입니다.

클러스터에서 예정된 유지보수 보기

콘솔

  1. 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 클러스터를 찾아 예정된 유지보수 기간에 관한 정보를 유지보수 열에서 확인합니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

유지보수 기간이 설정된 클러스터에 예정된 유지보수를 확인하려면 gcloud clusters describe 명령어를 실행합니다.

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 설정할 클러스터입니다.

  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

클러스터에 향후 예정된 유지보수 이벤트가 있으면 명령어 출력에 다음과 유사한 줄이 포함됩니다.

maintenanceSchedule:
  startTime: 2024-07-03T09:46:40Z

UTC 형식의 타임스탬프는 AlloyDB가 이 클러스터의 모든 노드의 시스템 소프트웨어를 업데이트하기 시작할 시점을 지정합니다.

유지보수 알림 수신 동의

유지보수 알림은 기본적으로 사용 중지되어 있습니다. 예정된 AlloyDB 유지보수 이벤트에 관한 이메일 알림을 수신하도록 선택할 때는 다음 사항에 유의하세요.

  • 이벤트가 예약되면 이벤트에 관한 자동 알림이 전송됩니다. 유지보수 이벤트는 최소 1주일 전에 예약됩니다.
  • 유지보수 알림은 Google Cloud 프로젝트 수준에서 사용 설정됩니다. 프로젝트의 일부 클러스터에 대해서만 알림을 받도록 선택할 수는 없습니다.
  • 본인에 대해서만 알림을 사용 설정할 수 있습니다. 각 사용자는 유지보수 알림을 수신하기 위해 별도로 선택해야 합니다.

자세한 내용은 유지보수 개요를 참고하세요.

유지보수 기간이 설정된 클러스터에 유지보수 이벤트가 예약되거나 취소될 때마다 자동 이메일 알림을 받으려면 Google Cloud 콘솔을 사용하여 다음 단계를 따르세요.

  1. 클러스터 페이지로 이동합니다.

    클러스터로 이동

  2. 리소스 이름 열에서 클러스터를 클릭합니다.

  3. 개요 페이지의 유지보수에서 Notifications: 행의 수정을 클릭합니다.

  4. 커뮤니케이션을 클릭합니다.

  5. AlloyDB, 유지보수 기간 행에서 이메일 열의 전환 버튼을 선택합니다.

유지보수 거부 기간 구성

특정 기간 동안 유지보수 작업을 방지하려면 유지보수 거부 기간을 구성하면 됩니다. 최신 버전의 AlloyDB를 실행하는 클러스터에서 유지보수 거부를 설정할 수 있습니다. 유지보수 거부 기간은 1~30일입니다.

유지보수 거부 기간 설정

유지보수 거부 기간을 구성하려면 해당 기간의 시작일, 종료일, 그리고 간격 시작 및 종료 시간을 설정합니다.

시작일과 종료일은 다음 형식이어야 합니다.

  • YYYY-MM-DD: 특정 날짜를 나타냅니다.

시작일, 종료일, 시간은 UTC 시간대입니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

AlloyDB 클러스터에 유지보수 거부 기간을 추가하려면 deny-maintenance-period-start-date, deny-maintenance-period-end-date, deny-maintenance-period-time 플래그와 함께 gcloud alloydb clusters update 명령어를 실행합니다.

gcloud alloydb clusters update CLUSTER_ID \
   --region LOCATION_ID \
   --deny-maintenance-period-start-date START_DATE \
   --deny-maintenance-period-end-date END_DATE \
   --deny-maintenance-period-time TIME

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 구성할 클러스터입니다.
  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).
  • START_DATE: 유지보수 기간 시작일(YYYY-MM-DD UTC 형식)입니다.
  • END_DATE: 유지보수 기간의 종료일(YYYY-MM-DD UTC 형식)입니다.
  • TIME: 유지보수 기간의 시간(HH:MM UTC 형식)입니다. 시간은 24시간 형식으로 표시되며 값의 범위는 00:00~23:59입니다(예: 16:45).

REST v1

이 예에서는 기존 클러스터에 유지보수 거부 기간을 추가합니다. 이 호출의 전체 매개변수 목록은 메서드: projects.locations.clusters.instances.patch를 참고하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 기간을 구성할 클러스터입니다.
  • PROJECT_ID: 클러스터가 배치된 프로젝트의 ID입니다.
  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).
  • START_YEAR: 유지보수 기간이 시작되는 연도입니다(YYYY 형식).
  • START_MONTH: MM 형식의 유지보수 무료 기간이 시작되는 월입니다. 한 자리 숫자로 된 달의 경우 앞의 0은 선택사항입니다. 예를 들어 2와 02는 모두 2월에 유효합니다.
  • START_DAY: 유지보수 기간이 시작되는 날짜입니다(DD 형식). 한 자리 숫자로 된 날의 경우 앞의 0은 선택사항입니다. 예를 들어 한 달의 첫날에 1와 01 모두 사용할 수 있습니다.
  • END_YEAR: 유지보수 기간이 종료되는 연도입니다(YYYY 형식).
  • END_MONTH: 유지보수 무료 기간이 종료되는 월입니다(MM 형식).
  • END_DAY: 유지보수 기간이 종료되는 날짜입니다(DD 형식).
  • HOUR(S): 유지보수 기간 시간(24시간 형식)(예: 16) 한 자리 숫자로 된 시간의 경우 앞의 0은 선택사항입니다. 예를 들어 2와 02는 모두 유효합니다.
  • MINUTE(S): 유지보수 기간의 분입니다. 0~59 값을 허용합니다(예: 45). 한 자리 분의 선행 0은 선택사항입니다. 7와 07는 유효합니다.

유지보수 거부 기간을 추가하려면 다음 PATCH 요청을 사용하세요.

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

maintenance_update_policy.deny_maintenance_periods 쿼리 매개변수는 API에 maintenanceUpdatePolicy 블록 내의 denyMaintenancePeriods 필드를 업데이트하도록 지시합니다.

요청 JSON 본문은 다음과 같습니다.

"maintenanceUpdatePolicy": {
 "denyMaintenancePeriods": [
   {
     "startDate": {
       "year": START_YEAR,
       "month": START_MONTH,
       "day": START_DAY
     },
     "endDate": {
       "year": END_YEAR,
       "month": END_MONTH,
       "day": END_DAY
     },
     "time": {
       "hours": TIME
       "minutes": TIME
     }
   }
 ]
},

예정된 유지보수 거부

유지보수 거부 기간은 예약된 유지보수보다 우선 적용됩니다. 시간 충돌이 발생하면 유지보수 거부 기간이 예약된 유지보수 기간보다 우선 적용됩니다.

예약된 유지보수 이벤트와 충돌하는 거부 기간을 설정해도 유지보수가 즉시 취소되고 일정이 삭제되지는 않습니다. AlloyDB는 기존 예약된 유지보수를 예정으로 표시하지만 예약된 시간이 시작되면 예약된 유지보수 기간을 취소합니다.

중요 업데이트를 적용할 수 있도록 시스템에서는 일반적으로 두 개 이상의 유지보수 이벤트를 건너뛰도록 거부 기간을 설정하는 것을 허용하지 않으며, 드문 경우에 구성된 유지보수 환경설정 외에 긴급 유지보수를 적용할 수 있습니다.

클러스터에서 유지보수 거부 기간 삭제

언제든지 거부 유지보수 기간을 삭제할 수 있습니다.

gcloud

gcloud CLI를 사용하려면 Google Cloud CLI를 설치 및 초기화하거나 Cloud Shell을 사용합니다.

AlloyDB 클러스터에서 유지보수 거부 기간을 삭제하려면 remove-deny-maintenance-period 플래그와 함께 gcloud alloydb clusters update 명령어를 실행합니다.

gcloud alloydb clusters update CLUSTER_ID --region LOCATION_ID  --remove-deny-maintenance-period

다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 거부 기간을 삭제할 클러스터입니다.
  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

REST v1

이 예시에서는 AlloyDB 클러스터에서 유지보수 거부 기간을 삭제합니다. 이 호출의 전체 매개변수 목록은 메서드: projects.locations.clusters.patch를 참고하세요.

요청 데이터를 사용하기 전에 다음을 바꿉니다.

  • CLUSTER_ID: 유지보수 거부 기간을 추가할 클러스터의 ID입니다.
  • PROJECT_ID: 클러스터가 배치된 프로젝트의 ID입니다.
  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

거부 유지보수 기간을 삭제하려면 다음 PATCH 요청을 사용하세요.

PATCH https://alloydb.googleapis.com/v1/{cluster.name=projects/PROJECT_ID/locations/LOCATION_ID/clusters/CLUSTER_ID?update_mask=maintenance_update_policy.deny_maintenance_periods}

maintenance_update_policy.deny_maintenance_periods 쿼리 매개변수는 API에 maintenanceUpdatePolicy 블록 내의 denyMaintenancePeriods 필드를 업데이트하도록 지시합니다.

요청 JSON 본문은 다음과 같습니다.

{}