Expandir um cluster do Amazon MSK

Execute esta operação do Amazon MSK quando você quiser aumentar o número de agentes em seu cluster do MSK. Para expandir um cluster, certifique-se de que ele esteja no estado ACTIVE.

Importante

Certifique-se de usar esta operação do Amazon MSK se quiser expandir um cluster do MSK. Não tente adicionar agentes a um cluster sem usar essa operação.

Para obter informações sobre como reequilibrar partições depois de adicionar agentes a um cluster, consulte Reatribuir partições.

Expandir um cluster usando o AWS Management Console

1. Abra o console do Amazon MSK em https://console.aws.amazon.com/msk/.

2. Escolha o cluster do MSK cujo número de agentes deseja aumentar.

3. Na página de detalhes do cluster, escolha o botão Editar ao lado do cabeçalho Detalhes do agente no nível de cluster.

4. Insira o número de agentes que você deseja que o cluster tenha por zona de disponibilidade e escolha Salvar alterações.

Expandir um cluster usando o AWS CLI

1. Execute o comando a seguir, ClusterArnsubstituindo-o pelo Amazon Resource Name (ARN) que você obteve ao criar seu cluster. Se você não tiver o ARN do cluster, poderá encontrá-lo listando todos os clusters. Para ter mais informações, consulte Listar clusters do Amazon MSK.

   Substitua Current-Cluster-Version pela versão atual do cluster.

   Importante

   As versões de cluster não são inteiros simples. Para encontrar a versão atual do cluster, use a DescribeClusteroperação ou o comando AWS CLI describe-cluster. Uma versão de exemplo é KTVPDKIKX0DER.

   O parâmetro Target-Number-of-Brokers representa o número total de nós de agente que você deseja que o cluster tenha quando essa operação for concluída com êxito. O valor especificado para Target-Number-of-Brokers deve ser um número inteiro maior do que o número atual de agentes no cluster. Também deve ser um múltiplo do número de zonas de disponibilidade.

   aws kafka update-broker-count --cluster-arn ClusterArn --current-version Current-Cluster-Version --target-number-of-broker-nodes Target-Number-of-Brokers

   A saída dessa operação update-broker-count é semelhante ao seguinte 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"
   }

2. Para obter o resultado da update-broker-count operação, execute o comando a seguir, substituindo ClusterOperationArn pelo ARN obtido na saída do update-broker-count comando.

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

   A saída desse comando describe-cluster-operation é semelhante ao seguinte JSON de exemplo.

   {
       "ClusterOperationInfo": {
           "ClientRequestId": "c0b7af47-8591-45b5-9c0c-909a1a2c99ea",
           "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
           "CreationTime": "2019-09-25T23:48:04.794Z",
           "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": "INCREASE_BROKER_COUNT",
           "SourceClusterInfo": {
               "NumberOfBrokerNodes": 9
           },
           "TargetClusterInfo": {
               "NumberOfBrokerNodes": 12
           }
       }
   }

   Nesta saída, OperationType é INCREASE_BROKER_COUNT. Se OperationState tiver o valor UPDATE_IN_PROGRESS, aguarde um pouco e execute o comando describe-cluster-operation novamente.

Expandir um cluster usando a API

Para aumentar o número de corretores em um cluster usando a API, consulte UpdateBrokerCount.