Disponibilidade do agente Atualizando a configuração de um cluster usando o AWS CLI Atualize a configuração do 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 padrão. 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ção provisionada do Amazon MSK.

Tópicos

Disponibilidade do agente durante as atualizações de configuração
Atualizando a configuração de um cluster usando o 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 corretor por vez. Durante esse processo, o cluster permanece disponível, embora os corretores individuais sejam reiniciados à medida que suas configurações forem atualizadas. No entanto, algumas alterações na configuração podem exigir que todos os corretores sejam atualizados simultaneamente, o que pode causar uma breve interrupção em todo o cluster. Para obter mais informações sobre o impacto da disponibilidade do corretor durante as atualizações, consulteConfiguração provisionada do Amazon MSK.

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 MSK, consulte Como soluciono problemas ao atualizar meu cluster Amazon MSK?

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

Copie o seguinte JSON e salve-o em um arquivo. Nomeie o arquivo configuration-info.json. ConfigurationArnSubstitua pelo Amazon Resource Name (ARN) da configuração que você deseja usar para atualizar o cluster. A string do ARN deve estar entre aspas no seguinte JSON.

Configuration-RevisionSubstitua 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 comando a seguir, ClusterArn substituindo-o pelo ARN obtido ao criar seu 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.

Path-to-Config-Info-FileSubstitua pelo caminho para seu arquivo de informações de configuração. Se você nomeou o arquivo que criou na etapa anterior configuration-info.json e o salvou no diretório atual, então Path-to-Config-Info-File é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 DescribeClusteroperação ou o comando AWS CLI describe-cluster. 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 update-cluster-configuration operação, execute o comando a seguir, ClusterOperationArn substituindo-o pelo ARN obtido na saída do update-cluster-configuration comando.


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.