

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

# Mengelola klaster global Amazon DocumentDB
<a name="global-clusters.manage"></a>

Anda melakukan sebagian besar operasi manajemen pada klaster individu yang membentuk klaster global. Saat Anda memilih **Sumber daya terkait grup** pada halaman **Klaster** di konsol tersebut, Anda melihat klaster primer dan klaster sekunder dikelompokkan di bawah klaster global terkait.

**Tab ** Konfigurasi untuk cluster global menunjukkan di Wilayah AWS mana cluster berjalan, versi, dan pengidentifikasi cluster global.

**Topics**
+ [Memodifikasi cluster global](#global-clusters.modify)
+ [Mengubah parameter](#global-clusters.modify-parameters)
+ [Menghapus cluster global](#global-clusters.remove)
+ [Menghapus cluster global](#global-clusters.delete)
+ [Cluster tanpa kepala](#global-clusters.headless)

## Memodifikasi klaster global Amazon DocumentDB
<a name="global-clusters.modify"></a>

**Halaman ** Cluster dalam Konsol Manajemen AWS daftar semua cluster global Anda, menampilkan cluster utama dan cluster sekunder untuk masing-masing cluster. Klaster global memiliki penganturan konfigurasi sendiri. Secara khusus, ia memiliki Wilayah yang terkait dengan cluster primer dan sekundernya.

Saat Anda membuat perubahan pada cluster global, Anda memiliki kesempatan untuk membatalkan perubahan.

Saat Anda memilih Lanjutkan, Anda mengonfirmasi perubahan.

## Memodifikasi parameter klaster global Amazon DocumentDB
<a name="global-clusters.modify-parameters"></a>

Anda dapat mengonfigurasi grup parameter klaster secara independen untuk setiap klaster dalam klaster global. Sebagian besar parameter berfungsi sama seperti untuk jenis klaster Amazon DocumentDB lainnya. Jaga pengaturan tetap konsisten di antara semua cluster dalam database global untuk menghindari perubahan perilaku yang tidak terduga jika Anda mempromosikan cluster sekunder menjadi cluster utama.

Misalnya, gunakan pengaturan zona waktu dan rangkaian karakter yang sama untuk mencegah perilaku yang tidak konsisten jika klaster yang berbeda mengambil alih peran sebagai klaster primer.

## Menghapus klaster dari klaster global Amazon DocumentDB
<a name="global-clusters.remove"></a>

Ada beberapa situasi ketika Anda mungkin ingin menghapus klaster dari klaster global Anda. Misalnya, Anda mungkin ingin menghapus klaster dari klaster global jika klaster primer menjadi terdegradasi atau terisolasi. Ini kemudian menjadi klaster yang disediakan mandiri yang dapat digunakan untuk membuat klaster global baru. Untuk mempelajari selengkapnya, lihat [Melakukan failover manual untuk cluster global Amazon DocumentDB](global-clusters-disaster-recovery.md#manual-failover).

Anda juga mungkin ingin menghapus klaster karena Anda ingin menghapus klaster global yang tidak lagi Anda perlukan. Anda tidak dapat menghapus klaster global sampai setelah Anda melepaskan semua kluster terkait, meninggalkan yang primer untuk terakhir. Untuk informasi selengkapnya, lihat [Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.delete).

**catatan**  
Ketika sebuah cluster terlepas dari cluster global, itu tidak lagi disinkronkan dengan cluster primer. Ini menjadi cluster yang disediakan mandiri dengan read/write kemampuan penuh. Selain itu, ini tidak lagi terlihat di konsol Amazon DocumentDB. Ini hanya terlihat ketika Anda memilih Wilayah di konsol tempat cluster berada.

Anda dapat menghapus cluster dari cluster global menggunakan Konsol Manajemen AWS, the AWS CLI, atau RDS API.

------
#### [ Using the Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan arahkan ke konsol Amazon DocumentDB.

1. Pilih **Klaster** di navigasi sisi kiri.  
![Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/choose-cluster.png)

1. Perluas klaster global sehingga Anda dapat melihat semua klaster sekunder. Pilih klaster sekunder yang ingin Anda hapus. Pilih **Tindakan**, dan di menu yang turun, pilih **Hapus dari Global**.  
![Gambar: kotak navigasi Cluster yang menunjukkan pemilihan cluster sekunder yang ada dan menyoroti tindakan “Hapus dari global”.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/remove-global.png)

1. Prompt akan muncul, meminta Anda untuk mengonfirmasi bahwa Anda ingin melepaskan sekunder dari klaster global. Pilih **Hapus dan promosikan** untuk menghapus klaster dari klaster global.  
![Gambar: prompt Hapus dan promosikan.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/remove-promote.png)

Sekarang klaster itu tidak lagi berfungsi sebagai sekunder dan tidak lagi disinkronkan dengan klaster primer. Ini adalah cluster mandiri dengan read/write kemampuan penuh.

Setelah Anda menghapus atau menghapus semua klaster sekunder, maka Anda dapat menghapus klaster primer dengan cara yang sama. Anda tidak dapat melepaskan atau menghapus klaster primer dari klaster global sampai setelah Anda menghapus semua klaster sekunder. Cluster global mungkin tetap dalam daftar Cluster, dengan nol Wilayah dan AZ. Anda dapat menghapus jika tidak ingin lagi menggunakan klaster global ini.

------
#### [ Using the AWS CLI ]

Untuk menghapus klaster dari klaster global, jalankan perintah `remove-from-global-cluster` CLI dengan parameter berikut:
+ `--global-cluster-identifier` — Nama (pengenal) klaster global Anda.
+ `--db-cluster-identifier` — Nama setiap klaster untuk menghapus dari klaster global. 

Contoh berikut pertama-tama menghapus klaster sekunder dan kemudian klaster primer dari klaster global.

Untuk Linux, macOS, atau Unix:

```
aws docdb --region secondary_region \
  remove-from-global-cluster \
    --db-cluster-identifier secondary_cluster_ARN \
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region \
  remove-from-global-cluster \
    --db-cluster-identifier primary_cluster_ARN \
    --global-cluster-identifier global_cluster_id
```

Ulangi `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` perintah untuk setiap Wilayah sekunder di cluster global Anda.

Untuk Windows:

```
aws docdb --region secondary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier secondary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id

aws docdb --region primary_region ^
  remove-from-global-cluster ^
    --db-cluster-identifier primary_cluster_ARN ^
    --global-cluster-identifier global_cluster_id
```

Ulangi `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` perintah untuk setiap Wilayah sekunder di cluster global Anda.

------

## Menghapus klaster dari klaster global Amazon DocumentDB
<a name="global-clusters.delete"></a>

Untuk menghapus cluster global, lakukan hal berikut:
+ Hapus semua klaster sekunder dari klaster global. Setiap klaster menjadi klaster yang berdiri sendiri. Lihat bagian sebelumnya,[Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.remove).
+ Dari setiap klaster mandiri, hapus semua replika.
+ Hapus klaster primer dari klaster global. Ini menjadi klaster yang berdiri sendiri.
+ Dari klaster primer, hapus semua replika terlebih dahulu, lalu hapus instans primer. Menghapus instans primer dari klaster mandiri yang baru juga biasanya menghapus klaster dan klaster global.

------
#### [ Using the Konsol Manajemen AWS ]

1. Masuk ke Konsol Manajemen AWS dan arahkan ke konsol Amazon DocumentDB.

1. Pilih **Klaster** dan temukan klaster global yang ingin Anda hapus.  
![Gambar: kotak navigasi Cluster yang menampilkan daftar tautan cluster yang ada dan tautan instans yang sesuai.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/choose-cluster.png)

1. Dengan klaster global Anda dipilih, pilih **Hapus** dari menu **Tindakan**.  
![Gambar: kotak navigasi Cluster yang menunjukkan pemilihan cluster global dan menyoroti tindakan “Hapus”.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/delete-cluster.png)

Konfirmasikan bahwa semua klaster dihapus dari klaster global. Cluster global harus menunjukkan nol Wilayah dan AZ dan ukuran nol cluster. Jika klaster global berisi klaster apa pun, Anda belum dapat menghapusnya. Pertama-tama Anda harus mengikuti instruksi pada langkah sebelumnya ** [Menghapus klaster dari klaster global Amazon DocumentDB](#global-clusters.remove)**.

------
#### [ Using the AWS CLI ]

Untuk menghapus cluster global, jalankan perintah `delete-global-cluster` CLI dengan nama Wilayah AWS dan pengidentifikasi cluster global, seperti yang ditunjukkan pada contoh berikut.

Untuk Linux, macOS, atau Unix:

```
aws docdb --region primary_region delete-global-cluster \
   --global-cluster-identifier global_cluster_id
```

Untuk Windows:

```
aws docdb --region primary_region delete-global-cluster ^
   --global-cluster-identifier global_cluster_id
```

------

## Membuat cluster Amazon DocumentDB tanpa kepala di Wilayah sekunder
<a name="global-clusters.headless"></a>

Meskipun cluster global Amazon DocumentDB memerlukan setidaknya satu cluster sekunder yang berbeda Wilayah AWS dari cluster primer, Anda dapat menggunakan konfigurasi headless untuk cluster sekunder. Cluster Amazon DocumentDB sekunder tanpa kepala adalah cluster tanpa instance. Jenis konfigurasi ini dapat menurunkan biaya untuk cluster global. Dalam cluster Amazon DocumentDB, komputasi dan penyimpanan dipisahkan. Tanpa instance, Anda tidak dikenakan biaya untuk komputasi, hanya untuk penyimpanan. Jika diatur dengan benar, volume penyimpanan sekunder tanpa kepala tetap sinkron dengan cluster utama. 

Anda menambahkan cluster sekunder seperti yang biasa Anda lakukan saat membuat cluster global Amazon DocumentDB. Namun, setelah cluster utama memulai replikasi ke klaster sekunder, Anda menghapus instance read-only dari cluster sekunder. Cluster sekunder ini sekarang dianggap “tanpa kepala” karena tidak lagi memiliki instance. Namun, volume penyimpanan tetap sinkron dengan cluster Amazon DocumentDB utama. 

**penting**  
Gunakan cluster tanpa kepala hanya jika Anda dapat mentolerir Region-wide kegagalan selama 15 menit atau lebih. Memulihkan dari Region-wide kegagalan dengan cluster sekunder tanpa kepala mengharuskan Anda membuat instance baru setelah gagal selesai. Instance baru dapat memakan waktu 10-15 menit untuk tersedia.

### Cara menambahkan cluster sekunder tanpa kepala ke cluster global Anda
<a name="w2aac31b9c13c17b9"></a>

1. Masuk ke Konsol Manajemen AWS dan buka konsol [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/) Amazon DocumentDB.

1. Pilih **Klaster** di navigasi sisi kiri. 

1. Pilih cluster global yang membutuhkan cluster sekunder. Pastikan bahwa cluster utama adalah`Available`. 

1. Untuk T ** ind ** akan, pilih Tam ** bah Wilayah**.

1. Pada ** halaman ** Tambahkan wilayah, pilih Wilayah sekunder.
**catatan**  
Anda tidak dapat memilih Wilayah yang sudah memiliki cluster sekunder untuk cluster global yang sama. Juga, itu tidak bisa menjadi Wilayah yang sama dengan cluster utama. 

1. Lengkapi kolom yang tersisa untuk cluster sekunder di Wilayah baru. Ini adalah opsi konfigurasi yang sama seperti untuk instance cluster apa pun. 

1. Tambahkan Wilayah. Setelah Anda selesai menambahkan Wilayah ke cluster global Anda, itu muncul `Clusters` dalam daftar di Konsol Manajemen AWS.

1. Periksa status cluster sekunder dan instance pembacanya sebelum melanjutkan, dengan menggunakan Konsol Manajemen AWS atau AWS CLI. Berikut adalah contoh perintah jika Anda menggunakan AWS CLI: 

   ```
   $ aws docdb describe-db-clusters --db-cluster-identifier secondary-cluster-id --query '*[].[Status]' --output text
   ```

   Diperlukan beberapa menit agar status cluster sekunder yang baru ditambahkan berubah dari membuat menjadi tersedia. Ketika cluster tersedia, Anda dapat menghapus instance pembaca. 

1. Pilih instance pembaca di cluster sekunder, lalu pilih H ** apus**. 

1. Setelah menghapus instance pembaca, cluster sekunder tetap menjadi bagian dari cluster global. Seharusnya tidak memiliki contoh yang terkait dengannya.

**catatan**  
Anda dapat menggunakan cluster Amazon DocumentDB sekunder tanpa kepala ini untuk memulihkan cluster global Amazon DocumentDB secara manual dari pemadaman yang tidak direncanakan di Wilayah utama jika terjadi pemadaman seperti itu. 