Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
Konfigurasi
Cluster global Amazon DocumentDB mencakup setidaknya dua. Wilayah AWS Wilayah primer mendukung klaster yang memiliki satu instans primer (penulis) dan hingga lima belas instans replika, sedangkan wilayah sekunder menjalankan klaster baca saja yang seluruhnya terdiri dari hingga enam belas instans replika. Klaster global dapat memiliki sampai dengan 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 read-only (maks yang diperbolehkan, mengingat jumlah aktual dari region sekunder) | 15 - s | s = jumlah total sekunder Wilayah AWS |
Klaster memiliki persyaratan khusus berikut:
-
Persyaratan kelas instance database - Anda hanya dapat menggunakan kelas
db.r5dandb.r6instance. -
Wilayah AWS persyaratan — Cluster primer harus berada di satu wilayah, dan setidaknya satu cluster sekunder harus berada di wilayah yang berbeda dari akun yang sama. Anda dapat membuat hingga lima klaster sekunder (baca saja), dan masing-masing klaster harus berada di wilayah yang berbeda. Dengan kata lain, tidak ada dua klaster yang bisa berada di wilayah yang sama.
-
Persyaratan penamaan — Nama yang Anda pilih untuk setiap klaster harus unik, di semua wilayah. Anda tidak dapat menggunakan nama yang sama untuk klaster yang berbeda meskipun 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 AWS Management Console atau AWS CLI dengan instruksi berikut.
-
Di AWS Management Console, navigasikan ke Amazon DocumentDB.
-
Ketika Anda sampai ke konsol Amazon DocumentDB, pilih Klaster.
-
Pilih Buat.
-
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.
-
-
Di Autentikasi, isi nama pengguna utama dan kata sandi utama.
-
Pilih Pengaturan Lanjutan.
-
Di bagian Pengaturan Jaringan:
-
Simpan opsi default untuk Virtual Private Cloud dan Grup Subnet.
-
Untuk Grup keamanan VPC, VPC Default seharusnya sudah ditambahkan.
-
Ketik
DocDBke dalam bidang Grup keamanan VPC dan pilih DocDB-Inbound (VPC).
-
-
Untuk Cluster Options dan E ncryption-at-rest, biarkan pada pilihan default.
-
Untuk Cadangan dan Ekspor log, tinggalkan pada pilihan default.
-
Untuk Pemeliharaan, Tag dan Perlindungan Penghapusan, tinggalkan pilihan default.
-
Sekarang klik tombol yang mengatakan Buat.
-
Di AWS Management Console, navigasikan ke Amazon DocumentDB.
-
Ketika Anda sampai ke konsol Amazon DocumentDB, pilih Klaster.
-
Pilih Buat.
-
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.
-
-
Di Autentikasi, isi nama pengguna utama dan kata sandi utama.
-
Pilih Pengaturan Lanjutan.
-
Di bagian Pengaturan Jaringan:
-
Simpan opsi default untuk Virtual Private Cloud dan Grup Subnet.
-
Untuk Grup keamanan VPC, VPC Default seharusnya sudah ditambahkan.
-
Ketik
DocDBke dalam bidang Grup keamanan VPC dan pilih DocDB-Inbound (VPC).
-
-
Untuk Cluster Options dan E ncryption-at-rest, biarkan pada pilihan default.
-
Untuk Cadangan dan Ekspor log, tinggalkan pada pilihan default.
-
Untuk Pemeliharaan, Tag dan Perlindungan Penghapusan, tinggalkan pilihan default.
-
Sekarang klik tombol yang mengatakan Buat.
Untuk membuat cluster regional Amazon DocumentDB, hubungi. create-global-cluster AWS CLIglobal-cluster-id Untuk informasi selengkapnya tentang perlindungan penghapusan, lihat Menghapus cluster Amazon DocumentDB.
Juga, --engine-version adalah parameter opsional yang default ke versi mesin utama terbaru. Versi mesin utama saat ini adalah 5.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 AWS 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-identifierglobal-cluster-id\ --source-db-cluster-identifier arn:aws:rds:us-east-1:111122223333:cluster-id
Untuk Windows:
aws docdb create-db-cluster ^ --global-cluster-identifierglobal-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 AWS Management Console atau AWS CLI untuk memantau status cluster Anda. Untuk informasi selengkapnya, lihat Memantau status klaster Amazon DocumentDB.
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 dan CreateDBCluster di Referensi API Amazon DocumentDB.
Setelah klaster wilayah Anda tersedia, Anda dapat menambahkan klaster sekunder di wilayah lain dengan petunjuk berikut: Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB. Saat Anda menambahkan wilayah, klaster wilayah Anda menjadi klaster primer Anda, dan Anda memiliki klaster sekunder baru di wilayah yang Anda pilih.
Menambahkan Wilayah AWS ke cluster global Amazon DocumentDB
Klaster global membutuhkan setidaknya satu klaster sekunder di wilayah yang berbeda dari klaster primer, dan Anda dapat menambahkan hingga lima klaster 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 primer Anda hanya dapat memiliki sepuluh (bukan lima belas) replika. Untuk informasi selengkapnya, lihat Persyaratan konfigurasi klaster global Amazon DocumentDB.
-
Masuk ke AWS Management Console dan buka konsol Amazon DocumentDB.
-
Pada panel navigasi, silakan pilih Klaster.
-
Pilih klaster yang ingin Anda tambahkan klaster sekundernya. Pastikan bahwa klaster adalah
Available.
-
Pilih menu drop down untuk Tindakan dan lalu pilih Tambah wilayah.
-
Pada halaman Tambah wilayah, pilih wilayah sekunder. Perhatikan bahwa Anda tidak dapat memilih wilayah yang sudah memiliki klaster sekunder untuk klaster global yang sama. Selain itu, wilayah tersebut tidak boleh sama dengan klaster primer. Jika ini adalah wilayah pertama yang Anda tambahkan, Anda juga harus menentukan pengidentifikasi klaster global pilihan Anda.
-
Lengkapi bidang yang tersisa untuk klaster sekunder di wilayah baru, lalu pilih Buat Klaster. Setelah Anda selesai menambahkan wilayah, Anda dapat melihatnya di daftar Klaster di AWS Management Console.
-
Masuk ke AWS Management Console dan buka konsol Amazon DocumentDB.
-
Pada panel navigasi, silakan pilih Klaster.
-
Pilih klaster yang ingin Anda tambahkan klaster sekundernya. Pastikan bahwa klaster adalah
Available.
-
Pilih menu drop down untuk Tindakan dan lalu pilih Tambah wilayah.
-
Pada halaman Tambah wilayah, pilih wilayah sekunder. Perhatikan bahwa Anda tidak dapat memilih wilayah yang sudah memiliki klaster sekunder untuk klaster global yang sama. Selain itu, wilayah tersebut tidak boleh sama dengan klaster primer. Jika ini adalah wilayah pertama yang Anda tambahkan, Anda juga harus menentukan pengidentifikasi klaster global pilihan Anda.
-
Lengkapi bidang yang tersisa untuk klaster sekunder di wilayah baru, lalu pilih Buat Klaster. Setelah Anda selesai menambahkan wilayah, Anda dapat melihatnya di daftar Klaster di AWS Management Console.
-
Gunakan perintah CLI
create-db-clusterdengan 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
--enginedan--engine-version. -
Untuk klaster terenkripsi, tentukan primer Anda Wilayah AWS sebagai enkripsi
--source-regionuntuk.
-
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 --regionsecondary-region-id\ create-db-cluster \ --db-cluster-identifiercluster-id\ --global-cluster-identifierglobal-cluster-id\ --engine-versionversion\ --engine docdb aws docdb --regionsecondary-region-id\ create-db-instance \ --db-cluster-identifiercluster-id\ --global-cluster-identifierglobal-cluster-id\ --engine-versionversion\ --engine docdb
Untuk Windows:
aws docdb --regionsecondary-region-id^ create-db-cluster ^ --db-cluster-identifiercluster-id^ --global-cluster-identifierglobal-cluster-id^ --engine-versionversion^ --engine docdb aws docdb --regionsecondary-region-id^ create-db-instance ^ --db-cluster-identifiercluster-id^ --global-cluster-identifierglobal-cluster-id^ --engine-versionversion^ --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 klaster yang dipulihkan, sehingga mengubahnya menjadi klaster global.
