Disponibilidad del agente Actualización de la configuración de un clúster mediante la AWS CLI Actualización de 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 Dimensione correctamente el clúster: número de particiones por agente Standard. 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 de Amazon MSK aprovisionado.

Temas

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

Disponibilidad del agente durante las actualizaciones de configuración

Amazon MSK mantiene una alta disponibilidad durante la mayoría de las actualizaciones de configuración del clúster. Amazon MSK realiza una actualización gradual en la que actualiza un agente a la vez. Durante este proceso, el clúster permanece disponible, aunque los agentes individuales se reinician a medida que se actualizan sus configuraciones. Sin embargo, algunos cambios de configuración pueden requerir que todos los agentes se actualicen de forma simultánea, lo que puede provocar una breve interrupción a nivel de clúster. Para obtener más información sobre el impacto en la disponibilidad de los agentes durante las actualizaciones, consulte Configuración de Amazon MSK aprovisionado.

Antes de actualizar clústeres de producción, recomendamos probar los cambios de configuración en un entorno que no sea de producción y programar las actualizaciones durante los periodos de mantenimiento.

Si experimenta algún problema al actualizar el clúster de MSK, consulte Cómo solucionar problemas al actualizar el clúster de Amazon MSK

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

Copie el siguiente JSON y guárdelo en un archivo. Asigne el nombre al archivo configuration-info.json. Reemplace ConfigurationArn por el nombre de recurso de Amazon (ARN) de la configuración que desea utilizar para actualizar el clúster. La cadena ARN debe estar entre comillas en el siguiente JSON.

Reemplace Configuration-Revision con la revisión de la configuración que desea utilizar. 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, reemplazando ClusterArn 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.

Reemplace Path-to-Config-Info-File por la ruta de acceso al archivo de información de configuración. Si nombró el archivo que creó en el paso anterior configuration-info.json y lo guardó en el directorio actual, entonces Path-to-Config-Info-File es configuration-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 operación DescribeCluster o el comando describe-cluster de la AWS CLI. 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 operación update-cluster-configuration, ejecute el siguiente comando, reemplazando ClusterOperationArn por el ARN que obtuvo en la salida del comando update-cluster-configuration.


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.