Ketersediaan broker Memperbarui konfigurasi cluster menggunakan AWS CLI Perbarui konfigurasi cluster menggunakan API

Perbarui konfigurasi kluster MSK Amazon

Untuk memperbarui konfigurasi cluster, pastikan klaster berada dalam ACTIVE status. Anda juga harus memastikan bahwa jumlah partisi per broker di klaster MSK Anda berada di bawah batas yang dijelaskan dalam. Ukuran kluster Anda dengan benar: Jumlah partisi per pialang Standar Anda tidak dapat memperbarui konfigurasi klaster yang melebihi batas ini.

Untuk informasi tentang konfigurasi MSK, termasuk cara membuat konfigurasi kustom, properti mana yang dapat Anda perbarui, dan apa yang terjadi ketika Anda memperbarui konfigurasi klaster yang ada, lihatKonfigurasi Amazon MSK yang disediakan.

Topik

Ketersediaan broker selama pembaruan konfigurasi
Memperbarui konfigurasi cluster menggunakan AWS CLI
Perbarui konfigurasi kluster MSK Amazon menggunakan API

Ketersediaan broker selama pembaruan konfigurasi

Amazon MSK mempertahankan ketersediaan tinggi selama sebagian besar pembaruan konfigurasi cluster. Amazon MSK melakukan pembaruan bergulir di mana ia memperbarui satu broker pada satu waktu. Selama proses ini, cluster tetap tersedia, meskipun broker individu akan memulai kembali saat konfigurasi mereka diperbarui. Namun, beberapa perubahan konfigurasi mungkin mengharuskan semua broker diperbarui secara bersamaan, yang dapat menyebabkan pemadaman singkat di seluruh cluster. Untuk informasi selengkapnya tentang dampak ketersediaan broker selama pembaruan, lihatKonfigurasi Amazon MSK yang disediakan.

Sebelum memperbarui cluster produksi, kami sarankan Anda menguji perubahan konfigurasi Anda di lingkungan non-produksi dan menjadwalkan pembaruan selama jendela pemeliharaan Anda.

Jika Anda menghadapi masalah saat memutakhirkan kluster MSK Anda, lihat Bagaimana cara memecahkan masalah saat memutakhirkan klaster MSK Amazon saya?

Memperbarui konfigurasi cluster menggunakan AWS CLI

Salin JSON berikut dan simpan ke file. Beri nama fileconfiguration-info.json. Ganti ConfigurationArn dengan Amazon Resource Name (ARN) dari konfigurasi yang ingin Anda gunakan untuk memperbarui cluster. String ARN harus dalam tanda kutip di JSON berikut.

Ganti Configuration-Revision dengan revisi konfigurasi yang ingin Anda gunakan. Revisi konfigurasi adalah bilangan bulat (bilangan bulat) yang dimulai dari. 1 Bilangan bulat ini tidak boleh dalam tanda kutip di JSON berikut.
```
{
     "Arn": ConfigurationArn,
     "Revision": Configuration-Revision
}
```
Jalankan perintah berikut, ganti ClusterArn dengan ARN yang Anda peroleh saat membuat cluster Anda. Jika Anda tidak memiliki ARN untuk cluster Anda, Anda dapat menemukannya dengan mencantumkan semua cluster. Untuk informasi selengkapnya, lihat Daftar kluster MSK Amazon.

Ganti Path-to-Config-Info-File dengan path ke file info konfigurasi Anda. Jika Anda menamai file yang Anda buat pada langkah sebelumnya configuration-info.json dan menyimpannya di direktori saat ini, maka Path-to-Config-Info-File adalahconfiguration-info.json.

Ganti Current-Cluster-Version dengan versi cluster saat ini.

penting
Versi cluster bukan bilangan bulat sederhana. Untuk menemukan versi cluster saat ini, gunakan DescribeClusteroperasi atau perintah AWS CLI deskripsi-cluster. Contoh versi adalahKTVPDKIKX0DER.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Berikut ini adalah contoh cara menggunakan perintah ini:
```
aws kafka update-cluster-configuration --cluster-arn "arn:aws:kafka:us-east-1:0123456789012:cluster/exampleName/abcd1234-0123-abcd-5678-1234abcd-1" --configuration-info file://c:\users\tester\msk\configuration-info.json --current-version "K1X5R6FKA87"
```
Output dari update-cluster-configuration perintah ini terlihat seperti contoh JSON berikut.
```
{
    "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
    "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}
```

Untuk mendapatkan hasil update-cluster-configuration operasi, jalankan perintah berikut, ganti ClusterOperationArn dengan ARN yang Anda peroleh dalam output perintah. update-cluster-configuration


aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

Output dari describe-cluster-operation perintah ini terlihat seperti contoh JSON berikut.


{
    "ClusterOperationInfo": {
        "ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
        "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
        "CreationTime": "2019-06-20T21:08:57.735Z",
        "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
        "OperationState": "UPDATE_COMPLETE",
        "OperationType": "UPDATE_CLUSTER_CONFIGURATION",
        "SourceClusterInfo": {},
        "TargetClusterInfo": {
            "ConfigurationInfo": {
                "Arn": "arn:aws:kafka:us-east-1:123456789012:configuration/ExampleConfigurationName/abcdabcd-abcd-1234-abcd-abcd123e8e8e-1",
                "Revision": 1
            }
        }
    }
}

Dalam output ini, OperationType adalahUPDATE_CLUSTER_CONFIGURATION. Jika OperationState memiliki nilaiUPDATE_IN_PROGRESS, tunggu sebentar, lalu jalankan describe-cluster-operation perintah lagi.