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

Memperbarui konfigurasi cluster Amazon MSK

Untuk memperbarui konfigurasi cluster, pastikan cluster berada dalam ACTIVE status. Anda juga harus memastikan bahwa jumlah partisi per broker di cluster MSK Anda berada di bawah batas yang dijelaskan diRight-size cluster Anda: Jumlah partisi per broker Standar. Anda tidak dapat memperbarui konfigurasi cluster 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 cluster yang ada, lihatKonfigurasi Amazon MSK yang disediakan.

Topik

Ketersediaan broker selama pembaruan konfigurasi
Memperbarui konfigurasi cluster menggunakan AWS CLI
Memperbarui konfigurasi cluster Amazon MSK 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 ulang saat konfigurasi mereka diperbarui. Namun, beberapa perubahan konfigurasi mungkin memerlukan semua broker untuk 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, sebaiknya Anda menguji perubahan konfigurasi di lingkungan non-produksi dan menjadwalkan pembaruan selama jendela pemeliharaan Anda.

Jika Anda menghadapi masalah saat memutakhirkan cluster MSK, lihat Bagaimana cara memecahkan masalah saat memutakhirkan cluster Amazon MSK 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 dalam JSON berikut.

Ganti Configuration-Revision dengan revisi konfigurasi yang ingin Anda gunakan. Revisi konfigurasi adalah bilangan bulat (bilangan bulat) yang dimulai pada. 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 ketika Anda membuat cluster Anda. Jika Anda tidak memiliki ARN untuk cluster Anda, Anda dapat menemukannya dengan mencantumkan semua cluster. Untuk informasi selengkapnya, lihat Daftar cluster Amazon MSK.

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 bukanlah bilangan bulat sederhana. Untuk menemukan versi cluster saat ini, gunakan DescribeCluster operasi atau perintah describe-cluster AWS CLI . 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 update-cluster-configuration perintah.


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.