Mengelola cluster elastis - Amazon DocumentDB

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengelola cluster elastis

Untuk mengelola klaster elastis Amazon DocumentDB, Anda harus memiliki IAM kebijakan dengan izin bidang kontrol Amazon DocumentDB yang sesuai. Izin ini memungkinkan Anda untuk membuat, memodifikasi, dan menghapus cluster. Kebijakan Amazon D ocumentDBFull Access menyediakan semua izin yang diperlukan untuk mengelola klaster elastis Amazon DocumentDB.

Topik berikut menunjukkan cara melakukan berbagai tugas saat bekerja dengan cluster elastis Amazon DocumentDB.

Memodifikasi konfigurasi cluster elastis

Pada bagian ini kami menjelaskan cara memodifikasi cluster elastis, menggunakan AWS Management Console atau AWS CLI dengan instruksi berikut.

Penggunaan utama memodifikasi cluster adalah untuk menskalakan pecahan dengan meningkatkan atau mengurangi jumlah pecahan dan/atau kapasitas komputasi pecahan.

Using the AWS Management Console

Untuk memodifikasi konfigurasi cluster elastis menggunakan AWS Management Console:

  1. Masuk ke AWS Management Consoledan buka konsol Amazon DocumentDB.

  2. Pada panel navigasi, silakan pilih Klaster.

    Tip

    Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.

  3. Pilih nama cluster yang ingin Anda ubah di kolom pengenal Cluster.

  4. Pilih Ubah.

  5. Edit bidang yang ingin diubah lalu pilih Modify cluster.

    Diagram: modifikasi cluster elastis
catatan

Atau, Anda dapat mengakses dialog Modify cluster dengan membuka halaman Clusters, mencentang kotak di sebelah cluster Anda, memilih Actions, lalu Modify.

Using the AWS CLI

Untuk memodifikasi konfigurasi cluster elastis menggunakan AWS CLI, gunakan update-cluster operasi dengan parameter berikut:

  • --cluster-arn—Wajib. ARNPengidentifikasi cluster yang ingin Anda modifikasi.

  • --shard-capacity—Opsional. Jumlah yang vCPUs ditugaskan untuk setiap pecahan. Maksimal adalah 64. Nilai yang diizinkan adalah 2, 4, 8, 16, 32, 64.

  • --shard-count—Opsional. Jumlah pecahan yang ditugaskan ke cluster. Maksimal adalah 32.

  • --shard-instance-Hitung—opsional. Jumlah contoh replika yang diterapkan ke semua pecahan di cluster ini. Maksimal adalah 16.

  • --auth-type—Opsional. Jenis otentikasi yang digunakan untuk menentukan di mana untuk mengambil password yang digunakan untuk mengakses cluster elastis. Jenis yang valid adalah PLAIN_TEXT atauSECRET_ARN.

  • --admin-user-password—Opsional. Kata sandi yang terkait dengan pengguna admin.

  • --vpc-security-group-ids—Opsional. Konfigurasikan daftar grup keamanan Amazon EC2 dan Amazon Virtual Private Cloud (VPC) untuk diasosiasikan dengan klaster ini.

  • --preferred-maintenance-window—Opsional. Konfigurasikan rentang waktu mingguan selama pemeliharaan sistem dapat terjadi, dalam Waktu Terkoordinasi Universal () UTC

    Formatnya adalah:ddd:hh24:mi-ddd:hh24:mi. Hari yang berlaku (ddd): Senin, Sel, Rabu, Kam, Jum, Sabtu, Minggu

    Defaultnya adalah jendela 30 menit yang dipilih secara acak dari blok waktu 8 jam untuk setiap Wilayah Amazon Web Services, yang terjadi pada hari acak dalam seminggu.

    Jendela minimal 30 menit.

  • --subnet-ids—Opsional. Konfigurasikan ID subnet jaringan.

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Untuk Linux, macOS, atau Unix:

