Memelihara Amazon DocumentDB

Amazon DocumentDB secara berkala melakukan dua jenis pemeliharaan:

Tambalan mesin dan pembaruan OS menggunakan tiga kategori siklus hidup yang sama - opsional, wajib, dan paksa - dengan pemberitahuan yang sama dan perilaku penerapan untuk setiap kategori. Rilis mesin juga memiliki kategori keempat: versi minor, yang Anda tingkatkan secara manual. Kategori-kategorinya adalah:

Tambalan mesin dilepaskan ke dalam satu kategori (opsional, wajib, atau dipaksa) dan tetap di sana. Kemajuan pembaruan OS: sebagian besar dimulai sebagai opsional dan, jika tidak diterapkan, transisi ke yang diperlukan dan akhirnya dipaksakan. Waktu yang tepat tergantung pada tambalan dan diterbitkan dalam notifikasi AHD dan bidang tanggal yang dikembalikan oleh describe-pending-maintenance-actions (lihatTerapkan tanggal). Catatan Rilis Amazon DocumentDB menggunakan nama kategori ini saat mengumumkan perubahan mesin.

Menerapkan patch mesin apa pun membuat cluster offline sebentar. Sisa topik ini membahas cara kerja jendela pemeliharaan, cara menemukan pekerjaan yang tertunda, cara menerapkan tambalan mesin dan versi minor, cara kerja pembaruan OS, dan penanganan khusus untuk cluster global.

Penomoran versi mesin

Amazon DocumentDB menggunakan dua pengidentifikasi versi terpisah:

Anda dapat menentukan versi mesin dari awalan versi patch mesin, seperti yang ditunjukkan pada tabel berikut.

Untuk memeriksa versi patch cluster Anda berjalan, sambungkan dan jalankandb.runCommand({getEngineVersion: 1}).

Untuk daftar versi patch mesin yang dirilis dan isi masing-masing, lihatCatatan rilis.

Mengelola jendela pemeliharaan Amazon DocumentDB Anda

Setiap cluster dan setiap instans memiliki jendela pemeliharaan mingguan 30 menit sendiri—periode ketika modifikasi terjadwal dan patching perangkat lunak dijalankan. Sebagian besar acara selesai dalam 30 menit; yang lebih besar dapat berjalan lebih lama.

Jika Anda tidak memilih jendela saat membuat sumber daya, Amazon DocumentDB menetapkan satu secara acak dalam blok harian 8 jam yang ditentukan untuk Wilayah, pada hari yang dipilih secara acak. Pilih jendela yang meminimalkan dampak pada aplikasi Anda—malam hari atau akhir pekan, misalnya.

Untuk upgrade mesin database, Amazon DocumentDB menggunakan jendela cluster, bukan jendela instance individual.

Tabel berikut menunjukkan blok waktu default per Wilayah.

Mengubah jendela pemeliharaan Amazon DocumentDB Anda

Pilih jendela lalu lintas terendah yang Anda bisa, dan sesuaikan seiring waktu saat pola lalu lintas Anda bergeser. Cluster atau instance tidak tersedia selama jendela hanya jika perubahan sistem—operasi penyimpanan skala atau perubahan kelas instance, misalnya—memerlukan pemadaman, dan hanya selama perubahan itu benar-benar dibutuhkan.

Pemberitahuan untuk patch mesin Amazon DocumentDB

Ketika patch mesin yang diperlukan tersedia di AWS Wilayah, setiap AWS akun dengan klaster Amazon DocumentDB yang terpengaruh di Wilayah tersebut menerima pemberitahuan melalui Dasbor Health (AHD) dan melalui email (dikirim ke AWS alamat pengguna root akun). Satu pemberitahuan dikirimkan per versi mesin Amazon DocumentDB yang terpengaruh. Anda dapat menemukannya di bawah Perubahan terjadwal di AHD. Setiap notifikasi mencantumkan waktu ketersediaan tambalan, jadwal penerapan otomatis, kluster yang terpengaruh, dan catatan rilis.

