Menambahkan instance Amazon DocumentDB ke cluster

Using the AWS Management Console

Gunakan prosedur berikut untuk membuat instans untuk klaster Anda menggunakan konsol Amazon DocumentDB.

Masuk ke AWS Management Console, dan buka konsol Amazon DocumentDB di https://console.aws.amazon.com/docdb.
Di panel navigasi, pilih Klaster.

Tip
Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu () di pojok kiri atas halaman.
Untuk memilih klaster yang ingin Anda tambahi instans, pilih tombol di sebelah kiri nama klaster.
Pilih Tindakan, dan kemudian pilih Tambahkan instans.
Di halaman Tambahkan instans ke: <cluster-name>, ulangi langkah berikut untuk setiap instans yang ingin Anda tambahkan ke klaster. Anda dapat memiliki hingga 15.
1. Pengidentifikasi instans — Anda dapat memasukkan pengidentifikasi unik untuk instans ini atau mengizinkan Amazon DocumentDB menyediakan pengidentifikasi instans berdasarkan pengidentifikasi klaster.
  
  Kendala penamaan instans:
  - Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
  - Karakter pertama harus berupa huruf.
  - Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
  - Harus unik untuk semua instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
2. Kelas instans — Dari daftar tarik-turun, pilih tipe instans yang Anda inginkan untuk instans ini.
3. Tingkat promosi — Dari daftar tarik-turun, pilih tingkat promosi untuk instans Anda atau pilih Tidak ada preferensi guna mengizinkan Amazon DocumentDB untuk mengatur tingkat promosi untuk instans Anda. Angka yang lebih rendah berarti prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat Mengontrol Target Failover.
4. Untuk menambahkan lebih banyak instans, pilih Tambahkan instans tambahan dan ulangi langkah a, b, dan c.
Selesaikan operasi.
- Untuk menambahkan instans ke klaster Anda, pilih Buat.
- Untuk membatalkan operasi, pilih Batal.

Dibutuhkan beberapa menit untuk membuat sebuah instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat Memantau status instans.

Using the AWS CLI

Gunakan create-db-instance AWS CLI operasi dengan parameter berikut untuk membuat instance utama untuk cluster Anda.

--db-instance-class — Diperlukan. Kapasitas komputasi dan memori instans, misalnya, db.m4.large. Tidak semua kelas instans tersedia di semua Wilayah AWS.
--db-instance-identifier — Diperlukan. Sebuah string yang mengidentifikasi instans.

Kendala Penamaan Instans:
- Panjangnya adalah [1—63] huruf, angka, atau tanda hubung.
- Karakter pertama harus berupa huruf.
- Tidak dapat diakhiri dengan tanda hubung atau berisi dua tanda hubung berurutan.
- Harus unik untuk semua instans di Amazon RDS, Neptunus, dan Amazon DocumentDB per, per Wilayah. Akun AWS
--engine — Diperlukan. Harus berupa docdb.
--availability-zone — Opsional. Availability Zone tempat Anda ingin membuat instans ini. Gunakan parameter ini untuk menemukan instans Anda di Availability Zone yang berbeda untuk meningkatkan toleransi kesalahan. Untuk informasi selengkapnya, lihat Ketersediaan Tinggi dan Replikasi Amazon DocumentDB.
--promotion-tier — Opsional. Tingkat prioritas failover untuk instans ini. Harus antara 0 dan 15 dengan angka yang lebih rendah menjadi prioritas yang lebih tinggi. Untuk informasi selengkapnya, lihat Mengontrol Target Failover.

Pertama, tentukan Availability Zone tempat Anda dapat membuat instance.

Jika Anda ingin menentukan Availability Zone sebelum membuat instans, jalankan perintah berikut untuk menentukan Availability Zone mana yang tersedia untuk klaster Amazon DocumentDB Anda.

Untuk Linux, macOS, atau Unix:


aws docdb describe-db-clusters \
       --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

Untuk Windows:


aws docdb describe-db-clusters ^
       --query 'DBClusters[*].[DBClusterIdentifier,AvailabilityZones[*]]'

Output dari operasi ini terlihat seperti berikut.


[
    [
        "sample-cluster",
        [
            "us-east-1c",
            "us-east-1b",
            "us-east-1a"
        ]
    ]
]

Kedua, tentukan kelas instance apa yang dapat Anda buat di Wilayah Anda.

Untuk menentukan kelas instans mana yang tersedia untuk Anda di Wilayah Anda, jalankan perintah berikut. Dari output, pilih kelas instans untuk instans yang ingin Anda tambahkan ke klaster Amazon DocumentDB Anda.

Untuk Linux, macOS, atau Unix:


aws docdb describe-orderable-db-instance-options \
        --engine docdb \
        --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

Untuk Windows:


aws docdb describe-orderable-db-instance-options ^
        --engine docdb ^
        --query 'OrderableDBInstanceOptions[*].DBInstanceClass'

Output dari operasi ini terlihat seperti berikut.


[
    "db.r5.16xlarge",
    "db.r5.2xlarge",
    "db.r5.4xlarge",
    "db.r5.8xlarge",
    "db.r5.large",
    "db.r5.xlarge"
]

Terakhir, tambahkan instance ke cluster Amazon DocumentDB Anda.

Untuk menambahkan instans ke klaster Amazon DocumentDB Anda, jalankan perintah berikut..

Untuk Linux, macOS, atau Unix:


aws docdb create-db-instance \
       --db-cluster-identifier sample-cluster \
       --db-instance-identifier sample-instance-2 \
       --availability-zone us-east-1b \
       --promotion-tier 2 \
       --db-instance-class db.r5.xlarge \
       --engine docdb

Untuk Windows:


aws docdb create-db-instance ^
       --db-cluster-identifier sample-cluster ^
       --db-instance-identifier sample-instance-2 ^
       --availability-zone us-east-1b ^
       --promotion-tier 2 ^
       --db-instance-class db.r5.xlarge ^
       --engine docdb

Output dari operasi ini terlihat seperti berikut.


{
    "DBInstance": {
        "DBInstanceIdentifier": "sample-instance-2",
        "DBInstanceClass": "db.r5.xlarge",
        "Engine": "docdb",
        "DBInstanceStatus": "creating",
        "PreferredBackupWindow": "02:00-02:30",
        "BackupRetentionPeriod": 1,
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-abcd0123",
                "Status": "active"
            }
        ],
        "AvailabilityZone": "us-east-1b",
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-6242c31a",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-abcd0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2a"
                    },
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-wxyz0123",
                    "SubnetAvailabilityZone": {
                        "Name": "us-west-2b"
                    },
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sun:11:35-sun:12:05",
        "PendingModifiedValues": {},
        "EngineVersion": "3.6.0",
        "AutoMinorVersionUpgrade": true,
        "PubliclyAccessible": false,
        "DBClusterIdentifier": "sample-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-east-1:<accountID>:key/sample-key",
        "DbiResourceId": "db-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
        "CACertificateIdentifier": "rds-ca-2019",
        "PromotionTier": 2,
        "DBInstanceArn": "arn:aws:rds:us-east-1:<accountID>:db:sample-instance-2"
    }
}

Dibutuhkan beberapa menit untuk membuat instans. Anda dapat menggunakan konsol atau AWS CLI untuk melihat status instans. Untuk informasi selengkapnya, lihat Memantau Status instans Amazon DocumentDB.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Siklus hidup instans

Menjelaskan contoh

Menambahkan instance Amazon DocumentDB ke cluster

Tip