Mengelola update pemeliharaan AlloyDB menggunakan cluster penyiapan

Untuk meminimalkan risiko pada workload produksi AlloyDB for PostgreSQL, Anda dapat menggunakan cluster staging untuk menguji fitur, performa, dan fungsi baru sebelum menerapkan update ke sistem produksi. Cluster staging adalah salinan cluster produksi yang menambahkan lapisan kontrol ke proses update pemeliharaan. Dengan menggunakan cluster staging untuk menguji update pemeliharaan, Anda dapat mengidentifikasi dan mengatasi potensi masalah di lingkungan non-produksi. Pendekatan ini mengurangi risiko waktu nonaktif dan penurunan performa di sistem produksi Anda.

Update pemeliharaan untuk AlloyDB dilakukan secara berkala, sering kali setiap bulan. Update mencakup fitur baru, perbaikan bug, upgrade kompatibilitas database, dan perbaikan terkait keamanan. Meskipun rilis AlloyDB kompatibel dengan versi sebelumnya, sebaiknya uji rilis baru di lingkungan staging untuk memastikan stabilitas dan prediktabilitas database untuk aplikasi penting di cluster produksi Anda.

Untuk menggunakan cluster penyiapan, Anda harus mengikuti langkah-langkah umum berikut:

1. Siapkan cluster staging.
2. Konfigurasi masa pemeliharaan pada cluster produksi.
3. Mengelola update cluster penyiapan.
4. Mengelola update cluster produksi.

Pendekatan validasi penyiapan untuk pemeliharaan AlloyDB ini memastikan bahwa lingkungan produksi Anda tetap stabil, berperforma baik, dan aman sekaligus mendapatkan manfaat dari fitur dan patch AlloyDB terbaru.

Diagram berikut menunjukkan hubungan antara cluster penyiapan dan cluster produksi, serta alur operasional proses update:

Untuk mempelajari lebih lanjut cara kerja update pemeliharaan dengan cluster AlloyDB, lihat Ringkasan pemeliharaan. Untuk mempelajari lebih lanjut cara mengelola periode pemeliharaan, lihat Mengelola periode pemeliharaan cluster AlloyDB untuk PostgreSQL.

Sebelum memulai

Project Google Cloud yang Anda gunakan harus diaktifkan untuk mengakses AlloyDB.

Untuk menyiapkan cluster staging, Anda harus membuat atau sudah memiliki cluster produksi AlloyDB. Untuk mengetahui informasi selengkapnya, lihat Membuat cluster dan instance utamanya.

Anda harus memiliki salah satu peran IAM berikut di project Google Cloud yang Anda gunakan:

• roles/alloydb.admin: peran IAM yang telah ditentukan sebelumnya untuk Admin AlloyDB
• roles/owner: peran IAM dasar Pemilik
• roles/editor: peran IAM dasar Editor

Jika Anda tidak memiliki salah satu peran ini, hubungi Administrator Organisasi Anda untuk meminta akses.

Menyiapkan cluster staging

Kunci keberhasilan strategi penahapan terlebih dahulu adalah memastikan cluster penahapan Anda mirip dengan lingkungan produksi dan menerima update sebelum produksi. Anda mengonfigurasi strategi mengutamakan penyiapan sementara jika tidak menetapkan masa pemeliharaan di cluster penyiapan sementara. AlloyDB pertama-tama mengupdate cluster tanpa masa pemeliharaan.

Membuat cluster staging dari cadangan produksi Anda

Deploy cluster staging yang mencerminkan lingkungan produksi Anda, dan pastikan cluster staging Anda memiliki versi, konfigurasi, dan data AlloyDB yang sama dengan cluster produksi Anda.

Untuk memastikan cluster staging Anda identik dengan lingkungan produksi, gunakan perintah restore untuk meng-clone database produksi ke cluster staging dan untuk memastikan kesamaan data dan kecocokan konfigurasi. Sebaiknya Anda juga memisahkan lingkungan staging dan produksi di project yang berbeda.

Anda dapat menggunakan dua metode berikut untuk membuat cadangan produksi:

• Buat cluster penyiapan baru dengan melakukan pemulihan penuh cadangan cluster produksi yang ada. Metode ini tidak melibatkan pemulihan database. Namun, bergantung pada jadwal pencadangan, data dapat berusia hingga 24 jam. Untuk menggunakan metode ini, lihat Memulihkan cluster dari cadangan tersimpan.
• Buat cluster penyiapan baru dengan melakukan pemulihan point-in-time (PITR) ke waktu tertentu dari cadangan database produksi yang ada, termasuk ke waktu terbaru. Dengan opsi ini, Anda akan mendapatkan data terbaru, dan metodenya lebih mudah. Namun, bergantung pada waktu pencadangan PITR terakhir, mungkin perlu waktu lebih lama untuk memulihkan atau memulihkan data ke waktu yang Anda tentukan. Untuk menggunakan metode ini, lihat Menggunakan pemulihan point-in-time (PITR).

