

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 klaster global menunjukkan Wilayah AWS tempat cluster berjalan, versi, dan pengidentifikasi klaster 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 primer 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 klaster 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. Kami menyarankan Anda menjaga pengaturan yang konsisten di antara semua klaster dalam basis data global. Tindakan tersebut membantu mencegah perubahan perilaku yang tidak terduga jika Anda menaikkan klaster sekunder menjadi klaster primer.

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 klaster 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 yang utama. Ini menjadi cluster yang disediakan mandiri dengan kemampuan penuh. read/write Selain itu, tidak lagi terlihat di konsol Amazon DocumentDB. Itu hanya terlihat ketika Anda memilih wilayah di konsol tempat cluster berada.

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

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

1. Masuk ke Konsol Manajemen AWS dan navigasikan 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.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/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”.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/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.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/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 berada dalam daftar Cluster, dengan nol wilayah dan AZs. 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 perintah `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` untuk setiap wilayah sekunder di klaster 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 perintah `remove-from-global-cluster` `--db-cluster-identifier` `secondary_cluster_ARN` untuk setiap wilayah sekunder di klaster 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 navigasikan 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.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/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”.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/delete-cluster.png)

Konfirmasikan bahwa semua klaster dihapus dari klaster global. Cluster global harus menunjukkan wilayah nol AZs dan dan ukuran cluster nol. 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 klaster Amazon DocumentDB tanpa kepala di wilayah sekunder
<a name="global-clusters.headless"></a>

Meskipun klaster global Amazon DocumentDB memerlukan setidaknya satu klaster sekunder yang Wilayah AWS berbeda dari yang utama, Anda dapat menggunakan konfigurasi tanpa kepala untuk klaster 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 klaster sekunder seperti biasa saat membuat klaster global Amazon DocumentDB. Namun, setelah cluster primer memulai replikasi ke sekunder, Anda menghapus instance hanya-baca 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**  
Kami hanya merekomendasikan klaster tanpa kepala untuk pelanggan yang dapat mentolerir kegagalan di seluruh wilayah selama 15\$1 menit. Ini karena pemulihan dari kegagalan di seluruh wilayah dengan cluster sekunder tanpa kepala akan mengharuskan pengguna untuk membuat instance baru setelah gagal. Sebuah instance baru dapat memakan waktu \$1 10-15 menit untuk tersedia.

### Cara Menambahkan Cluster Sekunder Tanpa Kepala ke Cluster Global Anda
<a name="w2aac33b9c13c17b9"></a>

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

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

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

1. Untuk **Tindakan**, pilih **Tambahkan region**.

1. Pada halaman **Tambah wilayah**, pilih wilayah sekunder.
**catatan**  
Anda tidak dapat memilih wilayah yang sudah memiliki cluster sekunder untuk cluster global yang sama. Selain itu, wilayah tersebut tidak boleh sama dengan klaster primer. 

1. Lengkapi bidang 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, Anda akan melihatnya dalam daftar `Clusters` 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 pembuatan menjadi tersedia. Ketika cluster tersedia, Anda dapat menghapus instance pembaca. 

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

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

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