Mengelola periode pemeliharaan cluster AlloyDB untuk PostgreSQL

Halaman ini menunjukkan cara melakukan tindakan berikut yang terkait dengan pemeliharaan cluster AlloyDB untuk PostgreSQL:

  • Menetapkan, melihat, dan menghapus masa pemeliharaan.
  • Melihat peristiwa pemeliharaan mendatang yang dijadwalkan.
  • Mengonfigurasi dan menghapus periode penolakan pemeliharaan.

Semua tindakan yang tercantum berlaku untuk cluster utama dan sekunder.

Untuk mengetahui ringkasan cara kerja pemeliharaan dengan cluster AlloyDB, lihat Ringkasan pemeliharaan.

Menetapkan masa pemeliharaan pada cluster

Konsol

  1. Buka halaman Cluster.

    Buka Cluster

  2. Klik cluster di kolom Nama Resource.

  3. Di halaman Ringkasan, di bagian Pemeliharaan, klik Edit.

  4. Di Masa pemeliharaan, pilih hari dalam seminggu untuk masa pemeliharaan ini.

    Opsi default adalah Periode apa pun. Saat Anda membuat cluster, cluster akan ditetapkan ke masa pemeliharaan default ini.

  5. Pilih jam dalam sehari untuk masa pemeliharaan ini.

  6. Klik Perbarui untuk menyimpan perubahan.

gcloud

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

Untuk menetapkan masa pemeliharaan pada cluster, jalankan perintah gcloud clusters update dengan flag --maintenance-window-day dan --maintenance-window-hour:

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

Ganti kode berikut:

  • CLUSTER_ID: cluster untuk menyetel masa pemeliharaan.

  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

  • DAY_OF_WEEK: hari dalam seminggu, dalam zona waktu Waktu Universal Terkoordinasi (UTC), untuk periode pemeliharaan ini. Nilai yang valid adalah MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, dan SUNDAY.

    Nilai defaultnya adalah Jendela apa pun. Saat Anda membuat cluster, cluster akan ditetapkan ke masa pemeliharaan default ini.

  • HOUR_OF_DAY: bilangan bulat antara 0 dan 23 yang merepresentasikan jam dalam sehari, dalam zona waktu UTC, untuk masa pemeliharaan ini.

Jika Anda membuat perubahan pada setelan masa pemeliharaan saat cluster sedang menjalani pemeliharaan atau dijadwalkan untuk pemeliharaan, perubahan tersebut tidak akan diterapkan hingga setelah pemeliharaan saat ini atau terjadwal selesai.

Menghapus masa pemeliharaan

Konsol

  1. Buka halaman Cluster.

    Buka Cluster

  2. Klik cluster di kolom Nama Resource.

  3. Di halaman Ringkasan, di bagian Pemeliharaan, klik Edit.

  4. Di Maintenance window, pilih Any window.

  5. Klik Perbarui untuk menyimpan perubahan.

gcloud

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

Untuk menghapus masa pemeliharaan dari cluster, jalankan perintah gcloud clusters update dengan flag --maintenance-window-any:

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

Ganti kode berikut:

  • CLUSTER_ID: cluster untuk menyetel masa pemeliharaan.

  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Melihat masa pemeliharaan cluster

Konsol

  1. Buka halaman Cluster.

    Buka Cluster

  2. Klik cluster di kolom Nama Resource.

  3. Di halaman Ringkasan, di Pemeliharaan, lihat detail periode pemeliharaan untuk cluster Anda.

gcloud

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

Untuk meninjau periode pemeliharaan saat ini di cluster, jalankan perintah gcloud alloydb clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Ganti kode berikut:

  • CLUSTER_ID: cluster untuk menyetel masa pemeliharaan.

  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Jika cluster memiliki masa pemeliharaan yang ditetapkan, output perintah akan mencakup baris yang mirip dengan berikut ini:

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

Jika output tidak menyertakan bagian maintenanceUpdatePolicy, berarti cluster tidak memiliki masa pemeliharaan yang ditetapkan.

Melihat pemeliharaan mendatang pada cluster

Konsol

  1. Buka halaman Cluster.

    Buka Cluster

  2. Temukan cluster Anda, lalu lihat kolom Pemeliharaan untuk mengetahui informasi tentang masa pemeliharaan mendatang.