Pemberitahuan keluar sekitar dua hari sebelum jendela aplikasi otomatis terbuka. Misalnya, patch wajib yang dirilis Senin pukul 00:00 UTC memenuhi syarat untuk mendaftar otomatis pada hari Rabu pukul 00:00 UTC. Jika jendela pemeliharaan klaster Anda adalah Rabu pukul 12:00 UTC, tambalan akan berlaku secara otomatis pada hari Rabu itu—sekitar 12 jam setelah jendela penerapan otomatis terbuka. Jika jendela pemeliharaan Anda adalah Selasa pukul 12:00 UTC, tambalan menunggu seminggu penuh sebelum diterapkan secara otomatis.

Anda memiliki dua opsi setelah menerima pemberitahuan: menerapkan sendiri tambalan sebelum tanggal penerapan otomatis, atau tunggu hingga otomatis diterapkan selama jendela pemeliharaan yang akan datang (default). Untuk mendaftar sendiri, buka tab Maintenance & backup cluster dan cari entri jenisnya. system-update

Tambalan opsional dan versi minor baru tidak menghasilkan pemberitahuan AHD atau email. Untuk melacaknya, tonton catatan Rilis Amazon DocumentDB.

Patch paksa (kategori paling langka, dicadangkan untuk perbaikan keamanan paling kritis) juga diumumkan melalui AHD dan email. Tidak seperti tambalan yang diperlukan, tambalan tersebut berlaku di luar jendela pemeliharaan Anda, sehingga contoh pengaturan waktu penerapan otomatis di atas tidak berlaku.

Bereaksi terhadap notifikasi tambalan secara terprogram

AWS Health terintegrasi dengan Amazon EventBridge, yang memungkinkan Anda membangun aplikasi berbasis peristiwa di lebih dari 20 target, termasuk Amazon Simple Queue Service (SQS) AWS Lambda dan Amazon Simple Queue Service (SQS). Untuk bereaksi terhadap ketersediaan tambalan mesin secara terprogram, konfigurasikan terhadap acara tersebut. EventBridge AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_SCHEDULED Dari sana Anda dapat menangkap data acara, meningkatkan acara tambahan, mengirim pemberitahuan push melalui AWS Console Mobile Application, atau mengambil tindakan lain yang Anda butuhkan.

Jika Amazon DocumentDB membatalkan tambalan (jarang), Anda menerima pemberitahuan AHD dan email tentang pembatalan tersebut. Gunakan kode AWS_DOCDB_DB_PATCH_UPGRADE_MAINTENANCE_CANCELLED acara dengan Amazon EventBridge untuk menangani kasus ini. Untuk selengkapnya tentang menulis aturan, lihat Panduan EventBridge Pengguna Amazon.

Melihat tindakan pemeliharaan Amazon DocumentDB yang tertunda

Gunakan Konsol Manajemen AWS or AWS CLI untuk memeriksa pemeliharaan apa yang tertunda untuk cluster atau instance.

Pembaruan yang tertunda muncul dengan tipe tindakansystem-update, yang mencakup tambalan mesin dan pembaruan OS.

Saat pembaruan tertunda, Anda dapat:

Jendela pemeliharaan mengontrol saat operasi yang tertunda dimulai, bukan berapa lama waktu yang dibutuhkan untuk menyelesaikannya.

Terapkan tanggal

Setiap tindakan pemeliharaan yang tertunda membawa hingga tiga tanggal penerapan. Mereka muncul di AWS CLI output untuk describe-pending-maintenance-actions dan menunjukkan kapan tindakan akan berjalan. Bidang adalah null untuk pemeliharaan opsional.

Untuk menunda tindakan yang tertunda, pindahkan jendela pemeliharaan Anda ke hari berikutnya sebelumnyaAutoAppliedAfterDate. Setelah AutoAppliedAfterDate berlalu, tindakan akan diterapkan secara otomatis selama jendela pemeliharaan berikutnya. Setelah ForcedApplyDate berlalu, tidak ada penangguhan lebih lanjut yang mungkin dilakukan. Jendela penangguhan yang tepat bervariasi per tambalan; tanggal diterbitkan dalam pemberitahuan AHD dan output. AWS CLI