Pastikan masa pemeliharaan tidak disetel di cluster staging

Jangan tetapkan masa pemeliharaan untuk cluster staging Anda. Secara default, cluster AlloyDB yang baru dibuat, bahkan yang Anda pulihkan dari cadangan, tidak memiliki masa pemeliharaan yang ditetapkan. Ini adalah status yang benar untuk lingkungan penyiapan Anda. AlloyDB mengupdate cluster yang tidak memiliki masa pemeliharaan terjadwal sebelum mengupdate cluster dengan masa pemeliharaan terjadwal.

Anda dapat memverifikasi bahwa tidak ada masa pemeliharaan yang ditetapkan sebagai berikut:

Konsol

1. Buka halaman Cluster.

   Buka Cluster

2. Klik cluster di kolom Nama Resource. Halaman Ringkasan akan terbuka.

3. Di halaman Overview, di bagian Maintenance, lihat detail masa pemeliharaan untuk cluster Anda.

   Catatan: Konsol memerlukan waktu untuk menampilkan detail di bagian Pemeliharaan AlloyDB.
   Google Cloud

4. Opsional: Di halaman Insight sistem, Anda dapat melihat detail status operasi pemeliharaan, seperti Linimasa Peristiwa.

5. Untuk melihat pengelolaan Unified Maintenance, masukkan "Cloud Hub maintenance" di kotak penelusuran dan pilih Maintenance. Di halaman ini, Anda dapat melihat ringkasan pemeliharaan, pemeliharaan yang dikontrol Google, dan detail pemeliharaan terencana.

gcloud

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

   gcloud alloydb clusters describe STAGING_CLUSTER_ID \
       --region=LOCATION_ID \
       --project=PROJECT_ID

2. Cari kolom maintenanceSchedule di output. Jika tidak ada periode pemeliharaan yang ditetapkan, kolom ini tidak ada atau kosong. Jika, karena alasan apa pun, masa pemeliharaan ditetapkan, hapus.

   gcloud alloydb clusters update STAGING_CLUSTER_ID \
       --region=LOCATION_ID \
       --clear-maintenance-window \
       --project=PROJECT_ID

Mengonfigurasi masa pemeliharaan pada cluster produksi

Untuk cluster produksi, penting untuk menjadwalkan masa pemeliharaan. Dengan begitu, Anda dapat mengontrol kapan update terjadi dan menyelaraskannya dengan periode traffic rendah bisnis Anda.

Menetapkan masa pemeliharaan pada cluster produksi

Jadwalkan masa pemeliharaan untuk cluster produksi Anda. Pilih hari dan jam saat sistem produksi Anda mengalami beban terendah. Total waktu yang diperlukan untuk satu peristiwa pemeliharaan dapat bervariasi.

AlloyDB secara otomatis menunda update ke cluster produksi Anda setidaknya selama satu minggu setelah mengupdate cluster staging Anda. Jika Anda menemukan masalah setelah cluster penyiapan diperbarui, Anda dapat menolak update pemeliharaan produksi hingga 30 hari, dan bekerja sama dengan Google Cloud Dukungan untuk menyelesaikan masalah.

Tetapkan masa pemeliharaan di cluster produksi Anda sebagai berikut:

Konsol

1. Buka halaman Cluster.

   Buka Cluster

2. Klik cluster di kolom Nama Resource.

3. Di halaman Ringkasan, di bagian Pemeliharaan, klik Edit. Jendela konfigurasi akan terbuka.

4. Di bagian Periode pemeliharaan pilihan, pilih hari dalam seminggu untuk periode pemeliharaan ini. Opsi defaultnya adalah "Jendela apa pun".

   Saat Anda membuat cluster, AlloyDB akan menetapkan periode pemeliharaan default ini untuk cluster tersebut.

5. Jika Anda memilih hari untuk update pemeliharaan, lalu pilih jam untuk masa pemeliharaan.

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 mengambil detail konfigurasi cluster AlloyDB, jalankan perintah berikut menggunakan perintah gcloud alloydb clusters update.

gcloud alloydb clusters update PRODUCTION_CLUSTER_ID \
    --region=LOCATION_ID \
    --maintenance-window-day=DAY_OF_WEEK \
    --maintenance-window-hour=HOUR_OF_DAY \
    --project=PROJECT_ID

Lakukan penggantian berikut:

