Melakukan pembaruan tambalan ke versi mesin cluster

Di bagian ini, kami akan menjelaskan cara menerapkan pembaruan tambalan menggunakan AWS Management Console atau. AWS CLI Pembaruan patch adalah pembaruan dalam versi mesin yang sama (misalnya, memperbarui versi mesin 3.6 ke versi mesin 3.6 yang lebih baru). Anda dapat memperbaruinya segera atau selama jendela pemeliharaan berikutnya pada klaster Anda. Untuk menentukan apakah mesin Anda memerlukan pembaruan, lihat Menentukan pemeliharaan yang tertunda. Silakan dicatat bahwa ketika Anda menerapkan pembaruan, klaster Anda akan mengalami waktu henti selama beberapa saat.

catatan

Jika Anda mencoba untuk meng-upgrade dari versi mesin utama ke yang lain, seperti 3.6 ke 5.0, lihat salah satu Peningkatan versi utama Amazon DocumentDB di tempat atauMemutakhirkan cluster Amazon DocumentDB Anda menggunakan AWS Database Migration Service. Upgrade versi utama di tempat hanya mendukung docdb 5.0 sebagai versi mesin target.

Ada dua persyaratan konfigurasi untuk mendapatkan pembaruan patch terbaru untuk sebuah versi mesin pada suatu klaster:

• Status klaster harus tersedia.

• Klaster harus menjalankan versi mesin sebelumnya.

Using the AWS Management Console

Prosedur berikut menerapkan pembaruan patch untuk versi mesin pada klaster dengan menggunakan konsol. Anda memiliki pilihan untuk memperbarui segera atau selama jendela pemeliharaan berikutnya pada klaster Anda.

1. Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.

2. Pada panel navigasi, silakan pilih Klaster. Dalam daftar klaster, pilih tombol di sebelah kiri pada klaster yang ingin Anda tingkatkan. Status klaster harus tersedia.

   Tip

   Jika panel navigasi tidak terlihat di sisi kiri layar Anda, pilih ikon menu () di sudut kiri atas halaman.

3. Dari menu Tindakan, pilih salah satu dari berikut ini. Opsi menu ini dapat dipilih hanya jika klaster yang Anda pilih tidak menjalankan versi mesin terbaru.

   

   • Tingkatkan sekarang—Segera memulai proses peningkatan. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.

   • Tingkatkan pada jendela berikutnya—Memulai proses peningkatan selama jendela pemeliharaan berikutnya pada klaster. Klaster Anda akan offline untuk sementara waktu, sedangkan klaster ditingkatkan ke versi mesin terbaru.

4. Jika jendela konfirmasi terbuka, pilih salah satu hal berikut:

   • Meningkatkan—Untuk meningkatkan klaster Anda ke versi mesin terbaru sesuai dengan jadwal yang dipilih pada langkah sebelumnya.

   • Batalkan—Untuk membatalkan peningkatan mesin klaster dan melanjutkan dengan versi mesin saat ini pada klaster.

Using the AWS CLI

Anda dapat menerapkan pembaruan tambalan ke cluster Anda menggunakan AWS CLI dan apply-pending-maintenance-action operasi dengan parameter berikut.

Parameter

• --resource-identifier—Diperlukan. ARN dari klaster Amazon DocumentDB yang akan Anda tingkatkan.

• --apply-action—Diperlukan. Nilai berikut diizinkan. Untuk meningkatkan versi mesin klaster Anda, gunakan db-upgrade.

  • db-upgrade

  • system-update

• --opt-in-type—Diperlukan. Nilai berikut diizinkan.

  • immediate—Terapkan tindakan pemeliharaan segera.

  • next-maintenance—Terapkan tindakan pemeliharaan selama jendela pemeliharaan berikutnya.

  • undo-opt-in—Membatalkan permintaan keikutsertaan next-maintenance yang ada.

Patch contoh berikut memperbarui versi mesin sample-cluster ke versi 4.0.0.

Untuk Linux, macOS, atau Unix:

aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:us-east-1:123456789012\:cluster:sample-cluster \
   --apply-action db-upgrade \
   --opt-in-type immediate

Untuk Windows:

aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster ^
   --apply-action db-upgrade ^
   --opt-in-type immediate

Output dari operasi ini terlihat seperti berikut ini.

{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:us-east-1:444455556666:cluster:docdb-2019-01-09-23-55-38",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "db-upgrade",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}