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á.
MSKExemplos da Amazon usando AWS CLI
Os exemplos de código a seguir mostram como realizar ações e implementar cenários comuns usando o AWS Command Line Interface com a AmazonMSK.
Ações são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar funções de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
Cada exemplo inclui um link para o código-fonte completo, onde você pode encontrar instruções sobre como configurar e executar o código no contexto.
Tópicos
Ações
O código de exemplo a seguir mostra como usar create-cluster
.
- AWS CLI
-
Para criar um MSK cluster da Amazon
O
create-cluster
exemplo a seguir cria um MSK cluster chamadoMessagingCluster
com três nós de agente. Um JSON arquivo chamadobrokernodegroupinfo.json
especifica as três sub-redes pelas quais você deseja que a Amazon MSK distribua os nós do broker. Este exemplo não especifica o nível de monitoramento, então o cluster obtém oDEFAULT
nível.aws kafka create-cluster \ --cluster-name
"MessagingCluster"
\ --broker-node-group-infofile://brokernodegroupinfo.json
\ --kafka-version"2.2.1"
\ --number-of-broker-nodes3
Conteúdo de
brokernodegroupinfo.json
:{ "InstanceType": "kafka.m5.xlarge", "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-0123456789111abcd", "subnet-0123456789222abcd", "subnet-0123456789333abcd" ] }
Saída:
{ "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterName": "MessagingCluster", "State": "CREATING" }
Para obter mais informações, consulte Criar um MSK cluster da Amazon no Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte CreateCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar create-configuration
.
- AWS CLI
-
Para criar uma MSK configuração personalizada da Amazon
O
create-configuration
exemplo a seguir cria uma MSK configuração personalizada com as propriedades do servidor especificadas no arquivo de entrada.aws kafka create-configuration \ --name
"CustomConfiguration"
\ --description"Topic autocreation enabled; Apache ZooKeeper timeout 2000 ms; Log rolling 604800000 ms."
\ --kafka-versions"2.2.1"
\ --server-propertiesfile://configuration.txt
Conteúdo de
configuration.txt
:auto.create.topics.enable = true zookeeper.connection.timeout.ms = 2000 log.roll.ms = 604800000
Este comando não produz saída. Saída:
{ "Arn": "arn:aws:kafka:us-west-2:123456789012:configuration/CustomConfiguration/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "CreationTime": "2019-10-09T15:26:05.548Z", "LatestRevision": { "CreationTime": "2019-10-09T15:26:05.548Z", "Description": "Topic autocreation enabled; Apache ZooKeeper timeout 2000 ms; Log rolling 604800000 ms.", "Revision": 1 }, "Name": "CustomConfiguration" }
Para obter mais informações, consulte Operações de MSK configuração da Amazon no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte CreateConfiguration
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar describe-cluster
.
- AWS CLI
-
Para descrever um cluster
O
describe-cluster
exemplo a seguir descreve um MSK cluster da Amazon.aws kafka describe-cluster \ --cluster-arn
arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5
Saída:
{ "ClusterInfo": { "BrokerNodeGroupInfo": { "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-cbfff283", "subnet-6746046b" ], "InstanceType": "kafka.m5.large", "SecurityGroups": [ "sg-f839b688" ], "StorageInfo": { "EbsStorageInfo": { "VolumeSize": 100 } } }, "ClusterArn": "arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5", "ClusterName": "demo-cluster-1", "CreationTime": "2020-07-09T02:31:36.223000+00:00", "CurrentBrokerSoftwareInfo": { "KafkaVersion": "2.2.1" }, "CurrentVersion": "K3AEGXETSR30VB", "EncryptionInfo": { "EncryptionAtRest": { "DataVolumeKMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a7ca56d5-0768-4b64-a670-339a9fbef81c" }, "EncryptionInTransit": { "ClientBroker": "TLS_PLAINTEXT", "InCluster": true } }, "EnhancedMonitoring": "DEFAULT", "OpenMonitoring": { "Prometheus": { "JmxExporter": { "EnabledInBroker": false }, "NodeExporter": { "EnabledInBroker": false } } }, "NumberOfBrokerNodes": 2, "State": "ACTIVE", "Tags": {}, "ZookeeperConnectString": "z-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-3.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181" } }
Para obter mais informações, consulte Listar MSK clusters da Amazon no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte DescribeCluster
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar get-bootstrap-brokers
.
- AWS CLI
-
Para obter corretores de bootstrap
O
get-bootstrap-brokers
exemplo a seguir recupera as informações do agente de bootstrap para um cluster da AmazonMSK.aws kafka get-bootstrap-brokers \ --cluster-arn
arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5
Saída:
{ "BootstrapBrokerString": "b-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9092,b-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9092", "BootstrapBrokerStringTls": "b-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9094,b-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:9094" }
Para obter mais informações, consulte Como obter os Bootstrap Brokers no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte GetBootstrapBrokers
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar list-clusters
.
- AWS CLI
-
Para listar os clusters disponíveis
O
list-clusters
exemplo a seguir lista os MSK clusters da Amazon em sua AWS conta.aws kafka list-clusters
Saída:
{ "ClusterInfoList": [ { "BrokerNodeGroupInfo": { "BrokerAZDistribution": "DEFAULT", "ClientSubnets": [ "subnet-cbfff283", "subnet-6746046b" ], "InstanceType": "kafka.m5.large", "SecurityGroups": [ "sg-f839b688" ], "StorageInfo": { "EbsStorageInfo": { "VolumeSize": 100 } } }, "ClusterArn": "arn:aws:kafka:us-east-1:123456789012:cluster/demo-cluster-1/6357e0b2-0e6a-4b86-a0b4-70df934c2e31-5", "ClusterName": "demo-cluster-1", "CreationTime": "2020-07-09T02:31:36.223000+00:00", "CurrentBrokerSoftwareInfo": { "KafkaVersion": "2.2.1" }, "CurrentVersion": "K3AEGXETSR30VB", "EncryptionInfo": { "EncryptionAtRest": { "DataVolumeKMSKeyId": "arn:aws:kms:us-east-1:123456789012:key/a7ca56d5-0768-4b64-a670-339a9fbef81c" }, "EncryptionInTransit": { "ClientBroker": "TLS_PLAINTEXT", "InCluster": true } }, "EnhancedMonitoring": "DEFAULT", "OpenMonitoring": { "Prometheus": { "JmxExporter": { "EnabledInBroker": false }, "NodeExporter": { "EnabledInBroker": false } } }, "NumberOfBrokerNodes": 2, "State": "ACTIVE", "Tags": {}, "ZookeeperConnectString": "z-2.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-1.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181,z-3.demo-cluster-1.xuy0sb.c5.kafka.us-east-1.amazonaws.com:2181" } ] }
Para obter mais informações, consulte Listar MSK clusters da Amazon no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte ListClusters
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-broker-storage
.
- AWS CLI
-
Para atualizar o EBS armazenamento para corretores
O
update-broker-storage
exemplo a seguir atualiza a quantidade de EBS armazenamento de todos os agentes no cluster. A Amazon MSK define o valor de armazenamento alvo para cada corretor de acordo com o valor especificado no exemplo. Você pode obter a versão atual do cluster descrevendo o cluster ou listando todos os clusters.aws kafka update-broker-storage \ --cluster-arn
"arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2"
\ --current-version"K21V3IB1VIZYYH"
\ --target-broker-ebs-volume-info"KafkaBrokerNodeId=ALL,VolumeSizeGB=1100"
A saída retorna an ARN para essa
update-broker-storage
operação. Para determinar se essa operação foi concluída, use odescribe-cluster-operation
comando com isso ARN como entrada.{ "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterOperationArn": "arn:aws:kafka:us-west-2:123456789012:cluster-operation/V123450123/a1b2c3d4-1234-abcd-cdef-22222EXAMPLE-2/a1b2c3d4-abcd-1234-bcde-33333EXAMPLE" }
Para obter mais informações, consulte Atualizar o EBS armazenamento para corretores no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte UpdateBrokerStorage
na Referência de AWS CLI Comandos.
-
O código de exemplo a seguir mostra como usar update-cluster-configuration
.
- AWS CLI
-
Para atualizar a configuração de um MSK cluster da Amazon
O
update-cluster-configuration
exemplo a seguir atualiza a configuração do MSK cluster existente especificado. Ele usa uma MSK configuração personalizada.aws kafka update-cluster-configuration \ --cluster-arn
"arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2"
\ --configuration-infofile://configuration-info.json
\ --current-version"K21V3IB1VIZYYH"
Conteúdo de
configuration-info.json
:{ "Arn": "arn:aws:kafka:us-west-2:123456789012:configuration/CustomConfiguration/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "Revision": 1 }
A saída retorna an ARN para essa
update-cluster-configuration
operação. Para determinar se essa operação foi concluída, use odescribe-cluster-operation
comando com isso ARN como entrada.{ "ClusterArn": "arn:aws:kafka:us-west-2:123456789012:cluster/MessagingCluster/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE-2", "ClusterOperationArn": "arn:aws:kafka:us-west-2:123456789012:cluster-operation/V123450123/a1b2c3d4-1234-abcd-cdef-22222EXAMPLE-2/a1b2c3d4-abcd-1234-bcde-33333EXAMPLE" }
Para obter mais informações, consulte Atualizar a configuração de um MSK cluster da Amazon no Guia do desenvolvedor do Amazon Managed Streaming for Apache Kafka.
-
Para API obter detalhes, consulte UpdateClusterConfiguration
na Referência de AWS CLI Comandos.
-