Pembaruan mesin Amazon DocumentDB

Ketika Anda telah mengidentifikasi patch mesin yang tertunda, gunakan salah satu prosedur berikut untuk menerapkan atau menjadwalkannya. Anda dapat menjalankan prosedur ini baik dari Konsol Manajemen AWS atau AWS CLI.

Baca ketersediaan selama penambalan

Amazon DocumentDB engine 5.0 dan 8.0 mempertahankan ketersediaan baca selama penambalan saat cluster memiliki beberapa instance. Amazon DocumentDB menambal instance pembaca secara bergulir, dalam tiga kelompok, sehingga pembaca yang tersisa terus melayani lalu lintas. Penulis sebentar tidak tersedia saat menambal. Untuk mencapai nol downtime baca, atur preferensi baca Anda sehingga bacaan dapat kembali ke penulis: secondaryPreferred atau primaryPreferred bekerja; primary atau secondary sendirian dapat menimbulkan downtime baca.

Saat pembaca menambal, keseluruhan throughput baca cluster turun sementara. Untuk menjaga throughput tetap stabil, berikan pembaca tambahan sebelum peningkatan dan hapus setelah selesai.

Pada engine 3.6 dan 4.0, fitur ketersediaan baca ini tidak berlaku: patch mesin menyebabkan waktu henti yang lebih lama yang memengaruhi pembacaan dan penulisan. Untuk meningkatkan ke versi utama yang melakukannya, lihatPeningkatan versi utama Amazon DocumentDB di tempat.

Panjang waktu henti tambalan

Engine-patch downtime bervariasi. Faktor terbesar adalah penggunaan CPU dan tekanan memori pada instance pada saat patch, jadi ukuran yang tepat instance Anda penting. Untuk meminimalkan waktu henti, jalankan versi engine utama Amazon DocumentDB terbaru dan sebarkan instans di beberapa Availability Zone.

Pembaruan dan penggantian tambalan

Amazon DocumentDB memonitor tambalan setelah rilis. Dalam kasus yang jarang terjadi ketika masalah diidentifikasi, Amazon DocumentDB menghentikan sementara peluncuran saat menyiapkan versi yang diperbarui. Ketika ini terjadi, cluster yang belum menerima tambalan tidak lagi melihatnya sebagai tindakan pemeliharaan yang tersedia, dan pemberitahuan perubahan terjadwal yang sesuai di ditarik. Dasbor Health Cluster yang sudah menjalankan versi yang terpengaruh terus beroperasi secara normal dan tidak memerlukan tindakan dari Anda.

Patch yang diperbarui segera menyusul. Ketika tersedia di Wilayah Anda, Anda menerima pemberitahuan baru melalui Dasbor Health dan email, seperti yang dijelaskan dalamPemberitahuan untuk patch mesin Amazon DocumentDB.

Peningkatan versi minor

Amazon DocumentDB menerbitkan versi minor di atas versi utama 5.0 dan yang lebih baru (misalnya,). 5.0.1 Versi minor tidak dipublikasikan untuk versi utama lebih awal dari 5.0. Versi minor berperilaku berbeda dari patch engine yang diperlukan dan opsional:

Baca lebih lanjut:Peningkatan versi minor Amazon DocumentDB.

Pembaruan sistem operasi Amazon DocumentDB

Instans terkadang membutuhkan pembaruan OS. Amazon DocumentDB memperbarui OS untuk meningkatkan kinerja dan memperketat keamanan. Pembaruan OS membuat versi mesin cluster dan kelas instance tidak berubah. Seperti patch mesin, pembaruan OS menggunakan siklus hidup opsional/wajib/paksa yang dijelaskan di bagian atas topik ini; tidak seperti tambalan mesin, pembaruan OS dapat bertransisi melalui kategori ini dari waktu ke waktu jika Anda menundanya. Terapkan pembaruan OS segera setelah tersedia, dan atur jendela pemeliharaan instans Anda ke waktu yang sesuai dengan bisnis Anda.

