셀프서비스 유지보수 수행

최신 PostgreSQL용 AlloyDB 업데이트를 클러스터에 최대한 빨리 적용해야 하는 경우 셀프서비스 유지보수를 실행할 수 있습니다. 최신 버전으로 업데이트하면 AlloyDB 기능을 잠금 해제하고, 패치를 적용하고, 민감한 기간 동안 중단을 방지하기 위해 거부 기간을 설정할 수 있습니다.

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

자가 유지관리 사용 사례

AlloyDB는 일반적으로 클러스터에 유지보수를 적용하여 클러스터의 데이터베이스 소프트웨어를 업그레이드하는 유지보수 작업을 실행합니다. 기본적으로 AlloyDB는 지역별 영업시간 외에 유지보수를 실행합니다. 원하는 경우 유지보수 기간을 설정하여 선호하는 예약 유지보수 시간을 정의하고 예정된 예약 유지보수에 대한 알림을 받을 수 있습니다. 특정 출시 및 PostgreSQL 버전의 경우 유지보수는 유지보수 기간이 없는 클러스터에 대해 먼저 완료된 후 유지보수 기간이 있는 클러스터에 대해 예약됩니다.

다음과 같은 이유로 셀프 서비스 유지보수를 수행할 수 있습니다.

  • 클러스터에서 유지보수를 건너뛰었습니다. 거부 기간을 설정한 경우 또는 마이그레이션 중에 클러스터가 부트스트랩 상태인 경우에 발생합니다.
  • 예약된 유지보수가 발생하기 전에 클러스터를 업데이트해야 합니다.
  • 최신 상태가 아닌 클러스터에 거부 기간을 설정해야 합니다. 이전 버전의 인스턴스가 있는 클러스터는 거부 기간 설정을 지원하지 않을 수 있습니다.
  • 맞춤설정되거나 불규칙한 주기로 유지보수를 실행하려는 경우 이 경우 거부 기간을 설정한 다음 필요할 때 셀프 서비스 유지보수를 실행할 수 있습니다. 거부 기간은 셀프서비스 유지보수를 차단하지 않습니다.

업데이트 중 리소스 세분성

AlloyDB는 클러스터 수준의 유지관리만 지원합니다. 클러스터 내에서 AlloyDB는 인스턴스 업데이트 순서를 결정합니다. AlloyDB는 각 인스턴스에 대해 독립적으로 유지보수를 시도하고 완료하므로 인스턴스가 서로 다른 버전에 있을 수 있습니다. 예를 들어 클러스터가 거부 기간으로 인해 기존 인스턴스의 유지보수를 건너뛰고 나중에 최신 버전으로 인스턴스를 만들 수 있습니다.

사용 가능한 최신 버전 보기

최신 버전은 AlloyDB 유지보수 변경 로그를 참고하세요. 변경사항 로그는 모든 지역의 클러스터에 유지보수가 적용된 후에 업데이트됩니다. 최신 버전이 리전에 적용되는 방식에 대한 자세한 내용은 최신 버전을 참고하세요.

인스턴스의 현재 버전 보기

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

버전 확인은 인스턴스 수준에서만 지원됩니다.

  1. 인스턴스의 현재 유지보수 버전을 보려면 gcloud alloydb instances describe 명령어를 실행합니다.

    gcloud alloydb instances describe INSTANCE_ID \
--cluster CLUSTER_ID \
--region LOCATION_ID

    다음을 바꿉니다.

    • INSTANCE_ID: 버전을 보고 있는 인스턴스의 ID입니다.
    • CLUSTER_ID: 인스턴스가 배치된 클러스터의 ID
    • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

  2. 응답에서 maintenanceVersionName 필드를 찾아 인스턴스가 실행 중인 버전을 확인합니다. 예를 들면 다음과 같습니다.

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

클러스터를 사용 가능한 최신 버전으로 업데이트

gcloud

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

클러스터를 최신 버전으로 업데이트하려면 maintenance-version 플래그와 함께 gcloud alloydb clusters update 명령어를 실행합니다.

gcloud alloydb clusters update CLUSTER_ID \
--region LOCATION_ID \
--maintenance-version=latest

다음을 바꿉니다.

  • CLUSTER_ID: 최신 버전으로 업데이트할 클러스터의 ID입니다.
  • LOCATION_ID: 이 클러스터가 있는 Google Cloud 리전입니다(예: us-central1).

응답 예:

Operation ID: operation-1746645915198-63490b152e3c8-2aed1bd1-3fd73867
Updating cluster...done.

REST v1

이 예시에서는 이 클러스터를 최신 버전으로 업데이트합니다. 이 호출의 전체 파라미터 목록은 메서드: projects.locations.clusters.patch를 참고하세요.

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

  • CLUSTER_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_version_selection_policy}

maintenance_version_selection_policy 쿼리 매개변수는 클러스터의 인스턴스를 업데이트할 버전을 지정합니다.

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

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

다음 단계