Disponibilidad del agente Actualización de la configuración de un clúster mediante 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 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 en el 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 soluciono los problemas al actualizar mi clúster de Amazon MSK?

Actualización de la configuración de un clúster mediante 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 sustitúyalo 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.