View a markdown version of this page

Panduan Memulai Cepat: Cluster Global - Amazon DocumentDB
KonfigurasiMembuat klaster globalMenambahkan Wilayah ke cluster globalMenggunakan snapshot

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

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.

  1. Di Konsol Manajemen AWS, arahkan ke Amazon DocumentDB.

  2. Ketika Anda sampai ke konsol Amazon DocumentDB, pilih Klaster.

    Halaman Cluster di konsol Amazon DocumentDB.

  3. Pilih Buat.

    Tombol Create ditampilkan di sudut kanan atas tabel Clusters.

  4. 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.

  5. 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.

  6. Pilih Tampilkan pengaturan lanjutan.

    Tampilkan tombol sakelar pengaturan lanjutan di sebelah tombol Batal dan Buat cluster.

  7. 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.

    • Untuk grup keamanan VPC, default (VPC) seharusnya sudah ditambahkan.

      Formulir pengaturan jaringan menunjukkan VPC default sudah ditambahkan.

    • Ketik DocDB ke dalam bidang grup keamanan VPC dan pilih DocDB-Inbound (VFC).

      DocDB-Inbound VFC dipilih di menu dropdown grup keamanan VPC.

  8. Untuk opsi Cluster dan Encryption-at-rest, biarkan pada pilihan default.

    Opsi klaster dan Encryption-at-rest formulir dengan opsi default dipilih.

  9. Untuk ekspor Cad angan dan Log, biarkan pada pilihan default.

    Backup dan Log mengekspor formulir dengan opsi default yang dipilih.

  10. Untuk perlindungan Pemeliharaan, Tag, dan Penghapusan, biarkan pada pilihan default.

    Formulir perlindungan Pemeliharaan, Tag, dan Penghapusan dengan opsi default dipilih.

  11. Sekarang pilih Buat cluster.

    Tombol Create cluster ditampilkan di akhir proses pembuatan cluster.

Untuk membuat cluster Regional Amazon DocumentDB, panggil cluster cre AWS CLI ate-global-. Per AWS CLI intah berikut membuat cluster Amazon DocumentDB bernamaglobal-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 default saat ini adalah 5.0.0 (catatan: Amazon DocumentDB 8.0 tersedia tetapi harus ditentukan secara eksplisit sebagai8.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.

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 dan bu atDBCluster 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. 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.

  1. Masuk ke Konsol Manajemen AWS dan buka konsol Amazon DocumentDB.

  2. Pada panel navigasi, silakan pilih Klaster.

    Halaman Cluster di konsol Amazon DocumentDB.

  3. 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.

  4. Pilih daftar dropdown untuk Tindakan dan kemudian pilih Tam bah Wilayah.

    Dropdown Tindakan pada antarmuka Cluster menunjukkan opsi Tambah Wilayah.

  5. 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.

  6. 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.

  • 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.