Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Perbarui konfigurasi cluster MSK Amazon
Untuk memperbarui konfigurasi cluster, pastikan bahwa cluster 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](bestpractices.md#partitions-per-broker) 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, lihat[Konfigurasi Amazon MSK yang disediakan](msk-configuration.md).
**Topics**
+ [Ketersediaan broker selama pembaruan konfigurasi](#update-config-cluster-availability)
+ [Memperbarui konfigurasi cluster menggunakan AWS CLI](#update-config-cli)
+ [Perbarui konfigurasi kluster MSK Amazon menggunakan API](#update-config-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, lihat[Konfigurasi Amazon MSK yang disediakan](msk-configuration.md).
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 kluster MSK Amazon saya?](https://repost.aws/knowledge-center/msk-upgrade-cluster-issues)
## Memperbarui konfigurasi cluster menggunakan AWS CLI
1. Salin JSON berikut dan simpan ke file. Beri nama file`configuration-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}}
}
```
1. 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](msk-list-clusters.md).
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}} adalah`configuration-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 [DescribeCluster](https://docs.aws.amazon.com/msk/1.0/apireference/clusters-clusterarn.html#DescribeCluster)operasi atau [perintah AWS CLI deskripsi-cluster](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kafka/describe-cluster.html). Contoh versi adalah`KTVPDKIKX0DER`.
```
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"
}
```
1. 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` adalah`UPDATE_CLUSTER_CONFIGURATION`. Jika `OperationState` memiliki nilai`UPDATE_IN_PROGRESS`, tunggu sebentar, lalu jalankan `describe-cluster-operation` perintah lagi.
## Perbarui konfigurasi kluster MSK Amazon menggunakan API
Untuk menggunakan API untuk memperbarui konfigurasi kluster MSK Amazon, lihat [UpdateClusterConfiguration](https://docs.aws.amazon.com//msk/1.0/apireference/clusters-clusterarn-configuration.html#UpdateClusterConfiguration).