gcloud

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

Untuk melihat pemeliharaan mendatang yang direncanakan untuk cluster yang telah menetapkan masa pemeliharaan, jalankan perintah gcloud clusters describe:

gcloud alloydb clusters describe CLUSTER_ID \
  --region LOCATION_ID

Ganti kode berikut:

  • CLUSTER_ID: cluster untuk menyetel masa pemeliharaan.

  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Jika cluster memiliki peristiwa pemeliharaan terencana di masa mendatang, output perintah akan menyertakan baris yang mirip dengan berikut ini:

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

Stempel waktu berformat UTC menentukan saat AlloyDB berencana memulai update software sistem semua node dalam cluster ini.

Mengaktifkan notifikasi pemeliharaan

Notifikasi pemeliharaan dinonaktifkan secara default. Saat Anda memilih untuk menerima notifikasi email tentang peristiwa pemeliharaan AlloyDB mendatang, perhatikan hal-hal berikut:

  • Anda menerima notifikasi otomatis tentang acara tersebut segera setelah dijadwalkan. Peristiwa pemeliharaan dijadwalkan setidaknya satu minggu sebelumnya.
  • Notifikasi pemeliharaan diaktifkan di Google Cloud level project. Anda tidak dapat memilih untuk menerima notifikasi tentang sebagian kecil cluster dalam project.
  • Anda hanya dapat mengaktifkan notifikasi untuk Anda sendiri. Setiap pengguna harus mengaktifkan notifikasi pemeliharaan secara terpisah.

Untuk mengetahui informasi selengkapnya, lihat Ringkasan pemeliharaan.

Untuk menerima notifikasi email otomatis setiap kali peristiwa pemeliharaan dijadwalkan atau dibatalkan untuk cluster yang telah menetapkan periode pemeliharaan, ikuti langkah-langkah berikut menggunakan konsol Google Cloud :

  1. Buka halaman Cluster.

    Buka Cluster

  2. Klik cluster di kolom Nama Resource.

  3. Di halaman Ringkasan, di bagian Pemeliharaan, klik Edit di baris Notifications:.

  4. Klik Komunikasi.

  5. Di baris untuk AlloyDB, Masa pemeliharaan, pilih tombol di kolom Email.

Mengonfigurasi periode penolakan pemeliharaan

Untuk mencegah operasi pemeliharaan selama jangka waktu tertentu, Anda dapat mengonfigurasi periode penolakan pemeliharaan. Anda dapat menyetel penolakan pemeliharaan pada cluster yang menjalankan AlloyDB versi terbaru. Periode penolakan pemeliharaan dapat berlangsung dari satu hingga 30 hari.

Menetapkan periode penolakan pemeliharaan

Untuk mengonfigurasi periode penolakan pemeliharaan, Anda menetapkan tanggal mulai, tanggal akhir, dan waktu saat interval dimulai dan berakhir.

Tanggal mulai dan akhir harus dalam format berikut:

  • YYYY-MM-DD: menunjukkan tanggal tertentu

Tanggal mulai, tanggal akhir, dan waktu menggunakan zona waktu UTC.

gcloud

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

Untuk menambahkan periode penolakan pemeliharaan ke cluster AlloyDB, jalankan perintah gcloud alloydb clusters update dengan flag deny-maintenance-period-start-date, deny-maintenance-period-end-date, dan deny-maintenance-period-time:

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

Ganti kode berikut:

  • CLUSTER_ID: cluster yang akan dikonfigurasi untuk periode bebas pemeliharaan.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.
  • START_DATE: tanggal mulai periode bebas pemeliharaan dalam format UTC YYYY-MM-DD.
  • END_DATE: akhir periode bebas pemeliharaan dalam format YYYY-MM-DD UTC.
  • TIME: waktu periode bebas pemeliharaan dalam format HH:MM UTC. Jam ditampilkan dalam format 24 jam dengan nilai berkisar dari 00:00 hingga 23:59—misalnya, 16:45.

REST v1

Contoh ini menambahkan periode pemeliharaan yang ditolak ke cluster yang ada. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Metode: projects.locations.clusters.instances.patch.

