Disponibilidade do agente Atualizar a configuração de um cluster usando a AWS CLI Atualizar a configuração de um cluster usando a API

Atualizar a configuração de um cluster do Amazon MSK

Para atualizar a configuração de um cluster, certifique-se de que ele esteja no estado ACTIVE. Você também deve garantir que o número de partições por agente em seu cluster do MSK esteja abaixo dos limites descritos em Dimensione seu cluster adequadamente: número de partições por agente Standard. Você não pode atualizar a configuração de um cluster que exceda esses limites.

Para obter informações sobre a configuração do MSK, incluindo como criar uma configuração personalizada, quais propriedades você pode atualizar e o que acontece quando você atualiza a configuração de um cluster existente, consulte Configurações do Amazon MSK Provisioned.

Tópicos

Disponibilidade do agente durante as atualizações de configuração
Atualizar a configuração de um cluster usando a AWS CLI
Atualizar a configuração de um cluster do Amazon MSK usando a API

Disponibilidade do agente durante as atualizações de configuração

O Amazon MSK mantém alta disponibilidade durante a maioria das atualizações de configuração do cluster. O Amazon MSK realiza uma atualização contínua em que atualiza um agente por vez. Durante esse processo, o cluster permanece disponível, embora os agentes individuais sejam reiniciados à medida que suas configurações forem atualizadas. No entanto, algumas alterações na configuração podem exigir que todos os agentes sejam atualizados simultaneamente, o que pode causar uma breve interrupção em todo o cluster. Para obter mais informações sobre o impacto na disponibilidade do agente durante as atualizações, consulteConfigurações do Amazon MSK Provisioned.

Antes de atualizar os clusters de produção, recomendamos que você teste suas alterações de configuração em um ambiente que não seja de produção e agende atualizações durante as janelas de manutenção.

Se você enfrentar algum problema ao atualizar seu cluster do MSK, consulte Como solucionar problemas ao atualizar meu cluster do Amazon MSK?

Atualizar a configuração de um cluster usando a AWS CLI

Copie o seguinte JSON e salve-o em um arquivo. Nomeie o arquivo configuration-info.json. Substitua ConfigurationArn pelo nome do recurso da Amazon (ARN) da configuração a usar para atualizar o cluster. A string do ARN deve estar entre aspas no seguinte JSON.

Substitua Configuration-Revision pela revisão da configuração que você deseja usar. As revisões de configuração são inteiros (números inteiros) que começam em 1. Esse número inteiro não deve estar entre aspas no seguinte JSON.
```
{
     "Arn": ConfigurationArn,
     "Revision": Configuration-Revision
}
```
Execute o seguinte comando, substituindo ClusterArn pelo ARN obtido quando criou o cluster. Se você não tiver o ARN do cluster, poderá encontrá-lo listando todos os clusters. Para obter mais informações, consulte Listar clusters do Amazon MSK.

Substitua Path-to-Config-Info-File pelo caminho para o arquivo de informações de sua configuração. Se você nomeou o arquivo que criou na etapa anterior configuration-info.json e o salvou no diretório atual, o Path-to-Config-Info-File será configuration-info.json.

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 operação DescribeCluster ou o comando describe-cluster da AWS CLI. Uma versão de exemplo é KTVPDKIKX0DER.
```
aws kafka update-cluster-configuration --cluster-arn ClusterArn --configuration-info file://Path-to-Config-Info-File --current-version Current-Cluster-Version
```
Veja a seguir um exemplo de como usar esse 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"
```
A saída desse comando update-cluster-configuration é semelhante ao seguinte JSON de exemplo.
```
{
    "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 obter o resultado da operação update-cluster-configuration, execute o comando a seguir, substituindo ClusterOperationArn pelo ARN obtido na saída do comando update-cluster-configuration.


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

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