Aggiornamento della configurazione di un MSK cluster Amazon - Amazon Managed Streaming per Apache Kafka

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Aggiornamento della configurazione di un MSK cluster Amazon

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 MSK cluster sia inferiore ai limiti descritti in Dimensionamento corretto del cluster: numero di partizioni per broker. Non è possibile aggiornare la configurazione di un cluster che supera questi limiti.

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

Aggiornamento della configurazione di un cluster utilizzando AWS CLI

  1. Copia quanto segue JSON e salvalo in un file. Assegnare un nome al file configuration-info.json. Replace (Sostituisci) ConfigurationArn con l'Amazon Resource Name (ARN) della configurazione che desideri utilizzare per aggiornare il cluster. La ARN stringa deve essere racchiusa tra virgolette di seguitoJSON.

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

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

  2. Esegui il comando seguente, sostituendo ClusterArn con quello ARN che hai ottenuto quando hai creato il cluster. Se non ne possiedi uno ARN per il tuo cluster, puoi trovarlo elencando tutti i cluster. Per ulteriori informazioni, consulta Elencazione dei MSK cluster Amazon.

    Replace (Sostituisci) Path-to-Config-Info-File con il percorso del file di informazioni di configurazione. Se hai dato un nome al file creato nel passaggio precedente configuration-info.json e lo hai salvato nella directory corrente, Path-to-Config-Info-File èconfiguration-info.json.

    Replace (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 CLI describe-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 update-cluster-configuration comando è simile all'esempio seguente. JSON

    { "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, sostituendo ClusterOperationArn con quello ARN che hai ottenuto nell'output del update-cluster-configuration comando.

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

    L'output di questo describe-cluster-operation comando è simile all'JSONesempio 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 utilizzando il API

Per utilizzare l'APIaggiornamento della configurazione di un cluster, vedere UpdateClusterConfiguration.