Sebelum menggunakan data permintaan apa pun, lakukan penggantian berikut:

  • CLUSTER_ID: cluster yang akan dikonfigurasi untuk periode bebas pemeliharaan.
  • PROJECT_ID: ID project tempat cluster ditempatkan.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.
  • START_YEAR: tahun saat periode bebas pemeliharaan dimulai dalam format YYYY.
  • START_MONTH: bulan saat periode bebas pemeliharaan dimulai dalam format MM. Angka nol di awal untuk bulan satu digit bersifat opsional—misalnya, 2 dan 02 sama-sama valid untuk bulan Februari.
  • START_DAY: hari saat periode bebas pemeliharaan dimulai dalam format DD. Angka nol di awal untuk hari satu digit bersifat opsional—misalnya, 1 dan 01 valid untuk hari pertama setiap bulan.
  • END_YEAR: tahun saat periode bebas pemeliharaan berakhir dalam format YYYY.
  • END_MONTH: bulan saat periode bebas pemeliharaan berakhir dalam format MM.
  • END_DAY: hari saat periode bebas pemeliharaan berakhir dalam format DD.
  • HOUR(S): jam periode bebas perawatan dalam format 24 jam—misalnya, 16. Angka nol di awal untuk jam satu digit bersifat opsional—misalnya, 2 dan 02 sama-sama valid.
  • MINUTE(S): menit periode bebas pemeliharaan yang menerima nilai dari 0 hingga 59—misalnya, 45. Angka nol di awal untuk menit satu digit bersifat opsional— 7 dan 07 valid.

Untuk menambahkan periode pemeliharaan yang ditolak, gunakan permintaan PATCH berikut:

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}

Parameter kueri maintenance_update_policy.deny_maintenance_periods memberi tahu API untuk memperbarui kolom denyMaintenancePeriods dalam blok maintenanceUpdatePolicy.

Isi JSON permintaan akan terlihat seperti berikut:

"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
     }
   }
 ]
},

Menolak pemeliharaan mendatang

Periode penolakan pemeliharaan lebih diutamakan daripada pemeliharaan terjadwal. Jika terjadi konflik waktu, periode tolak pemeliharaan akan menggantikan masa pemeliharaan terjadwal.

Menetapkan periode penolakan yang bertentangan dengan peristiwa pemeliharaan terjadwal tidak akan segera membatalkan pemeliharaan dan menghapus jadwal. AlloyDB menampilkan pemeliharaan terjadwal yang ada sebagai mendatang, tetapi membatalkan masa pemeliharaan terjadwal saat waktu yang dijadwalkan dimulai.

Untuk membantu menerapkan update penting, sistem biasanya tidak mengizinkan penetapan periode penolakan untuk melewati lebih dari satu peristiwa pemeliharaan dan dalam kasus yang jarang terjadi, sistem dapat menerapkan pemeliharaan darurat di luar preferensi pemeliharaan yang dikonfigurasi.

Menghapus periode penolakan pemeliharaan dari cluster

Anda dapat menghapus periode penolakan pemeliharaan kapan saja.

gcloud

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

Untuk menghapus periode pemeliharaan yang ditolak dari cluster AlloyDB, jalankan perintah gcloud alloydb clusters update dengan flag remove-deny-maintenance-period:

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

Ganti kode berikut:

  • CLUSTER_ID: cluster yang akan dihapus periode tolak pemeliharaannya.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

REST v1

Contoh ini menghapus periode penolakan pemeliharaan dari cluster AlloyDB. Untuk mengetahui daftar lengkap parameter panggilan ini, lihat Metode: projects.locations.clusters.patch.

Sebelum menggunakan data permintaan apa pun, lakukan penggantian berikut:

  • CLUSTER_ID: ID cluster yang akan ditambahkan periode pemeliharaan yang ditolak.
  • PROJECT_ID: ID project tempat cluster ditempatkan.
  • LOCATION_ID: region Google Cloud tempat cluster ini berada—misalnya, us-central1.

Untuk menghapus periode pemeliharaan yang ditolak, gunakan permintaan PATCH berikut:

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}

Parameter kueri maintenance_update_policy.deny_maintenance_periods memberi tahu API untuk memperbarui kolom denyMaintenancePeriods dalam blok maintenanceUpdatePolicy.

Isi JSON permintaan akan terlihat seperti berikut:

{}