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 Wilayah ke cluster global](#global-clusters.add-region) + [Menggunakan snapshot](#global-clusters.snapshot) ## Konfigurasi Cluster global Amazon DocumentDB mencakup setidaknya dua. Wilayah AWS Wilayah utama mendukung cluster yang memiliki satu instance utama (penulis) dan hingga 15 instans replika, sementara Wilayah sekunder menjalankan cluster read-only yang seluruhnya terdiri dari hingga 16 instans replika. Cluster global dapat memiliki hingga 10 Wilayah sekunder. Tabel mencantumkan klaster, instans, dan replika maksimum yang diizinkan dalam klaster global. | Deskripsi | Primer Wilayah AWS | Sekunder Wilayah AWS | | --- | --- | --- | | klaster | 1 | 10 (maksimum) | | Instans penulis | 1 | 0 | | Read-only instans (replika Amazon DocumentDB), per cluster | 15 (maks) | 16 (total) | | Read-only instance (maksimum diizinkan, diberikan jumlah aktual 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.r6g` instance `db.r5` dan. + **Wilayah AWS persyaratan ** — Cluster utama harus berada di satu Wilayah, dan setidaknya satu cluster sekunder harus berada di Wilayah yang berbeda dari akun yang sama. Anda dapat membuat hingga 10 cluster sekunder (read-only), 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 cluster global baru dengan cluster dan instance database baru, menggunakan Konsol Manajemen AWS atau AWS CLI dengan instruksi berikut. ### Menggunakan Konsol Manajemen AWS 1. Di Konsol Manajemen AWS, arahkan ke ** Amazon DocumentDB**. 1. Ketika Anda sampai ke konsol Amazon DocumentDB, pilih **Klaster**. ![Halaman Cluster di konsol Amazon DocumentDB.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/choose-cluster.png) 1. Pilih **Buat**. ![Tombol Create ditampilkan di sudut kanan atas tabel Clusters.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/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**. ![Bentuk opsi konfigurasi untuk membuat cluster Amazon DocumentDB.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/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.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/create-auth.png) 1. Pilih ** Tampilkan pengaturan lanjutan**. ![Tampilkan tombol sakelar pengaturan lanjutan di sebelah tombol Batal dan Buat cluster.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/show-advanced.png) 1. Di ** bagian ** Pengaturan jaringan: + Pertahankan opsi default untuk ** Virtual Private Cloud (VPC) ** dan grup ** Subnet. ** ![Bentuk pengaturan jaringan menunjukkan opsi VPC, grup subnet, dan grup keamanan VPC. Bidang grup VPC dan Subnet memiliki opsi default yang dipilih.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/default-vpc-1.png) + Untuk ** grup keamanan VPC**, ** default (VPC) ** seharusnya sudah ditambahkan. ![Formulir pengaturan jaringan menunjukkan VPC default sudah ditambahkan.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/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 di menu dropdown grup keamanan VPC.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/inbound-vfc.png) 1. Untuk opsi ** Cluster ** dan ** Encryption-at-rest**, biarkan pada pilihan default. ![Opsi klaster dan Encryption-at-rest formulir dengan opsi default dipilih.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/leave-default-1.png) 1. Untuk ekspor ** ** Cad ** angan dan Log**, biarkan pada pilihan default. ![Backup dan Log mengekspor formulir dengan opsi default yang dipilih.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/leave-default-2.png) 1. Untuk perlindungan ** Pemeliharaan**, ** Tag**, dan ** Penghapusan**, biarkan pada pilihan default. ![Formulir perlindungan Pemeliharaan, Tag, dan Penghapusan dengan opsi default dipilih.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/leave-default-3.png) 1. Sekarang pilih ** Buat cluster**. ![Tombol Create cluster ditampilkan di akhir proses pembuatan cluster.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/create-cluster.png) ### Menggunakan AWS CLI Untuk membuat cluster Regional Amazon DocumentDB, panggil cluster [ cre AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/docdb/create-global-cluster.html) ate-global-. Per AWS CLI intah 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` diperbarui untuk mencerminkan versi mesin utama terakhir. Akibatnya, untuk beban kerja produksi, dan terutama yang bergantung pada scripting, otomatisasi, atau CloudFormation templat, secara eksplisit menentukan versi utama `--engine-version` yang dimaksud. Jika `db-subnet-group-name` atau tidak `vpc-security-group-id` ditentukan, Amazon DocumentDB akan menggunakan grup subnet default dan grup keamanan Amazon VPC untuk Wilayah yang diberikan. 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 cluster Amazon DocumentDB](monitoring_docdb-cluster_status.md). **penting** Saat Anda menggunakan AWS CLI untuk membuat cluster Regional Amazon DocumentDB, tidak ada instans 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 bu [ atDBCluster ](https://docs.aws.amazon.com/documentdb/latest/APIReference/API_CreateDBCluster.html) di Referensi API * Amazon DocumentDB. * Setelah cluster Regional Anda tersedia, Anda dapat menambahkan cluster sekunder di Wilayah lain dengan instruksi berikut:[Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB](#global-clusters.add-region). Ketika Anda menambahkan Wilayah, cluster Regional Anda menjadi cluster utama Anda, dan Anda memiliki cluster sekunder baru di Wilayah yang Anda pilih. ## Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB Cluster global membutuhkan setidaknya satu cluster sekunder di Wilayah yang berbeda dari cluster primer, dan Anda dapat menambahkan hingga 10 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 cluster global Anda memiliki 10 Wilayah sekunder, cluster utama Anda hanya dapat memiliki 5 (bukan 15) replika. Untuk informasi selengkapnya, lihat [Konfigurasi](#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 Cluster di konsol Amazon DocumentDB.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/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.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/choose-cluster-2.png) 1. Pilih daftar dropdown untuk Tindakan ** ** dan kemudian pilih Tam ** bah Wilayah**. ![Dropdown Tindakan pada antarmuka Cluster menunjukkan opsi Tambah Wilayah.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/add-region.png) 1. Pada Wilayah AWS** halaman ** Tambahkan, pilih Wilayah sekunder. Perhatikan bahwa 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. Jika ini adalah Wilayah pertama yang Anda tambahkan, Anda juga harus menentukan pengidentifikasi cluster global pilihan Anda. ![Pilih Wilayah sekunder menggunakan menu dropdown pada Add an Wilayah AWS form.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/images/global-clusters/quick-start/add-region-2.png) 1. Lengkapi kolom 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 menambahkan Wilayah ke cluster, menampilkan formulir Konfigurasi, perkiraan biaya per jam, dan tombol Buat cluster.](https://docs.aws.amazon.com/id_id/documentdb/latest/devguide/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 cluster terenkripsi, tentukan primer Anda Wilayah AWS sebagai `--source-region` untuk enkripsi. 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 Region lain ke cluster yang dipulihkan, sehingga mengubahnya menjadi cluster global.