Crie um cluster Amazon MSK provisionado usando o AWS CLI - Amazon Managed Streaming for Apache Kafka

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

Crie um cluster Amazon MSK provisionado usando o AWS CLI

  1. Copie o seguinte JSON e salve-o em um arquivo. Nomeie o arquivo brokernodegroupinfo.json. Substitua a sub-rede IDs no JSON pelos valores que correspondem às suas sub-redes. As sub-redes devem estar em zonas de disponibilidade diferentes. "Security-Group-ID"Substitua pelo ID de um ou mais grupos de segurança da VPC do cliente. Os clientes associados a esses grupos de segurança têm acesso ao cluster. Se você especificar grupos de segurança que foram compartilhados com você, deverá garantir que você tenha permissões para eles. Especificamente, você precisa da permissão ec2:DescribeSecurityGroups. Por exemplo, consulte Amazon EC2: Permite gerenciar grupos de EC2 segurança da Amazon associados a uma VPC específica, programaticamente e no console. Por fim, salve o arquivo JSON atualizado no computador em que você o AWS CLI instalou.

    {
  "InstanceType": "kafka.m5.large",
  "ClientSubnets": [
    "Subnet-1-ID",
    "Subnet-2-ID"
  ],
  "SecurityGroups": [
    "Security-Group-ID"
  ]
}
    Importante

    Para corretores Express, você precisa de três sub-redes em três zonas de disponibilidade diferentes. Você também não precisa definir nenhuma propriedade relacionada ao armazenamento.

    Para corretores padrão na região Oeste dos EUA (Norte da Califórnia), você precisa de duas sub-redes em duas zonas de disponibilidade diferentes. Em todas as outras regiões que disponibilizam o Amazon MSK, é possível especificar duas ou três sub-redes. As suas sub-redes devem estar em diferentes zonas de disponibilidade. Quando você cria um cluster, o Amazon MSK distribui os nós de agente uniformemente pelas sub-redes especificadas.

  2. Execute o AWS CLI comando a seguir no diretório em que você salvou o brokernodegroupinfo.json arquivo, "Your-Cluster-Name" substituindo-o por um nome de sua escolha. Para"Monitoring-Level", você pode especificar um dos três valores a seguir: DEFAULTPER_BROKER, ouPER_TOPIC_PER_BROKER. Para obter informações sobre esses três níveis diferentes de monitoramento, consulte Monitore um cluster provisionado do Amazon MSK. O parâmetro enhanced-monitoring é opcional. Se não especificá-lo no comando create-cluster, você obterá o nível de monitoramento DEFAULT.

    aws kafka create-cluster --cluster-name "Your-Cluster-Name" --broker-node-group-info file://brokernodegroupinfo.json --kafka-version "2.8.1" --number-of-broker-nodes 3 --enhanced-monitoring "Monitoring-Level"

    A saída do comando é semelhante ao JSON a seguir:

    {
    "ClusterArn": "...",
    "ClusterName": "AWSKafkaTutorialCluster",
    "State": "CREATING"
}
    nota

    O comando create-cluster pode retornar um erro informando que uma ou mais sub-redes pertencem a zonas de disponibilidade que não têm suporte. Quando isso acontece, o erro indica as zonas de disponibilidade que não têm suporte. Crie sub-redes que não usem as zonas de disponibilidade sem suporte e tente o comando create-cluster novamente.

  3. Salve o valor da chave ClusterArn porque você precisará dele para executar outras ações no cluster.

  4. Execute o seguinte comando para verificar o STATE do seu cluster. O valor de STATE muda de CREATING para ACTIVE conforme o Amazon MSK provisiona o cluster. Quando o estado for ACTIVE, você poderá se conectar ao cluster. Para obter mais informações sobre status de cluster, consulte Entenda os estados do cluster provisionado pelo MSK.

    aws kafka describe-cluster --cluster-arn <your-cluster-ARN>