• PRODUCTION_CLUSTER_ID: ID cluster produksi Anda.
• LOCATION_ID: Google Cloud region.
• DAY_OF_WEEK: hari pilihan untuk pemeliharaan, seperti SUNDAY.

• HOUR_OF_DAY: jam pilihan untuk pemeliharaan dalam UTC (0-23).

  Contoh berikut menunjukkan cara menyetel masa pemeliharaan untuk hari Minggu pukul 02.00 UTC:

  gcloud alloydb clusters update my-prod-cluster \
      --region=us-central1 \
      --maintenance-window-day=SUNDAY \
      --maintenance-window-hour=2 \
      --project=my-production-project

Verifikasi jendela pemeliharaan di cluster produksi

Untuk mengonfirmasi bahwa periode pemeliharaan telah ditetapkan untuk cluster produksi Anda, jalankan perintah gcloud alloydb clusters describe:

gcloud alloydb clusters describe PRODUCTION_CLUSTER_ID \
--region=LOCATION_ID \
--project=PROJECT_ID

Output menampilkan kolom maintenanceSchedule dengan hari dan jam pemeliharaan yang ditentukan.

Mengaktifkan notifikasi pemeliharaan

Sebaiknya Anda memilih untuk menerima notifikasi tentang peristiwa pemeliharaan terjadwal untuk cluster produksi Anda. Notifikasi ini membantu Anda merencanakan waktu untuk memulai pengujian.

Untuk mengaktifkan notifikasi pemeliharaan, ikuti langkah-langkah berikut:

1. Buka halaman Cluster.

   Buka Cluster

2. Klik cluster di kolom Nama Resource. Halaman Ringkasan akan terbuka.

3. Di halaman Overview, di bagian Maintenance, klik Show details untuk meluaskan bagian tersebut. Kemudian, klik Edit di baris Notifikasi. Tindakan ini akan membuka halaman Komunikasi.

4. Di halaman Komunikasi, pilih tab Komunikasi produk.

5. Di baris untuk AlloyDB, di kolom Email, alihkan tombol notifikasi ke Aktif.

Setelah Anda mengonfigurasi masa pemeliharaan untuk cluster produksi, AlloyDB akan memperbaruinya paling cepat tujuh hari setelah update cluster staging Anda. Saat memilih untuk menerima notifikasi, Anda akan menerima notifikasi email bahwa update pemeliharaan dijadwalkan untuk cluster produksi Anda.

Update cluster staging

Gunakan lingkungan penyiapan Anda untuk memvalidasi update produksi mendatang.

Memeriksa status pra-update

Karena tidak memiliki masa pemeliharaan, cluster staging Anda termasuk dalam cluster pertama yang menerima update. Namun, AlloyDB tidak mengirimkan notifikasi untuk cluster yang tidak dikonfigurasi dengan periode pemeliharaan. Meski begitu, Anda dapat memantau kapan update pemeliharaan terjadi menggunakan Logs Explorer di konsol Google Cloud .

1. Di konsol Google Cloud , buka halaman Logs Explorer:

   Buka Logs Explorer

   Jika Anda menggunakan kotak penelusuran untuk menemukan halaman ini, pilih hasil dengan subjudul Logging.

2. Pilih Semua Resource, pilih cluster penyiapan, lalu klik Terapkan.

3. Pilih All lognames, pilih maintenance_events, lalu klik Apply.

4. Di panel Linimasa, pilih rentang waktu saat cluster penyusunan menerima update.

Melakukan verifikasi fungsional pasca-update

Setelah AlloyDB memperbarui cluster staging, lakukan pengujian fungsional untuk mengonfirmasi bahwa update tersebut aman dan cocok untuk diterapkan ke lingkungan produksi Anda.

Melakukan verifikasi performa pasca-update

Verifikasi cluster penyiapan Anda setelah update pemeliharaan selesai. Menilai dampak performa apa pun pada database Anda setelah melakukan update cluster penyiapan. Lakukan pengujian fungsional dan performa yang komprehensif untuk memastikan aplikasi Anda berperilaku seperti yang diharapkan dan memenuhi SLA performa.

Untuk memastikan stabilitas dan pengoperasian yang optimal, lakukan hal berikut:

• Bandingkan tolok ukur pra-update dengan metrik utama.
• Jalankan pengujian beban untuk mengidentifikasi regresi.
• Menganalisis performa kueri.
• Pantau pemanfaatan resource.

Mengambil tindakan berdasarkan hasil verifikasi

Tinjau hasil verifikasi dan lakukan tindakan berikut berdasarkan hasilnya:

