Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Melakukan pembaruan patch ke versi mesin cluster
<a name="db-cluster-version-upgrade"></a>

Pada bagian ini, kami akan menjelaskan cara menerapkan pembaruan patch menggunakan Konsol Manajemen AWS 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](db-cluster-determine-pending-maintenance.md). Perhatikan bahwa ketika Anda menerapkan pembaruan, cluster Anda akan mengalami beberapa downtime.

**catatan**  
Jika Anda mencoba memutakhirkan dari versi mesin utama ke versi lain, seperti 3.6 ke 5.0 atau 5.0 hingga 8.0, lihat salah satu [Pembaruan versi utama Amazon DocumentDB di tempat](docdb-mvu.md) atau[Memutakhirkan cluster Amazon DocumentDB Anda menggunakan AWS Database Migration Service](docdb-migration.versions.md).

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 Konsol Manajemen AWS ]

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 Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di [ https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).

1. 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 (![Menu button.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/docdb-menu-icon.png)) di sudut kiri atas halaman.

1. 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.  
![Gambar: Tindakan Pembaruan Amazon DocumentDB](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/docdb-upgrade-action.png)
   + **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.

1. 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 patch 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. Gunakan `system-update` untuk menerapkan pembaruan patch engine ke cluster.
+ **--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.

**Example**  
Contoh berikut menerapkan pembaruan patch engine ke`sample-cluster`.  
Untuk Linux, macOS, atau Unix:  

```
aws docdb apply-pending-maintenance-action \
   --resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} \
   --apply-action system-update \
   --opt-in-type immediate
```
Untuk Windows:  

```
aws docdb apply-pending-maintenance-action ^
   --resource-identifier arn:aws:rds:{{aa-example-1}}:{{111122223333}}:cluster:{{sample-cluster}} ^
   --apply-action system-update ^
   --opt-in-type immediate
```
Output dari operasi ini terlihat seperti berikut.  

```
{
    "ResourcePendingMaintenanceActions": {
        "ResourceIdentifier": "arn:aws:rds:aa-example-1:111122223333:cluster:sample-cluster",
        "PendingMaintenanceActionDetails": [
            {
                "CurrentApplyDate": "2019-02-20T20:57:06.904Z",
                "Description": "Bug fixes",
                "ForcedApplyDate": "2019-02-25T21:46:00Z",
                "OptInStatus": "immediate",
                "Action": "system-update",
                "AutoAppliedAfterDate": "2019-02-25T07:41:00Z"
            }
        ]
    }
}
```

------