Melakukan pemeliharaan mandiri

Anda dapat melakukan pemeliharaan mandiri jika perlu menerapkan update AlloyDB for PostgreSQL terbaru ke cluster Anda sesegera mungkin. Mengupdate ke versi terbaru dapat membuka fitur AlloyDB, menerapkan patch, dan memungkinkan Anda menetapkan periode penolakan untuk mencegah gangguan selama periode waktu yang sensitif.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan pemeliharaan.

Kasus penggunaan pemeliharaan mandiri

AlloyDB biasanya menerapkan pemeliharaan ke cluster Anda, melakukan operasi pemeliharaan untuk mengupgrade software database di cluster. Secara default, AlloyDB melakukan pemeliharaan di luar jam kerja regional. Anda dapat secara opsional menetapkan masa pemeliharaan untuk menentukan waktu pemeliharaan terjadwal pilihan dan menerima notifikasi tentang pemeliharaan terjadwal mendatang. Untuk rilis dan versi PostgreSQL tertentu, pemeliharaan diselesaikan terlebih dahulu untuk cluster tanpa jendela pemeliharaan, lalu dijadwalkan untuk cluster dengan jendela pemeliharaan.

Anda dapat memutuskan untuk melakukan pemeliharaan layanan mandiri karena alasan berikut:

  • Cluster Anda melewati pemeliharaan. Hal ini terjadi jika Anda menyiapkan periode penolakan, atau jika cluster Anda dalam status bootstrapping selama migrasi.
  • Cluster Anda memerlukan update sebelum pemeliharaan terjadwal dilakukan.
  • Anda perlu menetapkan periode penolakan pada cluster yang belum diupdate. Cluster dengan instance pada versi sebelumnya tidak selalu mendukung penetapan periode penolakan.
  • Anda ingin menjalankan pemeliharaan dengan irama yang disesuaikan atau tidak teratur. Dalam hal ini, Anda dapat menetapkan periode penolakan, lalu melakukan pemeliharaan mandiri saat diperlukan. Periode penolakan tidak menghalangi pemeliharaan mandiri.

Granularitas resource selama update

AlloyDB hanya mendukung pemeliharaan di tingkat cluster. Dalam cluster, AlloyDB menentukan urutan update instance. AlloyDB mencoba dan menyelesaikan pemeliharaan untuk setiap instance secara independen, sehingga instance dapat menggunakan rilis yang berbeda. Misalnya, cluster dapat melewati pemeliharaan pada instance yang ada karena periode penolakan, lalu membuat instance pada versi terbaru setelahnya.

Melihat versi terbaru yang tersedia

Lihat log perubahan pemeliharaan AlloyDB untuk mengetahui versi terbaru. Log perubahan diperbarui setelah pemeliharaan diterapkan ke cluster di semua region. Untuk mengetahui informasi selengkapnya tentang cara versi terbaru diterapkan ke wilayah, lihat Versi terbaru.

Melihat versi saat ini dari instance

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Melihat versi hanya didukung di tingkat instance.

  1. Untuk melihat versi pemeliharaan instance saat ini, jalankan perintah gcloud alloydb instances describe:

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

    Ganti kode berikut:

    • INSTANCE_ID: ID instance yang versinya sedang Anda lihat.
    • CLUSTER_ID: ID cluster tempat instance ditempatkan.
    • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

  2. Dalam respons, temukan kolom maintenanceVersionName untuk melihat versi yang dijalankan instance. Contoh:

    "maintenanceVersionName": "POSTGRES_16.20251015.04_00"

Memperbarui cluster ke versi terbaru yang tersedia

gcloud

Untuk menggunakan gcloud CLI, Anda dapat menginstal dan melakukan inisialisasi Google Cloud CLI, atau Anda dapat menggunakan Cloud Shell.

Untuk mengupdate cluster ke versi terbaru, jalankan perintah gcloud alloydb clusters update dengan flag maintenance-version:

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

Ganti kode berikut:

  • CLUSTER_ID: ID cluster yang akan diupdate ke versi terbaru.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Contoh respons:

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

REST v1

Contoh ini mengupdate cluster ini ke versi terbaru. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Metode: projects.locations.clusters.patch.

Sebelum menggunakan data permintaan apa pun, lakukan penggantian berikut:

  • CLUSTER_ID: cluster yang akan diupdate ke versi terbaru.
  • PROJECT_ID: ID project tempat cluster ditempatkan.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Untuk mengupdate cluster ke versi terbaru, gunakan permintaan PATCH berikut:

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

Parameter kueri maintenance_version_selection_policy menentukan versi yang akan digunakan untuk mengupdate instance cluster.

Isi JSON permintaan terlihat seperti berikut:

{
  "maintenanceVersionSelectionPolicy": "MAINTENANCE_VERSION_SELECTION_POLICY_LATEST",
}

Langkah berikutnya