• Verifikasi berhasil: jika pengujian fungsional dan performa Anda di cluster staging berhasil, berarti lingkungan staging Anda bebas error dan Anda dapat membiarkan pemeliharaan produksi dilanjutkan sesuai jadwal di jendela yang dijadwalkan. Bersiap untuk update produksi dan memberi tahu pemangku kepentingan yang relevan.
• Verifikasi gagal: jika pengujian fungsional dan performa Anda di cluster staging gagal dan Anda mengalami error fungsional, penurunan performa, atau perilaku yang tidak terduga di lingkungan staging setelah update pemeliharaan, maka Anda harus menolak pemeliharaan produksi.

Menolak peristiwa pemeliharaan terjadwal

Untuk menolak peristiwa pemeliharaan terjadwal untuk cluster produksi, Anda harus menetapkan tanggal mulai, tanggal akhir, dan waktu saat interval dimulai dan berakhir.

Tanggal mulai dan akhir harus dalam format berikut: YYYY-MM-DD. Tanggal mulai, tanggal akhir, dan waktu semuanya menggunakan zona waktu UTC.

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, selesaikan langkah-langkah berikut:

1. 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

2. 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 UTC YYYY-MM-DD.
   • TIME: waktu periode bebas pemeliharaan dalam format UTC HH:MM. Jam ditampilkan dalam format 24 jam dengan nilai berkisar dari 00:00 hingga 23:59—misalnya, 16:45.

3. Dokumentasikan semua masalah, termasuk pesan error, metrik performa, dan langkah-langkah untuk mereproduksi masalah.

4. Buka kasus dukungan berprioritas tinggi dengan Google Cloud dan berikan semua masalah yang didokumentasikan. Google Cloud akan bekerja sama dengan Anda untuk menganalisis dan menyelesaikan masalah tersebut.

Pembaruan cluster produksi

Jika verifikasi staging berhasil dan Anda mengizinkan pemeliharaan produksi dilanjutkan, update akan terjadi selama periode pemeliharaan terjadwal.

Verifikasi masa pemeliharaan

Untuk memantau peristiwa pemeliharaan mendatang di cluster produksi Anda, ikuti langkah-langkah berikut:

Konsol

1. Buka halaman Cluster.

   Buka Cluster

2. Klik cluster di kolom Nama Resource. Halaman Ringkasan akan terbuka.

3. Di halaman Overview, di bagian Maintenance, lihat detail masa pemeliharaan untuk cluster Anda.

   Catatan: Konsol memerlukan waktu untuk menampilkan detail di bagian Pemeliharaan AlloyDB.
   Google Cloud

4. Opsional: Di halaman Insight sistem, Anda dapat melihat detail status operasi pemeliharaan, seperti Linimasa Peristiwa.

5. Untuk melihat pengelolaan Unified Maintenance, masukkan "Cloud Hub maintenance" di kotak penelusuran dan pilih Maintenance. Di halaman ini, Anda dapat melihat ringkasan pemeliharaan, pemeliharaan yang dikontrol Google, dan detail pemeliharaan terencana.

gcloud

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

Jalankan perintah berikut menggunakan gcloud alloydb clusters describe:

gcloud alloydb clusters describe PRODUCTION_CLUSTER_ID \
    --region=LOCATION_ID \
    --project=PROJECT_ID

Jika peristiwa pemeliharaan direncanakan, output akan mencakup maintenanceSchedule dan startTime. Jika memilih untuk menerima notifikasi, Anda juga akan menerima notifikasi email.

Memantau produksi selama masa pemeliharaan

Meskipun Google Cloud mengotomatiskan proses pemeliharaan, sebaiknya Anda memantau lingkungan produksi untuk hal-hal berikut selama periode pemeliharaan terjadwal:

• Kondisi aplikasi: pantau log aplikasi dan health check untuk mengetahui tanda-tanda gangguan.
• Konektivitas database: pastikan aplikasi Anda dapat terhubung kembali ke database setelah gangguan.
• Metrik AlloyDB: gunakan Google Cloud Monitoring untuk mengamati metrik AlloyDB—CPU, memori, koneksi, dan jeda replikasi—dan untuk memastikan bahwa metrik tersebut kembali ke tingkat yang diharapkan setelah update.

Verifikasi update setelah pemeliharaan

Setelah update pemeliharaan selesai, verifikasi lingkungan produksi Anda untuk fungsionalitas penting dan indikator performa.

• Fungsi utama aplikasi: jalankan uji coba singkat pada fitur aplikasi yang paling penting.
• Pemeriksaan performa dasar: tinjau dasbor untuk melihat lonjakan latensi atau konsumsi resource.

Catatan: Jika terjadi masalah produksi yang tidak Anda deteksi selama penyiapan, ikuti protokol dukungan standar. Untuk memulai penyelidikan guna menentukan penyebab masalah, hubungi Dukungan Pelanggan Google.