Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# 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.