Disponibilidad de los corredores Actualización de la configuración de un clúster mediante el AWS CLI Actualice la configuración del clúster mediante la API

Actualización de la configuración de un clúster de Amazon MSK

Para actualizar la configuración de un clúster, asegúrese de que el clúster está en el estado ACTIVE. También debe asegurarse de que el número de particiones por agente en el clúster de MSK esté por debajo de los límites descritos en Asigne el tamaño correcto a su clúster: número de particiones por agente estándar. No puede actualizar la configuración de un clúster que supere estos límites.

Para obtener información acerca de la configuración de MSK, incluido cómo crear una configuración personalizada, qué propiedades puede actualizar y qué sucede al actualizar la configuración de un clúster existente, consulte Configuración aprovisionada de Amazon MSK.

Temas

Disponibilidad del bróker durante las actualizaciones de configuración
Actualización de la configuración de un clúster mediante el AWS CLI
Actualización de la configuración de un clúster de Amazon MSK mediante la API

Disponibilidad del bróker durante las actualizaciones de configuración

Amazon MSK mantiene una alta disponibilidad durante la mayoría de las actualizaciones de configuración de clústeres. Amazon MSK realiza una actualización progresiva en la que actualiza un bróker a la vez. Durante este proceso, el clúster permanece disponible, aunque los corredores individuales se reiniciarán a medida que se actualicen sus configuraciones. Sin embargo, algunos cambios de configuración pueden requerir que todos los corredores se actualicen simultáneamente, lo que puede provocar una breve interrupción en todo el clúster. Para obtener más información sobre el impacto en la disponibilidad de los corredores durante las actualizaciones, consulte. Configuración aprovisionada de Amazon MSK

Antes de actualizar los clústeres de producción, le recomendamos que pruebe los cambios de configuración en un entorno que no sea de producción y que programe las actualizaciones durante los períodos de mantenimiento.

Si tiene algún problema al actualizar su clúster de MSK, consulte ¿Cómo puedo solucionar problemas al actualizar mi clúster de Amazon MSK?

Actualización de la configuración de un clúster mediante el AWS CLI

Copie el siguiente JSON y guárdelo en un archivo. Nombre el archivo configuration-info.json. ConfigurationArnSustitúyalo por el nombre de recurso de Amazon (ARN) de la configuración que quieres usar para actualizar el clúster. La cadena ARN debe estar entre comillas en el siguiente JSON.

Configuration-RevisionSustitúyalo por la revisión de la configuración que desee usar. Las revisiones de configuración son enteros (números enteros) que comienzan por 1. Este entero no debe estar entre comillas en el siguiente JSON.
```
{
     "Arn": ConfigurationArn,
     "Revision": Configuration-Revision
}
```
Ejecute el siguiente comando y ClusterArn reemplácelo por el 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.

Path-to-Config-Info-FileSustitúyalo por la ruta al archivo de información de configuración. Si asignó un nombre al archivo que creó en el paso anterior configuration-info.json y lo guardó en el directorio actual, entonces Path-to-Config-Info-File esconfiguration-info.json.

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 DescribeClusteroperación o el comando AWS CLI describe-cluster. Un ejemplo de ID de versión es KTVPDKIKX0DER.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
A continuación, se muestra un ejemplo de cómo utilizar este 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"
```
El resultado de este comando update-cluster-configuration tendrá un aspecto similar al siguiente.
```
{
    "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"
}
```

Para obtener el resultado de la update-cluster-configuration operación, ejecute el siguiente comando y ClusterOperationArn reemplácelo por el ARN que obtuvo en el resultado del update-cluster-configuration comando.


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

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