Aggiornamento della configurazione di un cluster Amazon MSK

Per aggiornare la configurazione di un cluster, assicurati che lo stato del cluster sia ACTIVE. È inoltre necessario assicurarsi che il numero di partizioni per broker sul cluster MSK sia inferiore ai limiti descritti in. Dimensiona correttamente il tuo cluster: numero di partizioni per broker Non è possibile aggiornare la configurazione di un cluster che supera questi limiti.

Per informazioni sulla configurazione MSK, incluso come creare una configurazione personalizzata, quali proprietà è possibile aggiornare e cosa accade quando si aggiorna la configurazione di un cluster esistente, consulta Configurazione Amazon MSK.

Aggiornamento della configurazione di un cluster utilizzando AWS CLI

1. Copiare il JSON seguente e salvarlo in un file. Assegnare un nome al file configuration-info.json. Sostituisci ConfigurationArncon il nome della risorsa Amazon (ARN) che desideri utilizzare per aggiornare il cluster. La stringa ARN deve essere racchiusa tra virgolette nel seguente JSON.

   Sostituisci Configuration-Revision con la revisione della configurazione che desideri utilizzare. Le revisioni di configurazione sono interi (numeri interi) che iniziano da 1. Questo intero non deve essere racchiuso tra virgolette nel seguente JSON.

   {
        "Arn": ConfigurationArn,
        "Revision": Configuration-Revision
   }

2. Esegui il comando seguente, sostituendolo ClusterArncon l'ARN ottenuto durante la creazione del cluster. Se non disponi dell'ARN per il cluster, puoi trovarlo elencando tutti i cluster. Per ulteriori informazioni, consulta Visualizzazione dei cluster Amazon MSK.

   Sostituisci Path-to-Config-Info-File con il percorso del file delle informazioni di configurazione. Se il file creato nella fase precedente è stato denominato configuration-info.json e salvato nella directory corrente, Path-to-Config-Info-File è configuration-info.json.

   Sostituisci Current-Cluster-Version con la versione corrente del cluster.

   Importante

   Le versioni del cluster non sono interi semplici. Per trovare la versione corrente del cluster, usa l'DescribeClusteroperazione o il comando AWS CLIdescribe-cluster. Una versione di esempio è KTVPDKIKX0DER.

   aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version

   Di seguito è riportato un esempio di come utilizzare questo comando:

   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"

   L'output di questo comando update-cluster-configuration è simile all'esempio JSON seguente.

   {
       "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"
   }

3. Per ottenere il risultato dell'update-cluster-configurationoperazione, esegui il comando seguente, sostituendolo ClusterOperationArncon l'ARN ottenuto nell'output del update-cluster-configuration comando.

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

   L'output di questo comando describe-cluster-operation è simile all'esempio JSON seguente.

   {
       "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
               }
           }
       }
   }

   In questo output, OperationType è UPDATE_CLUSTER_CONFIGURATION. Se il valore di OperationState è UPDATE_IN_PROGRESS, attendi qualche minuto, quindi esegui nuovamente il comando describe-cluster-operation.

Aggiornamento della configurazione di un cluster mediante l'API

Per utilizzare l'API per aggiornare la configurazione di un cluster, vedere UpdateClusterConfiguration.