Disponibilidade do agente Atualizando a configuração de um cluster usando o 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
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 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 saber mais sobre o impacto na disponibilidade do agente durante as atualizações, consulte Configurações do Amazon MSK Provisioned.

Antes de atualizar os clusters de produção, recomendamos que você teste as 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?

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.