Untuk mendapatkan acara saat pembaruan opsional baru tiba, berlangganan RDS-EVENT-0230 dalam kategori acara penambalan keamanan. Untuk detailnya, lihat Berlangganan Langganan Acara Amazon DocumentDB. Setelah menerima pemberitahuan, Anda dapat menerapkan sendiri patch OS ke setiap instance.

Saat menambal cluster, perbarui instance pembaca terlebih dahulu dan penulis terakhir. Hindari menambal pembaca dan penulis secara bersamaan — failover selama patch dapat memperpanjang waktu henti. Pemeliharaan pada instance utama memicu failover, jadi jalankan lebih dari satu instance per cluster agar tetap tersedia. Lihat perinciannya di Failover Amazon DocumentDB.

Pembaruan OS terkait dengan versi mesin dan kelas instans tertentu, sehingga instance yang berbeda menjadi memenuhi syarat pada waktu yang berbeda. Ketika sebuah instance memenuhi syarat, pembaruan muncul di konsol; Anda juga dapat melihatnya melalui AWS CLI describe-pending-maintenance-actions perintah atau DescribePendingMaintenanceActions API.

Gunakan Konsol Manajemen AWS atau AWS CLI untuk memeriksa apakah pembaruan tersedia.

User-initiated pembaruan

Beberapa perubahan yang Anda mulai sendiri—misalnya, menukar kelas instance dengan kelas dengan memori lebih atau kurang, atau mengubah grup parameter cluster. Amazon DocumentDB memperlakukan ini secara berbeda dari pembaruan yang dimulainya. Untuk detailnya, lihat:

Untuk membuat daftar perubahan yang dimulai pengguna yang masih tertunda:

aws docdb describe-db-instances \
    --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

aws docdb describe-db-instances ^
    --query 'DBInstances[*].[DBClusterIdentifier,DBInstanceIdentifier,PendingModifiedValues]'

[
    [
        "sample-cluster",
        "sample-cluster-instance",
        {
            "DBInstanceClass": "db.r5.xlarge"
        }
    ],
    [
        "sample-cluster",
        "sample-cluster-instance-2",
        {}
    ]
]

Penambalan cluster global

Dalam klaster global, setiap kelompok anggota — primer dan sekunder — melakukan upgrade selama jendela pemeliharaannya sendiri. Ketika patch mesin yang diperlukan tersedia di setiap Wilayah, Anda menerima pemberitahuan AHD dan email. Tambalan opsional dan versi minor baru tidak menghasilkan notifikasi; periksa catatan Rilis Amazon DocumentDB untuk itu.

Jika Anda melamar sendiri, selalu tambal sekunder terlebih dahulu dan yang utama terakhir. Urutan ini membuat failover dan switchover tetap tersedia selama peluncuran.

Jika Anda tidak mengambil tindakan, tambalan otomatis berlaku selama jendela pemeliharaan berikutnya setiap cluster: sekunder terlebih dahulu, lalu primer di jendelanya setelah sekunder selesai.

Simpan cluster DB primer dan sekunder pada versi yang sama. Failover lintas wilayah yang dikelola hanya berfungsi pada database global ketika setiap cluster berbagi versi mesin dan level patch yang sama. Hal yang sama berlaku jika Anda menambahkan sekunder baru yang menggunakan versi mesin yang lebih baru daripada yang primer—buat sekunder baru pada versi primer sebelum bergabung dengan mereka ke database global.

Setelah pemberitahuan tambalan, tingkatkan versi primer dan sekunder ke versi terbaru secepatnya agar failover dan switchover tetap berfungsi. Jika permintaan failover atau switchover ditolak, bandingkan versi patch engine di seluruh cluster; jika tidak cocok, terapkan patch yang tersedia pada cluster yang tertinggal.