Expansión de la cantidad de agentes en un clúster de Amazon MSK - Transmisión administrada de Amazon para Apache Kafka

Expansión de la cantidad de agentes en un clúster de Amazon MSK

Utilice esta operación de Amazon MSK cuando quiera aumentar el número de agentes en el clúster de MSK. Para ampliar un clúster, asegúrese de que está en el estado ACTIVE.

importante

Si quiere expandir un clúster de MSK, asegúrese de utilizar esta operación de Amazon MSK. No intente agregar agentes a un clúster sin usar esta operación.

Para obtener información acerca de cómo volver a equilibrar particiones después de agregar agentes a un clúster, consulte Reasignar particiones.

Expansión de un clúster de Amazon MSK mediante la Consola de administración de AWS

Este proceso describe cómo aumentar el número de agentes en un clúster de Amazon MSK mediante la Consola de administración de AWS.

  1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon MSK en https://console.aws.amazon.com/msk/home?region=us-east-1#/home/.

  2. Elija el clúster de MSK para aumentar su número de agentes.

  3. En el menú desplegable Acciones, elija Editar número de agentes.

  4. Introduzca el número de agentes que quiere que tenga el clúster por zona de disponibilidad y, luego, elija Guardar cambios.

Expansión de un clúster de Amazon MSK mediante la AWS CLI

Este proceso describe cómo aumentar el número de agentes en un clúster de Amazon MSK mediante la AWS CLI.

  1. Ejecute el siguiente comando, reemplazando clusterArn por el nombre de recurso de Amazon (ARN) que obtuvo al crear el clúster. Si no tiene el ARN para su clúster, puede encontrarlo enumerando todos los clústeres. Para obtener más información, consulte Enumeración de clústeres de Amazon MSK.

    Reemplace Current Cluster-Version con la versión actual del clúster.

    importante

    Las versiones de clúster no son enteros simples. Para buscar la versión actual del clúster, utilice la operación DescribeCluster o el comando describe-cluster de la AWS CLI. Un ejemplo de ID de versión es KTVPDKIKX0DER.

    El parámetro Target-Number-of-Brokers representa el número total de nodos de agente que desea que tenga el clúster cuando esta operación se complete correctamente. El valor que especifique para Target-Number-of-Brokers debe ser un número entero mayor que el número actual de agentes en el clúster. También debe ser un múltiplo del número de zonas de disponibilidad.

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

    El resultado de esta operación update-broker-count se parece al siguiente 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 obtener el resultado de la operación update-broker-count, ejecute el siguiente comando, reemplazando ClusterOperationArn por el ARN que obtuvo en la salida del comando update-broker-count.

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

    El resultado de este comando describe-cluster-operation tendrá un aspecto similar al siguiente.

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

    En esta salida, OperationType es INCREASE_BROKER_COUNT. Si OperationState tiene el valor UPDATE_IN_PROGRESS, espere un rato y vuelva a ejecutar el comando describe-cluster-operation.

Expansión de un clúster de Amazon MSK mediante la API

Para aumentar el número de agentes en un clúster mediante la API, vea UpdateBrokerCount.