aws docdb-elastic update-cluster \ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 \ --shard-capacity 8 \ --shard-count 4 \ --shard-instance-count 3 \ --admin-user-password testPassword \ --vpc-security-group-ids ec-65f40350 \ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Untuk Windows:

aws docdb-elastic update-cluster ^ --cluster-arn arn:aws:docdb-elastic:us-east-1:477568257630:cluster/b9f1d489-6c3e-4764-bb42-da62ceb7bda2 ^ --shard-capacity 8 ^ --shard-count 4 ^ --shard-instance-count 3 ^ --admin-user-password testPassword ^ --vpc-security-group-ids ec-65f40350 ^ --subnet-ids subnet-9253c6a3, subnet-9f1b5af9

Untuk memantau status cluster elastis setelah modifikasi Anda, lihat Memantau cluster elastis.

Memantau cluster elastis

Pada bagian ini, kami menjelaskan cara memantau cluster elastis Anda, menggunakan AWS Management Console atau AWS CLI dengan instruksi berikut.

Using the AWS Management Console

Untuk memantau konfigurasi cluster elastis menggunakan AWS Management Console:

  1. Masuk ke AWS Management Consoledan buka konsol Amazon DocumentDB.

  2. Pada panel navigasi, silakan pilih Klaster.

    Tip

    Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.

  3. Pilih nama cluster yang ingin Anda pantau di kolom pengenal Cluster.

  4. Pilih tab Pemantauan.

    Diagram: pemantauan cluster elastis

Sejumlah grafik dari Amazon CloudWatch ditampilkan untuk kategori pemantauan berikut:

  • Pemanfaatan Sumber Daya

  • Throughput

  • Latensi

  • Operasi

  • Sistem

Anda juga dapat mengakses Amazon CloudWatch melalui AWS Management Console untuk mengatur lingkungan pemantauan Anda sendiri untuk cluster elastis Anda.

Using the AWS CLI

Untuk memantau konfigurasi cluster elastis tertentu menggunakan AWS CLI, gunakan get-cluster operasi dengan parameter berikut:

  • --cluster-arn—Wajib. ARNPengidentifikasi cluster yang Anda inginkan informasinya.

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Untuk Linux, macOS, atau Unix:

aws docdb-elastic get-cluster \ --cluster-arn arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

Untuk Windows:

aws docdb-elastic get-cluster ^ --cluster-arn arn:aws:docdb:-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9

Output dari operasi ini terlihat seperti berikut:

"cluster": { ... "clusterArn": "arn:aws:docdb-elastic:us-west-2:123456789012:cluster:/68ffcdf8-e3af-40a3-91e4-24736f2dacc9", "clusterEndpoint": "stretch-11-477568257630.us-east-1.docdb-elastic.amazonaws.com", "readerEndpoint": "stretch-11-477568257630-ro.us-east-1.docdb-elastic.amazonaws.com", "clusterName": "stretch-11", "shardCapacity": 2, "shardCount": 3, "shardInstanceCount: 5, "status": "ACTIVE", ... }

Untuk informasi selengkapnya, lihat DescribeClusterSnapshot di Referensi Manajemen Sumber Daya Amazon DocumentDB. API

Untuk melihat rincian semua cluster elastis menggunakan AWS CLI, gunakan list-clusters operasi dengan parameter berikut:

  • --next-token—Opsional. Jika jumlah item output (--max-results) lebih sedikit dari jumlah total item yang dikembalikan oleh API panggilan yang mendasarinya, output termasuk NextToken yang dapat Anda teruskan ke perintah berikutnya untuk mengambil set item berikutnya.

  • --max-results—Opsional. Jumlah total item yang akan dikembalikan dalam output perintah. Jika lebih banyak hasil yang ada daripada max-results nilai yang ditentukan, token pagination (next-token) disertakan dalam respons sehingga hasil yang tersisa dapat diambil.

    • Default: 100

    • Minimum 20, maksimum 100

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Untuk Linux, macOS, atau Unix:

aws docdb-elastic list-clusters \ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== \ --max-results 2

Untuk Windows:

aws docdb-elastic list-clusters ^ --next-token eyJNYXJrZXIiOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAxfQ== ^ --max-results 2

Output dari operasi ini terlihat seperti berikut:

{ "Clusters": [ { "ClusterIdentifier":"mycluster-1", "ClusterArn":"arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } { "ClusterIdentifier":"mycluster-2", "ClusterArn":"arn:aws:docdb:us-west-2:987654321098:sharded-cluster:sample-cluster" "Status":"available", "ClusterEndpoint":"sample-cluster2.sharded-cluster-corcjozrlsfc.us-west-2.docdb.amazonaws.com" } ] }

Menghapus cluster elastis

Pada bagian ini kami menjelaskan cara menghapus cluster elastis, menggunakan AWS Management Console atau AWS CLI dengan instruksi berikut.

Using the AWS Management Console

Untuk menghapus konfigurasi cluster elastis menggunakan AWS Management Console:

  1. Masuk ke AWS Management Consoledan buka konsol Amazon DocumentDB.

  2. Pada panel navigasi, silakan pilih Klaster.

    Tip

    Jika Anda tidak melihat panel navigasi di sisi kiri layar, pilih ikon menu di sudut kiri atas panel navigasi.

  3. Dalam tabel daftar cluster, pilih kotak centang di sebelah kiri nama cluster yang ingin Anda hapus lalu pilih Tindakan. Dari menu pilihan menurun, pilih Hapus.

  4. Di cluster elastis Delete “cluster-name”? kotak dialog, pilih Hapus.

    Diagram: modifikasi cluster elastis

Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat Memantau Status Cluster Amazon DocumentDB.

Using the AWS CLI

Untuk menghapus cluster elastis menggunakan AWS CLI, gunakan delete-cluster operasi dengan parameter berikut:

  • --cluster-arn—Wajib. ARNPengidentifikasi cluster yang ingin Anda hapus.

  • --no-skip-final-backup—Opsional. Jika Anda menginginkan cadangan akhir, Anda harus menyertakan parameter ini dengan nama untuk cadangan akhir. Anda harus menyertakan --final-backup-identifier atau --skip-final-backup.

  • --skip-final-backup—Opsional. Gunakan parameter ini hanya jika Anda tidak ingin mengambil cadangan akhir sebelum menghapus klaster Anda. Pengaturan default adalah untuk mengambil snapshot akhir.

Contoh AWS CLI kode berikut menghapus cluster dengan arn:aws:docdb:us-west- ARN 2:123456789012:sharded-cluster:sample-cluster dengan cadangan akhir.

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri..

Untuk Linux, macOS, atau Unix:

aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --no-skip-final-backup \ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Untuk Windows:

aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --no-skip-final-backup ^ --final-backup-identifier finalArnBU-arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster

Contoh AWS CLI kode berikut menghapus cluster dengan arn:aws:docdb:us-west- ARN 2:123456789012:sharded-cluster:sample-cluster tanpa mengambil cadangan akhir.

Dalam contoh berikut, ganti masing-masing user input placeholder dengan informasi Anda sendiri.

Untuk Linux, macOS, atau Unix:

aws docdb-elastic delete-cluster \ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster \ --skip-final-backup \

Untuk Windows:

aws docdb-elastic delete-cluster ^ --cluster-arn arn:aws:docdb:us-west-2:123456789012:sharded-cluster:sample-cluster ^ --skip-final-backup ^

Output dari delete-cluster operasi adalah tampilan cluster yang Anda hapus.

Dibutuhkan beberapa menit untuk menghapus klaster. Untuk memantau status klaster, lihat Memantau Status Cluster Amazon DocumentDB.