Atualizar a configuração de um cluster do Amazon MSK - Amazon Managed Streaming for Apache Kafka
Atualizando a configuração de um cluster usando o AWS CLIAtualize a configuração do cluster usando a API

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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 corretamente: número de partições por broker 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.

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

  1. 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
}

  2. 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"
}

  3. 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.

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

Para usar a API para atualizar a configuração de um cluster Amazon MSK, consulte UpdateClusterConfiguration.