Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Ikhtisar cluster global Amazon DocumentDB
## Apa itu klaster global?
Cluster global terdiri dari satu wilayah primer dan hingga 10 wilayah sekunder hanya-baca. Anda menerbitkan operasi tulis langsung ke klaster primer di wilayah primer dan Amazon DocumentDB secara otomatis mereplikasi data ke wilayah sekunder menggunakan infrastruktur khusus. Latensi biasanya di bawah satu detik.
## Bagaimana klaster global berguna?
+ **Pemulihan dari pemadaman di seluruh wilayah** — Jika terjadi pemadaman di seluruh wilayah, Anda dapat mempromosikan salah satu cluster sekunder ke cluster utama dalam beberapa menit, dengan Tujuan Waktu Pemulihan (RTO) khas kurang dari satu menit. Recovery Point Objective (RPO) biasanya diukur dalam hitungan detik, tetapi ini tergantung pada lag di seluruh jaringan pada saat kegagalan.
+ **Pembacaan global dengan latensi lokal ** — Jika Anda memiliki kantor di seluruh dunia, Anda dapat menggunakan klaster global untuk terus memperbarui sumber informasi utama Anda di wilayah primer. Kantor di wilayah Anda yang lain dapat mengakses informasi di wilayah mereka sendiri, dengan latensi lokal.
+ **Klaster sekunder yang dapat diskalakan **— Anda dapat menskalakan klaster sekunder dengan menambahkan lebih banyak instans baca-saja ke wilayah sekunder. Klaster sekunder bersifat baca-saja, sehingga dapat mendukung hingga 16 instans replika hanya-baca daripada batas biasa 15 untuk satu klaster.
+ **Replikasi cepat dari klaster primer ke sekunder** — Replikasi yang dilakukan oleh klaster global memiliki dampak performa yang kecil pada klaster basis data primer. Sumber daya instans DB sepenuhnya dikhususkan untuk melayani beban kerja baca dan tulis aplikasi.
## Apa keterbatasan terkini klaster global?
+ Klaster global tidak didukung di Amazon DocumentDB v3.6.
+ Cluster global didukung pada semua jenis instans kecuali db.t3, db.t4g, dan db.r4.
+ Cluster global tidak tersedia di Wilayah berikut: Amerika Selatan (São Paulo), Eropa (Milan), Tiongkok (Beijing), dan Tiongkok (Ningxia).
+ Switchover dan failover global tidak didukung ketika wilayah menggunakan versi mesin yang berbeda. Failover manual didukung ketika ada ketidakcocokan versi mesin.
+ Hanya klaster primer yang melakukan operasi penulisan. Klien yang melakukan operasi tulis terhubung ke titik akhir klaster dari klaster primer.
+ Anda dapat memiliki maksimal 10 wilayah sekunder dan satu wilayah utama untuk cluster Anda.
+ Klaster sekunder tidak dapat dihentikan. Sebuah klaster primer tidak dapat dihentikan jika ia memiliki klaster sekunder yang terkait dengannya. Hanya klaster wilayah yang tidak memiliki klaster sekunder yang dapat dihentikan.
+ Replika yang dilampirkan ke klaster sekunder dapat dimulai ulang dalam keadaan tertentu. Jika instans wilayah primer dimulai ulang atau gagal, replika di region sekunder juga dimulai ulang. Klaster kemudian tidak tersedia sampai semua replika kembali disinkronkan dengan instans penulis klaster basis data primer. Perilaku ini yang diharapkan. Pastikan Anda memahami dampak terhadap klaster global Anda sebelum membuat perubahan pada klaster primer Anda.
+ Anda tidak dapat menggunakan perubahan aliran pada klaster sekunder.
**Topics**
+ [
## Apa itu klaster global?
](#w2aac33b9b3)
+ [
## Bagaimana klaster global berguna?
](#w2aac33b9b5)
+ [
## Apa keterbatasan terkini klaster global?
](#w2aac33b9b7)
+ [Panduan memulai cepat](global-clusters.get-started.md)
+ [Mengelola klaster global](global-clusters.manage.md)
+ [Menghubungkan cluster global](global-clusters-connect.md)
+ [Memantau klaster global](global-clusters-monitor.md)
+ [Pemulihan bencana](global-clusters-disaster-recovery.md)
# Panduan memulai cepat: cluster global
**Topics**
+ [Konfigurasi](#global-clusters.config)
+ [Membuat klaster global](#global-clusters-create)
+ [Menambahkan Region ke klaster global](#global-clusters.add-region)
+ [Menggunakan snapshot](#global-clusters.snapshot)
## Konfigurasi
Cluster global Amazon DocumentDB mencakup setidaknya dua. Wilayah AWS Wilayah primer mendukung klaster yang memiliki satu instance (penulis) primer dan hingga 15 instance replika, sedangkan Region sekunder menjalankan cluster hanya-baca yang seluruhnya terdiri dari hingga 16 instance replika. Sebuah cluster global dapat memiliki hingga lima Wilayah sekunder. Tabel mencantumkan klaster, instans, dan replika maksimum yang diizinkan dalam klaster global.
| Deskripsi | Primer Wilayah AWS | Sekunder Wilayah AWS |
| --- | --- | --- |
| klaster | 1 | 5 (maksimum) |
| Instans penulis | 1 | 0 |
| Instans baca saja (replika Amazon DocumentDB), per klaster | 15 (maks) | 16 (total) |
| Instans hanya-baca (maks. yang diperbolehkan, dengan jumlah aktual dari Wilayah sekunder) | 15 - s | s = jumlah total sekunder Wilayah AWS |
Klaster memiliki persyaratan khusus berikut:
+ **Persyaratan kelas instance database** - Anda hanya dapat menggunakan kelas `db.r5` dan `db.r6g` instance.
+ **Wilayah AWS persyaratan** — Cluster primer harus berada dalam satu Wilayah, dan setidaknya satu cluster sekunder harus berada di Wilayah yang berbeda dari akun yang sama. Anda dapat membuat hingga lima cluster sekunder (hanya-baca), dan masing-masing harus berada di Wilayah yang berbeda. Dengan kata lain, tidak ada dua cluster yang bisa berada di Wilayah yang sama.
+ **Persyaratan penamaan** — Nama yang Anda pilih untuk setiap cluster Anda harus unik, di semua Wilayah. Anda tidak dapat menggunakan nama yang sama untuk cluster yang berbeda meskipun mereka berada di Wilayah yang berbeda.
## Membuat klaster global Amazon DocumentDB
Apakah Anda siap untuk membangun klaster global pertama Anda? Pada bagian ini kami akan menjelaskan cara membuat klaster global baru dengan cluster dan contoh database baru, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut.
### Menggunakan Konsol Manajemen AWS
1. Di Konsol Manajemen AWS, navigasikan ke **Amazon DocumentDB**.
1. Ketika Anda sampai ke konsol Amazon DocumentDB, pilih **Klaster**.
![\[Halaman Clusters di konsol Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Pilih **Buat**.
![\[Tombol Create ditampilkan di sudut kanan atas tabel Clusters.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-create.png)
1. Mengisi bagian **Konfigurasi** dari formulir **Buat Klaster Amazon DocumentDB** dengan sesuai:
+ **Pengidentifikasi klaster**: Anda dapat memasukkan pengidentifikasi unik untuk instans ini atau mengizinkan Amazon DocumentDB menyediakan pengidentifikasi instans berdasarkan pengidentifikasi klaster.
+ Versi mesin: Pilih **4.0.0**
+ Kelas instans: Pilih **db.r5.large**
+ Jumlah instans: Pilih **3**.
![\[Formulir opsi konfigurasi untuk membuat cluster Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-config.png)
1. Di **Autentikasi**, isi nama pengguna utama dan kata sandi utama.
![\[Formulir otentikasi untuk menentukan nama pengguna dan kata sandi utama untuk cluster Amazon DocumentDB baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-auth.png)
1. Pilih **Tampilkan pengaturan lanjutan**.
![\[Tampilkan tombol sakelar pengaturan lanjutan di samping tombol Batalkan dan Buat klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/show-advanced.png)
1. Di bagian **Pengaturan jaringan**:
+ **Simpan opsi default untuk grup **Virtual Private Cloud (VPC)** dan Subnet.**
![\[Formulir pengaturan jaringan yang menampilkan opsi grup keamanan VPC, subnet group, dan VPC. Bidang grup VPC dan Subnet memiliki opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-1.png)
+ Untuk **grup keamanan VPC**, **default (VPC)** seharusnya sudah ditambahkan.
![\[Formulir pengaturan jaringan yang menunjukkan VPC default sudah ditambahkan.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/default-vpc-2.png)
+ Ketik `DocDB` ke dalam bidang **grup keamanan VPC** dan pilih **DocDB-inbound** (VFC).
![\[DocDB-Inbound VFC dipilih dalam menu dropdown grup keamanan VPC.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/inbound-vfc.png)
1. Untuk **opsi Cluster** dan **E ncryption-at-rest**, biarkan pada pilihan default.
![\[Opsi cluster dan Encryption-at-rest formulir dengan opsi default dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-1.png)
1. Untuk **ekspor **Backup** dan Log**, biarkan pada pilihan default.
![\[Formulir ekspor Backup dan Log dengan opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-2.png)
1. Untuk **perlindungan **Pemeliharaan**, **Tag**, dan Penghapusan**, tinggalkan pilihan default.
![\[Formulir perlindungan Pemeliharaan, Tag, dan Penghapusan dengan opsi default yang dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/leave-default-3.png)
1. Sekarang klik tombol yang mengatakan **Create cluster**.
![\[Tombol Create cluster ditampilkan di akhir proses pembuatan cluster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/create-cluster.png)
### Menggunakan AWS CLI
Untuk membuat cluster Regional Amazon DocumentDB, hubungi file. [create-global-cluster AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) AWS CLI Perintah berikut membuat cluster Amazon DocumentDB bernama. `global-cluster-id` Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat [Menghapus cluster Amazon DocumentDB](db-cluster-delete.md).
Juga, `--engine-version` adalah parameter opsional yang default ke versi mesin utama terbaru. Versi mesin default saat ini adalah `5.0.0` (catatan: Amazon DocumentDB 8.0 tersedia tetapi harus ditentukan secara eksplisit sebagai). `8.0.0` Ketika versi mesin utama baru dirilis, versi mesin default untuk `--engine-version` akan diperbarui untuk mencerminkan versi mesin utama terakhir. Akibatnya, untuk beban kerja produksi, dan terutama yang bergantung pada skrip, otomatisasi, atau CloudFormation templat, kami menyarankan Anda secara eksplisit menentukan `--engine-version` ke versi utama yang dimaksud.
Jika `vpc-security-group-id` ditentukan `db-subnet-group-name` atau tidak, Amazon DocumentDB akan menggunakan grup subnet default dan grup keamanan Amazon VPC untuk Wilayah tertentu.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb create-db-cluster \
--global-cluster-identifier global-cluster-id \
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Untuk Windows:
```
aws docdb create-db-cluster ^
--global-cluster-identifier global-cluster-id ^
--source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
```
Output dari operasi ini terlihat seperti berikut (format JSON).
```
{
"DBCluster": {
"StorageEncrypted": false,
"DBClusterMembers": [],
"Engine": "docdb",
"DeletionProtection" : "enabled",
"ClusterCreateTime": "2018-11-26T17:15:19.885Z",
"DBSubnetGroup": "default",
"EngineVersion": "4.0.0",
"MasterUsername": "masteruser",
"BackupRetentionPeriod": 1,
"DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:cluster-id",
"DBClusterIdentifier": "cluster-id",
"MultiAZ": false,
"DBClusterParameterGroup": "default.docdb4.0",
"PreferredBackupWindow": "09:12-09:42",
"DbClusterResourceId": "cluster-KQSGI4MHU4NTDDRVNLNTU7XVAY",
"PreferredMaintenanceWindow": "tue:04:17-tue:04:47",
"Port": 27017,
"Status": "creating",
"ReaderEndpoint": "cluster-id.cluster-ro-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com",
"AssociatedRoles": [],
"HostedZoneId": "ZNKXTT8WH85VW",
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-77186e0d",
"Status": "active"
}
],
"AvailabilityZones": [
"us-east-1a",
"us-east-1c",
"us-east-1e"
],
"Endpoint": "cluster-id.cluster-sfcrlcjcoroz.us-east-1.docdb.amazonaws.com"
}
}
```
Dibutuhkan beberapa menit untuk membuat klaster. Anda dapat menggunakan Konsol Manajemen AWS atau AWS CLI untuk memantau status cluster Anda. Untuk informasi selengkapnya, lihat [Memantau status klaster Amazon DocumentDB](monitoring_docdb-cluster_status.md).
**penting**
Saat Anda menggunakan AWS CLI untuk membuat klaster Regional Amazon DocumentDB, tidak ada instance yang dibuat. Akibatnya, Anda harus secara eksplisit membuat instans primer dan semua instans replika yang Anda butuhkan. Anda dapat menggunakan konsol atau AWS CLI untuk membuat instance. Untuk informasi selengkapnya, lihat [Menambahkan instance Amazon DocumentDB ke klaster](db-instance-add.md) dan [CreateDBCluster](API_CreateDBCluster.md) di Referensi API Amazon DocumentDB.
Setelah kluster Regional Anda tersedia, Anda dapat menambahkan klaster sekunder di Wilayah lain dengan petunjuk berikut: [Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB](#global-clusters.add-region) Saat Anda menambahkan Region, kluster Regional Anda menjadi klaster utama Anda, dan Anda memiliki klaster sekunder baru di Wilayah yang Anda pilih.
## Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB
Sebuah cluster global membutuhkan setidaknya satu cluster sekunder di Region yang berbeda dari cluster primer, dan Anda dapat menambahkan hingga lima cluster sekunder. Perhatikan bahwa untuk setiap klaster sekunder yang Anda tambahkan, Anda harus mengurangi jumlah replika yang diizinkan di klaster primer sebanyak satu. Misalnya, jika klaster global Anda memiliki lima Wilayah sekunder, klaster utama Anda hanya dapat memiliki 10 (bukan 15) replika. Untuk informasi selengkapnya, lihat [Persyaratan konfigurasi klaster global Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/global-clusters.get-started.html#global-clusters.config).
### Menggunakan Konsol Manajemen AWS
1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon DocumentDB.
1. Pada panel navigasi, silakan pilih **Klaster**.
![\[Halaman Clusters di konsol Amazon DocumentDB.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster.png)
1. Pilih klaster yang ingin Anda tambahkan klaster sekundernya. Pastikan bahwa klaster adalah `Available`.
![\[Daftar cluster regional dan global yang menunjukkan status yang tersedia, dengan mydocdbglobalcluster disorot.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/choose-cluster-2.png)
1. Pilih daftar dropdown untuk **Actions** dan kemudian pilih **Add** Region.
![\[Dropdown Tindakan pada antarmuka Clusters menunjukkan opsi Tambah Wilayah.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region.png)
1. Pada Wilayah AWS halaman **Add an**, pilih Region sekunder. Perhatikan bahwa Anda tidak dapat memilih Region yang sudah memiliki klaster sekunder untuk cluster global yang sama. Juga, itu tidak bisa menjadi Wilayah yang sama dengan cluster utama. Jika ini adalah Wilayah pertama yang Anda tambahkan, Anda juga harus menentukan pengidentifikasi cluster global pilihan Anda.
![\[Pilih wilayah sekunder menggunakan menu tarik-turun pada Tambahkan formulir. Wilayah AWS\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/add-region-2.png)
1. Lengkapi bidang yang tersisa untuk cluster sekunder di Wilayah baru, lalu pilih **Buat cluster**. Setelah Anda selesai menambahkan Wilayah, Anda dapat melihatnya di daftar **Cluster** di Konsol Manajemen AWS.
![\[Langkah terakhir untuk menambahkan wilayah ke klaster, menampilkan formulir Konfigurasi, perkiraan biaya per jam, dan tombol Buat klaster.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/global-clusters/quick-start/select-add-region.png)
### Menggunakan AWS CLI
+ Gunakan perintah CLI `create-db-cluster` dengan nama `(--global-cluster-identifier)` dari klaster global Anda. Untuk Parameter lainnya, lakukan hal berikut:
+ Untuk`--region`, pilih yang berbeda Wilayah AWS dari Wilayah utama Anda.
+ Pilih nilai spesifik untuk parameter `--engine` dan `--engine-version`.
+ Untuk klaster terenkripsi, tentukan primer Anda Wilayah AWS sebagai enkripsi `--source-region` untuk.
Contoh berikut membuat klaster Amazon DocumentDB baru dan melampirkannya ke klaster global sebagai klaster sekunder baca-saja. Pada langkah terakhir, instans ditambahkan ke klaster baru.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi Anda sendiri.
Untuk Linux, macOS, atau Unix:
```
aws docdb --region secondary-region-id \
create-db-cluster \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
aws docdb --region secondary-region-id \
create-db-instance \
--db-cluster-identifier cluster-id \
--global-cluster-identifier global-cluster-id \
--engine-version version \
--engine docdb
```
Untuk Windows:
```
aws docdb --region secondary-region-id ^
create-db-cluster ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
aws docdb --region secondary-region-id ^
create-db-instance ^
--db-cluster-identifier cluster-id ^
--global-cluster-identifier global-cluster-id ^
--engine-version version ^
--engine docdb
```
## Menggunakan snapshot untuk klaster global Amazon DocumentDB Anda
Anda dapat memulihkan snapshot klaster Amazon DocumentDB untuk digunakan sebagai titik awal klaster global Anda. Untuk melakukan ini, Anda harus memulihkan snapshot dan membuat klaster baru. Ini akan berfungsi sebagai klaster primer klaster global Anda. Anda kemudian dapat menambahkan Wilayah lain ke cluster yang dipulihkan, sehingga mengubahnya menjadi cluster global.
# Mengelola klaster global Amazon DocumentDB
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
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
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
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
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
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
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.
# Connect ke cluster global Amazon DocumentDB
Cara Anda terhubung ke klaster global bergantung pada apakah Anda perlu menulis ke klaster atau membaca dari klaster:
+ Untuk permintaan atau kueri baca-saja, Anda menyambungkan ke reader endpoint untuk klaster di Wilayah AWS.
+ Untuk menjalankan pernyataan bahasa manipulasi data (DML) atau bahasa definisi data (DDL), Anda terhubung ke titik akhir klaster untuk klaster primer. Endpoint ini mungkin berbeda Wilayah AWS dari aplikasi Anda.
Saat Anda melihat klaster global di konsol, Anda dapat melihat semua titik akhir tujuan umum yang terkait dengan semua klasternya.
Bagaimana Anda terhubung ke klaster global bergantung pada apakah Anda perlu menulis ke basis data atau membaca dari basis data. Untuk DDL, DML, dan operasi baca yang ingin Anda layani dari wilayah primer, Anda harus terhubung ke klaster primer Anda. Kami menyarankan Anda menyambungkan ke klaster primer menggunakan titik akhir klaster dalam mode set replika, dengan preferensi baca `secondaryPreferred=true`. Ini akan merutekan lalu lintas tulis ke instans penulis klaster primer Anda dan lalu lintas baca ke instans replika klaster primer Anda.
Untuk lintas wilayah, baca saja lalu lintas, Anda harus terhubung ke salah satu cluster sekunder Anda. Kami menyarankan Anda terhubung ke cluster sekunder Anda menggunakan titik akhir cluster dalam mode set replika. Karena semua instans adalah instans replika baca-saja, Anda tidak perlu menentukan preferensi baca. Untuk meminimalkan latensi, pilih reader endpoint mana saja yang ada di wilayah Anda atau wilayah terdekat dengan Anda.
# Memantau klaster global Amazon DocumentDB
Amazon DocumentDB (dengan kompatibilitas MongoDB) terintegrasi CloudWatch dengan sehingga Anda dapat mengumpulkan dan menganalisis metrik operasional untuk cluster Anda. Anda dapat memantau metrik ini menggunakan CloudWatch konsol, konsol Amazon DocumentDB, () AWS Command Line Interface ,AWS CLI atau API. CloudWatch
Untuk memantau klaster global, gunakan CloudWatch metrik berikut.
| Metrik | Deskripsi |
| --- | --- |
| GlobalClusterReplicatedWriteIO | Jumlah rata-rata I/O operasi penulisan yang ditagih direplikasi dari volume cluster di volume primer Wilayah AWS ke volume cluster di sekunder Wilayah AWS, dilaporkan pada interval 5 menit. Banyaknya ReplicatedWriteIOs yang direplikasi untuk setiap wilayah sekunder sama dengan jumlah VolumeWriteIOPs dalam wilayah yang dilakukan oleh wilayah primer. |
| GlobalClusterDataTransferBytes | Jumlah data yang ditransfer dari cluster primer Wilayah AWS ke cluster sekunder Wilayah AWS, diukur dalam byte. |
| GlobalClusterReplicationLag | Jumlah lag, dalam milidetik, saat mereplikasi peristiwa perubahan dari cluster primer Wilayah AWS ke cluster sekunder Wilayah AWS |
Untuk informasi selengkapnya tentang cara melihat metrik ini, silakan lihat [Melihat CloudWatch data](https://docs.aws.amazon.com/documentdb/latest/developerguide/cloud_watch.html#cloud_watch-view_data).
# Pemulihan bencana dan klaster global Amazon DocumentDB
**Topics**
+ [
## Melakukan failover terkelola untuk klaster global Amazon DocumentDB
](#managed-failover)
+ [
## Melakukan failover manual untuk klaster global Amazon DocumentDB
](#manual-failover)
+ [
## Melakukan peralihan untuk klaster global Amazon DocumentDB
](#global-cluster-switchover)
+ [
## Membuka blokir peralihan atau failover klaster global
](#unblocking-gc-so-fo)
Dengan menggunakan klaster global, Anda dapat pulih dari bencana seperti kegagalan wilayah dengan cepat. Pemulihan dari bencana biasanya diukur dengan menggunakan nilai untuk RTO dan RPO.
+ **Tujuan waktu pemulihan (RTO)** — Waktu yang dibutuhkan sistem untuk kembali ke kondisi kerja setelah bencana. Dengan kata lain, RTO mengukur waktu henti. Untuk cluster global, RTO dalam hitungan menit.
+ **Tujuan titik pemulihan (RPO)** — Jumlah data yang dapat hilang (diukur dalam waktu). Untuk klaster global, RPO biasanya diukur dalam hitungan detik.
+ Untuk memulihkan dari pemadaman yang tidak direncanakan, Anda dapat melakukan failover lintas wilayah ke salah satu sekunder di klaster global Anda. Jika klaster global Anda memiliki beberapa wilayah sekunder, pastikan Anda melepaskan semua wilayah sekunder yang ingin Anda promosikan sebagai primer. Kemudian, Anda mempromosikan salah satu wilayah sekunder tersebut menjadi Wilayah AWS primer yang baru. Terakhir, Anda membuat klaster baru di setiap wilayah sekunder lainnya dan melampirkan klaster tersebut ke klaster global Anda.
## Melakukan failover terkelola untuk klaster global Amazon DocumentDB
Pendekatan ini ditujukan untuk kelangsungan bisnis saat terjadi bencana alam Regional yang riil atau pemadaman tingkat layanan secara menyeluruh.
Selama failover terkelola, klaster utama Anda gagal ke Region sekunder pilihan Anda sementara topologi replikasi klaster global Amazon DocumentDB yang ada dipertahankan. Klaster sekunder yang dipilih mempromosikan salah satu simpul hanya-bacanya ke status penulis penuh. Langkah ini memungkinkan klaster untuk mengambil peran sebagai klaster primer. Basis data Anda tidak akan tersedia untuk sementara saat klaster ini mengambil peran barunya. Data yang tidak direplikasi dari primer lama ke cluster sekunder yang dipilih mungkin hilang saat sekunder ini menjadi primer baru. Volume primer lama membuat upaya terbaik untuk mengambil snapshot sebelum menyinkronkan dengan primer baru sehingga data yang tidak direplikasi dipertahankan pada snapshot.
**catatan**
Anda hanya dapat melakukan failover klaster lintas wilayah terkelola di klaster global Amazon DocumentDB jika klaster primer dan semua klaster sekunder memiliki versi engine yang sama. Jika versi mesin Anda tidak kompatibel, Anda dapat melakukan failover secara manual dengan mengikuti langkah-langkah dalam [Melakukan failover manual untuk klaster global Amazon DocumentDB](#manual-failover).
Jika versi mesin wilayah tidak cocok, failover akan diblokir. Silakan periksa peningkatan yang tertunda dan terapkan untuk memastikan semua versi mesin wilayah cocok dan failover cluster global tidak diblokir. Untuk informasi selengkapnya, lihat [Membuka blokir peralihan atau failover klaster global](#unblocking-gc-so-fo).
Untuk meminimalkan kehilangan data, sebaiknya lakukan hal berikut sebelum menggunakan fitur ini:
+ Bawa aplikasi offline untuk mencegah penulisan dikirim ke cluster utama klaster global Amazon DocumentDB.
+ Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB. Memilih Wilayah sekunder dengan keterlambatan replikasi minimum dapat meminimalkan kehilangan data dari Wilayah primer yang mengalami kegagalan. Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB di cluster global dengan melihat metrik di `GlobalClusterReplicationLag` Amazon. CloudWatch Metrik ini menunjukkan seberapa jauh di belakang (dalam milidetik) replikasi ke cluster sekunder ke cluster utama.
Untuk informasi selengkapnya tentang CloudWatch metrik untuk Amazon [Metrik Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) DocumentDB, lihat.
Selama failover terkelola, cluster sekunder yang dipilih dipromosikan ke peran barunya sebagai primer. Namun, itu tidak mewarisi berbagai opsi konfigurasi cluster utama. Ketidakcocokan dalam konfigurasi dapat menyebabkan masalah performa, inkompatibilitas beban kerja, dan perilaku anomali lainnya. Untuk menghindari masalah seperti itu, kami sarankan Anda menyelesaikan perbedaan antara kluster global Amazon DocumentDB Anda untuk hal-hal berikut:
+ **Konfigurasikan grup parameter klaster Amazon DocumentDB untuk primer baru, jika perlu — Anda dapat mengonfigurasi grup parameter klaster** Amazon DocumentDB secara independen untuk setiap cluster di cluster global Amazon DocumentDB Anda. Oleh karena itu, ketika Anda mempromosikan klaster sekunder untuk mengambil alih peran utama, grup parameter dari sekunder mungkin dikonfigurasi secara berbeda dari yang utama. Jika demikian, ubah grup parameter klaster sekunder yang dipromosikan agar sesuai dengan pengaturan klaster utama Anda. Untuk mempelajari caranya, lihat [Memodifikasi grup parameter cluster Amazon DocumentDB](cluster_parameter_groups-modify.md).
+ **Konfigurasikan alat dan opsi pemantauan, seperti CloudWatch peristiwa dan alarm Amazon** — Konfigurasikan klaster yang dipromosikan dengan kemampuan logging, alarm, dan sebagainya yang sama sesuai kebutuhan untuk klaster global. Seperti grup parameter, konfigurasi untuk fitur ini tidak diwariskan dari klaster primer selama proses failover berlangsung. Beberapa CloudWatch metrik, seperti replikasi lag, hanya tersedia untuk Wilayah sekunder. Karena itu, failover akan mengubah cara Anda melihat metrik tersebut dan mengatur alarmnya, serta mengharuskan adanya perubahan pada dasbor yang ditentukan sebelumnya. Untuk informasi selengkapnya tentang klaster dan pemantauan Amazon DocumentDB, lihat. [Memantau Amazon DocumentDB](monitoring_docdb.md)
Biasanya, cluster sekunder yang dipilih mengasumsikan peran utama dalam satu menit. Segera setelah simpul penulis Wilayah primer baru tersedia, Anda dapat menghubungkan aplikasi Anda ke simpul tersebut dan melanjutkan beban kerja Anda. Setelah Amazon DocumentDB mempromosikan cluster primer baru, secara otomatis membangun kembali semua klaster Region sekunder tambahan.
Karena klaster global Amazon DocumentDB menggunakan replikasi asinkron, kelambatan replikasi di setiap Wilayah sekunder dapat bervariasi. Amazon DocumentDB membangun kembali Wilayah sekunder ini untuk memiliki data yang point-in-time sama persis dengan cluster Wilayah utama yang baru. Durasi penyelesaian tugas pembangunan ulang dapat memerlukan waktu beberapa menit hingga beberapa jam, bergantung pada ukuran volume penyimpanan dan jarak di antara Wilayah. Saat klaster Wilayah sekunder selesai dibuat ulang dari Wilayah primer yang baru, klaster ini menjadi tersedia untuk akses baca. Segera setelah penulis utama baru dipromosikan dan tersedia, cluster Region primer yang baru dapat menangani operasi baca dan tulis untuk cluster global Amazon DocumentDB.
Untuk mengembalikan topologi asli cluster global, Amazon DocumentDB memantau ketersediaan Wilayah primer lama. Segera setelah Wilayah itu sehat dan tersedia kembali, Amazon DocumentDB secara otomatis menambahkannya kembali ke cluster global sebagai Wilayah sekunder. Sebelum membuat volume penyimpanan baru di Wilayah primer lama, Amazon DocumentDB mencoba mengambil snapshot dari volume penyimpanan lama pada titik kegagalan. Hal ini dilakukan agar Anda dapat menggunakannya untuk memulihkan setiap data yang hilang. Jika operasi ini berhasil, Amazon DocumentDB menempatkan snapshot ini bernama “rdsdocdb-unplanned-global-failover: name-of-old-primary - -DB-Cluster-Timestamp” di bagian snapshot. Konsol Manajemen AWS Anda juga dapat melihat snapshot ini tercantum dalam informasi yang dikembalikan oleh operasi `DescribeDBClusterSnapshots` API.
**catatan**
Snapshot dari volume penyimpanan lama adalah snapshot sistem yang tunduk pada periode retensi pencadangan yang dikonfigurasi pada klaster primer yang lama. Untuk mempertahankan snapshot ini di luar periode retensi, Anda dapat menyalin snapshot untuk disimpan sebagai snapshot manual. Untuk mempelajari selengkapnya tentang cara menyalin snapshot, termasuk harga, lihat [Menyalin snapshot cluster](backup_restore-copy_cluster_snapshot.md#backup_restore-copy_a_cluster_snapshot).
Setelah topologi asli dipulihkan, Anda dapat gagal mengembalikan klaster global Anda ke Wilayah utama asli dengan melakukan operasi peralihan ketika itu paling masuk akal untuk bisnis dan beban kerja Anda. Untuk melakukannya, ikuti langkah yang ada di [Melakukan peralihan untuk klaster global Amazon DocumentDB](#global-cluster-switchover).
Anda dapat gagal melalui kluster global Amazon DocumentDB menggunakan Konsol Manajemen AWS API Amazon DocumentDB, AWS CLI atau Amazon DocumentDB.
------
#### [ Using the Konsol Manajemen AWS ]
**Lakukan failover terkelola di klaster global Amazon DocumentDB**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Temukan dan pilih klaster global Amazon DocumentDB yang ingin Anda gagal.
![\[Gambar: Tabel cluster dengan cluster global dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-cluster-table.png)
1. **Pilih **Switchover atau Failover** dari menu Tindakan.**
1. Pada kotak dialog yang muncul, pilih **Failover**, lalu pilih cluster sekunder dari Daftar drop-down bidang **cluster primer baru**.
![\[Gambar: Kotak dialog switchover atau failover cluster global.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switch-fail-confirm.png)
1. Ketik “konfirmasi” di bidang terakhir. Kemudian pilih **Konfirmasi**.
Status klaster utama berubah menjadi "**Failing-over**”. Kondisi ini akan memakan waktu sekitar satu menit. Selama waktu ini, status cluster primer baru menunjukkan "**Memodifikasi**... “. Setelah primer baru dipromosikan, itu akan menampilkan "**Tersedia**" dan akan dapat melayani transaksi baca dan tulis. Wilayah sekunder termasuk primer lama akan menampilkan "**Menyinkronkan ulang**... “sementara itu menyinkronkan ulang ke primer baru. Mirip dengan primer baru, itu hanya akan dapat melayani transaksi setelah status berubah menjadi "**Tersedia**”.
1. Ketika selesai, cluster primer asli menjadi cluster sekunder. Cluster sekunder yang dipilih menjadi cluster utama.
![\[Gambar: Tabel cluster menunjukkan cluster primer baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Lakukan failover terkelola di klaster global Amazon DocumentDB**
Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/failover-global-cluster.html)CLI agar gagal melalui cluster global Amazon DocumentDB Anda. Dengan perintah, berikan nilai untuk opsi berikut:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
+ `--allow-data-loss`
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb failover-global-cluster \
--region region_of_selected_secondary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote \
--allow-data-loss
```
Untuk Windows:
```
aws docdb failover-global-cluster ^
--region region_of_selected_secondary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote ^
--allow-data-loss
```
------
## Melakukan failover manual untuk klaster global Amazon DocumentDB
Jika seluruh cluster dalam satu Wilayah AWS menjadi tidak tersedia, Anda dapat mempromosikan klaster lain di cluster global untuk memiliki read/write kemampuan.
Anda dapat mengaktifkan mekanisme failover cluster global secara manual jika cluster di cluster yang berbeda Wilayah AWS adalah pilihan yang lebih baik untuk menjadi cluster utama. Misalnya, Anda dapat meningkatkan kapasitas salah satu klaster sekunder dan kemudian mempromosikannya menjadi klaster primer. Atau keseimbangan aktivitas di antara Wilayah AWS mungkin berubah, sehingga mengalihkan cluster utama ke cluster lain Wilayah AWS mungkin memberikan latensi yang lebih rendah untuk operasi penulisan.
Prosedur berikut menguraikan apa yang harus dilakukan untuk mempromosikan salah satu cluster sekunder di cluster global Amazon DocumentDB.
Untuk mempromosikan cluster sekunder:
1. Berhenti mengeluarkan pernyataan DHTML dan operasi penulisan lainnya ke cluster utama di Wilayah AWS with the outage.
1. Identifikasi cluster dari sekunder Wilayah AWS untuk digunakan sebagai cluster primer baru. Jika Anda memiliki dua (atau lebih) sekunder Wilayah AWS di cluster global Anda, pilih cluster sekunder yang memiliki waktu jeda paling sedikit.
1. Lepaskan klaster sekunder yang Anda pilih dari klaster global.
Menghapus cluster sekunder dari cluster global segera menghentikan replikasi dari primer ke sekunder ini dan mempromosikannya ke cluster yang disediakan mandiri dengan kemampuan penuh. read/write Klaster sekunder lainnya yang terkait dengan klaster primer di wilayah dengan pemadaman masih tersedia dan dapat menerima panggilan dari aplikasi Anda. Klaster tersebut juga mengonsumsi sumber daya. Karena Anda membuat ulang klaster global, untuk menghindari otak-terbelah dan masalah lainnya, hapus klaster sekunder lainnya sebelum membuat klaster global baru dalam langkah-langkah berikut.
Untuk langkah-langkah rinci untuk melepaskan, lihat [Menghapus klaster dari klaster global Amazon DocumentDB](global-clusters.manage.md#global-clusters.remove).
1. Klaster ini menjadi klaster primer dari klaster global baru saat Anda mulai menambahkan Wilayah ke dalamnya, pada langkah berikutnya.
1. Tambahkan Wilayah AWS ke cluster. Saat Anda melakukannya, proses replikasi dari klaster primer ke klaster sekunder akan dimulai.
1. Tambahkan lebih banyak Wilayah AWS sesuai kebutuhan untuk membuat ulang topologi yang diperlukan untuk mendukung aplikasi Anda. Pastikan bahwa penulisan aplikasi dikirim ke klaster yang benar sebelum, selama, dan setelah membuat perubahan seperti ini, untuk menghindari inkonsistensi data di antara klaster dalam klaster global (masalah split-brain).
1. Saat pemadaman teratasi dan Anda siap menugaskan Wilayah AWS asli sebagai klaster primer lagi, lakukan langkah yang sama secara terbalik.
1. Hapus salah satu klaster sekunder dari klaster global. Ini akan memungkinkannya untuk melayani read/write lalu lintas.
1. Alihkan ulang semua lalu lintas tulis ke klaster primer di Wilayah AWS asli.
1. Tambahkan Wilayah AWS untuk mengatur satu atau lebih cluster sekunder yang sama Wilayah AWS seperti sebelumnya.
Cluster global Amazon DocumentDB dapat dikelola AWS SDKs menggunakan, memungkinkan Anda membuat solusi untuk mengotomatiskan proses failover klaster global untuk kasus penggunaan Disaster Recovery dan Business Continuity Planning. [Salah satu solusi tersebut tersedia untuk pelanggan kami di bawah lisensi Apache 2.0 dan dapat diakses dari repositori alat kami di sini.](https://github.com/awslabs/amazon-documentdb-tools/tree/master/global-clusters-automation) Solusi ini memanfaatkan Amazon Route 53 untuk manajemen titik akhir dan menyediakan AWS Lambda fungsi yang dapat dipicu berdasarkan peristiwa yang sesuai.
## Melakukan peralihan untuk klaster global Amazon DocumentDB
Dengan menggunakan switchover, Anda dapat mengubah Wilayah cluster utama Anda secara rutin. Pendekatan ini ditujukan untuk skenario yang terkontrol, seperti pemeliharaan operasional dan prosedur operasional terencana lainnya.
Ada tiga kasus penggunaan umum untuk menggunakan switchover:
+ Untuk persyaratan "rotasi regional" yang diberlakukan pada industri tertentu. Misalnya, peraturan layanan keuangan mungkin menginginkan sistem tier-0 untuk beralih ke Wilayah yang berbeda selama beberapa bulan untuk memastikan prosedur pemulihan bencana dilaksanakan secara teratur.
+ Untuk aplikasi Multi-region follow-the-sun "”. Misalnya, suatu bisnis mungkin ingin menyediakan penulisan dengan latensi lebih rendah di berbagai Wilayah berdasarkan jam kerja di zona waktu yang berbeda.
+ Sebagai zero-data-loss metode untuk gagal kembali ke Wilayah primer asli setelah failover.
**catatan**
Switchovers dirancang untuk digunakan pada cluster global Amazon DocumentDB yang sehat. Untuk pulih dari pemadaman yang tak terduga, ikuti prosedur yang sesuai di [Melakukan failover manual untuk klaster global Amazon DocumentDB](#manual-failover).
Untuk melakukan switchover, semua wilayah sekunder harus menjalankan versi mesin yang sama persis dengan yang utama. Jika versi mesin wilayah tidak cocok, peralihan akan diblokir. Silakan periksa peningkatan yang tertunda dan terapkan untuk memastikan semua versi mesin wilayah cocok dan peralihan cluster global tidak diblokir. Untuk informasi selengkapnya, lihat [Membuka blokir peralihan atau failover klaster global](#unblocking-gc-so-fo).
Selama peralihan, Amazon DocumentDB mengalihkan klaster utama Anda ke Wilayah sekunder pilihan Anda sambil mempertahankan topologi replikasi klaster global yang ada. Sebelum memulai proses peralihan, Amazon DocumentDB menunggu semua cluster Region sekunder disinkronkan sepenuhnya dengan kluster Region primer. Selanjutnya, klaster DB di Wilayah primer menjadi klaster hanya-baca, dan klaster sekunder yang dipilih akan mempromosikan salah satu simpul hanya-bacanya menjadi status penulis penuh. Mempromosikan simpul ini menjadi penulis memungkinkan klaster sekunder mengambil peran klaster primer. Karena semua cluster sekunder disinkronkan dengan primer pada awal proses, primer baru melanjutkan operasi untuk cluster global Amazon DocumentDB tanpa kehilangan data apa pun. Basis data Anda tidak tersedia untuk sementara selama klaster primer dan klaster sekunder yang dipilih mengambil peran barunya masing-masing.
Untuk mengoptimalkan ketersediaan aplikasi, sebaiknya lakukan hal berikut sebelum menggunakan fitur ini:
+ Lakukan operasi ini selama jam nonpeak atau di lain waktu ketika menulis ke cluster primer minimal.
+ Bawa aplikasi offline untuk mencegah penulisan dikirim ke cluster utama klaster global Amazon DocumentDB.
+ Periksa waktu jeda untuk semua cluster sekunder Amazon DocumentDB di cluster global dengan melihat metrik di `GlobalClusterReplicationLag` Amazon. CloudWatch Metrik ini menunjukkan seberapa jauh di belakang (dalam milidetik) replikasi ke cluster sekunder ke cluster primer. Nilai ini berbanding lurus dengan waktu yang dibutuhkan Amazon DocumentDB untuk menyelesaikan peralihan. Karena itu, semakin besar nilai keterlambatan, semakin lama durasi switchover.
Untuk informasi selengkapnya tentang CloudWatch metrik untuk Amazon [Metrik Amazon DocumentDB](cloud_watch.md#cloud_watch-metrics_list) DocumentDB, lihat.
Selama proses switchover, klaster DB sekunder yang dipilih akan dipromosikan ke peran barunya sebagai primer. Namun, klaster ini tidak mewarisi berbagai opsi konfigurasi klaster DB primer. Ketidakcocokan dalam konfigurasi dapat menyebabkan masalah performa, inkompatibilitas beban kerja, dan perilaku anomali lainnya. Untuk menghindari masalah seperti itu, kami sarankan Anda menyelesaikan perbedaan antara kluster global Amazon DocumentDB Anda untuk hal-hal berikut:
+ **Konfigurasikan grup parameter cluster Amazon DocumentDB DB untuk primer baru, jika perlu — Anda dapat mengonfigurasi grup parameter klaster** Amazon DocumentDB secara independen untuk setiap cluster di klaster global Amazon DocumentDB Anda. Hal ini berarti ketika Anda mempromosikan klaster DB sekunder untuk mengambil alih peran primer, grup parameter dari klaster sekunder mungkin memiliki konfigurasi yang berbeda dengan klaster primer. Jika demikian, ubah grup parameter klaster DB sekunder yang dipromosikan agar sesuai dengan pengaturan klaster primer Anda. Untuk mempelajari caranya, lihat [Mengelola grup parameter cluster Amazon DocumentDB](cluster_parameter_groups.md).
+ **Konfigurasikan alat dan opsi pemantauan, seperti Amazon CloudWatch Events dan alarm** — Konfigurasikan klaster yang dipromosikan dengan kemampuan logging, alarm, dan sebagainya yang sama sesuai kebutuhan untuk klaster global. Seperti grup parameter, konfigurasi untuk fitur ini tidak diwariskan dari klaster primer selama proses switchover berlangsung. Beberapa CloudWatch metrik, seperti replikasi lag, hanya tersedia untuk Wilayah primer. Karena itu, switchover akan mengubah cara Anda melihat metrik tersebut dan mengatur alarmnya, serta mengharuskan adanya perubahan pada dasbor yang ditentukan sebelumnya. Untuk informasi selengkapnya, lihat [Memantau Amazon DocumentDB](monitoring_docdb.md).
**catatan**
Biasanya, switchover peran dapat memerlukan waktu hingga beberapa menit.
Saat proses peralihan selesai, klaster Amazon DocumentDB yang dipromosikan dapat menangani operasi penulisan untuk klaster global.
Anda dapat beralih ke klaster global Amazon DocumentDB menggunakan Konsol Manajemen AWS atau: AWS CLI
------
#### [ Using the Konsol Manajemen AWS ]
**Lakukan peralihan di klaster global Amazon DocumentDB Anda**
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Temukan dan pilih klaster global Amazon DocumentDB yang ingin Anda alihkan.
![\[Gambar: Tabel cluster dengan cluster global dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switchover-cluster-table.png)
1. **Pilih **Switchover atau Failover** dari menu Tindakan.**
1. Pada kotak dialog yang muncul, pilih **Switchover**, lalu pilih cluster sekunder dari Daftar drop-down bidang **cluster primer baru**.
![\[Gambar: Cluster beralih dialog dengan cluster sekunder dipilih.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/switch-fail-confirm-2.png)
1. Pilih **Konfirmasi**.
Status klaster utama berubah menjadi "**Switching-over**”. Kondisi ini akan memakan waktu sekitar tiga menit. Selama waktu ini, status semua cluster regional menunjukkan "**Memodifikasi**... “. Setelah wilayah disinkronkan dan primer baru dipromosikan, itu akan menampilkan "**Tersedia**" untuk semua bidang status dan akan dapat melayani transaksi.
1. Ketika selesai, cluster primer asli menjadi cluster sekunder. Cluster sekunder yang dipilih menjadi cluster utama.
![\[Gambar: Tabel cluster menunjukkan cluster primer baru.\]](http://docs.aws.amazon.com/id_id/documentdb/latest/developerguide/images/failover-complete.png)
------
#### [ Using the AWS CLI ]
**Lakukan peralihan di klaster global Amazon DocumentDB Anda**
Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/switchover-global-cluster.html)CLI untuk beralih ke cluster global Amazon DocumentDB Anda. Dengan perintah, berikan nilai untuk opsi berikut:
+ `--region`
+ `--global-cluster-identifier`
+ `--target-db-cluster-identifier`
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb switchover-global-cluster \
--region region_of_primary \
--global-cluster-identifier global_cluster_id \
--target-db-cluster-identifier arn_of_secondary_to_promote
```
Untuk Windows:
```
aws docdb switchover-global-cluster ^
--region region_of_primary ^
--global-cluster-identifier global_cluster_id ^
--target-db-cluster-identifier arn_of_secondary_to_promote
```
------
## Membuka blokir peralihan atau failover klaster global
Switchover dan failover cluster global diblokir ketika tidak semua cluster regional di cluster global menggunakan versi mesin yang sama. Jika versi tidak cocok, Anda mungkin melihat kesalahan ini sebagai respons saat memanggil switchover atau failover: Cluster DB target yang ditentukan menjalankan versi engine dengan tingkat patch yang berbeda dari cluster DB sumber. Kami merekomendasikan secara rutin menerapkan versi mesin terbaru untuk memastikan Anda menjalankan pembaruan terbaru untuk menjaga klaster global Anda dalam keadaan sehat.
Untuk mengatasi kesalahan ini, perbarui semua wilayah sekunder terlebih dahulu, lalu wilayah utama ke versi mesin yang sama dengan menerapkan item tindakan pemeliharaan yang tertunda. Untuk melihat item tindakan pemeliharaan yang tertunda, dan menerapkan perubahan yang diperlukan untuk memperbaiki masalah, lakukan instruksi di salah satu tab berikut:
------
#### [ Using the Konsol Manajemen AWS ]
Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk cluster Anda dan menerapkannya. Ikuti langkah-langkah ini untuk melihat dan menerapkan tindakan pemeliharaan:
1. [Masuk ke Konsol Manajemen AWS, dan buka konsol Amazon DocumentDB di /docdb. https://console.aws.amazon.com](https://console.aws.amazon.com/docdb)
1. Pada panel navigasi, silakan pilih **Klaster**.
1. Dalam tabel **Clusters**, temukan klaster global Anda di kolom **pengenal Cluster**. Di bawah klaster global Anda, catat setiap cluster sekunder dan klaster utama untuk klaster global yang diberikan, dan lakukan langkah-langkah berikut untuk masing-masing klaster.
1. Untuk setiap cluster sekunder:
1. Jika pembaruan tersedia untuk klaster Anda, itu ditunjukkan sebagai **Tersedia**, **Diperlukan**, atau **Jendela Berikutnya** di kolom **Pemeliharaan**.
1. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih **Maintenance & backup**. Item **Pemeliharaan Tertunda** muncul.
1. Di bawah **Deskripsi**, jika ini menunjukkan bahwa “Pembaruan pemeliharaan baru tersedia”, pilih dan kemudian pilih **Terapkan sekarang**.
1. Untuk klaster utama Anda:
1. Jika pembaruan tersedia untuk klaster Anda, itu ditunjukkan sebagai **Tersedia**, **Diperlukan**, atau **Jendela Berikutnya** di kolom **Pemeliharaan**.
1. Untuk mengambil tindakan, pilih cluster untuk menampilkan detailnya, lalu pilih **Maintenance & backup**. Item **Pemeliharaan Tertunda** muncul.
1. Di bawah **Deskripsi**, jika ini menunjukkan bahwa “Pembaruan pemeliharaan baru tersedia”, pilih dan kemudian pilih **Terapkan sekarang**.
------
#### [ Using the AWS CLI ]
Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk klaster dan menerapkannya. Ikuti langkah-langkah berikut untuk melihat dan menerapkan tindakan pemeliharaan terlebih dahulu pada cluster sekunder kemudian pada klaster utama untuk klaster global Anda:
1. Jalankan yang berikut ini pada setiap cluster regional regional sekunder terlebih dahulu dan kemudian untuk klaster regional daerah primer.
1. Jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)CLI dengan `--resource-identifier` opsi untuk menentukan apakah ada tindakan pemeliharaan yang tersedia untuk klaster regional Amazon DocumentDB Anda.
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb describe-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Untuk Windows:
```
aws docdb describe-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15
```
Hasilnya terlihat mirip dengan ini:
```
{
"PendingMaintenanceActions": [
{
"ResourceIdentifier": "arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15",
"PendingMaintenanceActionDetails": [
{
"Action": "system-update",
"CurrentApplyDate": "2025-04-11T03:01:00Z",
"Description": "db-version-upgrade",
"ForcedApplyDate": "2025-06-18T03:01:00Z",
"AutoAppliedAfterDate": "2025-05-11T03:01:00Z"
"OptInStatus": "pending"
}
]
}
]
}
```
1. Jika tindakan pemeliharaan diperlukan, jalankan perintah [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/apply-pending-maintenance-action.html)CLI dengan opsi berikut:
+ `--resource-identifier`
+ `--apply-action`
+ `--opt-in-type`
+ `--region`
Dalam contoh berikut, ganti masing-masing *user input placeholder* dengan informasi cluster Anda.
Untuk Linux, macOS, atau Unix:
```
aws docdb apply-pending-maintenance-action \
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 \
--apply-action system-update \
--opt-in-type immediate \
--region us-east-1
```
Untuk Windows:
```
aws docdb apply-pending-maintenance-action ^
--resource-identifier arn:aws:rds:us-east-1:001234567890:cluster:docdb-2025-03-27-19-21-15 ^
--apply-action system-update ^
--opt-in-type immediate ^
--region us-east-1
```
1. Setelah tindakan pemeliharaan selesai, jalankan [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/describe-pending-maintenance-actions.html)perintah lagi untuk memastikan bahwa tidak ada tindakan lain yang tertunda untuk cluster Anda.
Hasil yang Anda inginkan adalah:
```
{
"PendingMaintenanceActions": []
}
```
------
#### [ Using the Amazon DocumentDB API ]
Untuk membuka blokir peralihan atau failover klaster global, Anda harus menentukan apakah ada tindakan pemeliharaan yang tertunda untuk klaster dan menerapkannya. Gunakan yang berikut ini APIs untuk melihat dan menerapkan tindakan pemeliharaan:
1. Jalankan yang berikut ini pada setiap cluster regional regional sekunder terlebih dahulu dan kemudian untuk klaster regional daerah primer.
1. Panggil [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_PendingMaintenanceAction.html)API untuk menentukan apakah ada tindakan pemeliharaan yang tersedia untuk klaster global Amazon DocumentDB Anda.
1. Terapkan perubahan apa pun dengan memanggil [https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html](https://docs.aws.amazon.com/documentdb/latest/developerguide/API_ApplyPendingMaintenanceAction.html)API.
------