View a markdown version of this page

Configurar o tipo de rede de pilha dupla - 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á.

Configurar o tipo de rede de pilha dupla

O Amazon MSK oferece suporte ao tipo de rede de pilha dupla para clusters MSK Serverless existentes que usam o Kafka versão 3.6.0 ou posterior, sem custo adicional. Com a rede de pilha dupla, seus clusters podem usar endereços IPv4 e IPv6. Dual-stack os endpoints também suportam IPv4, mantendo assim a compatibilidade com versões anteriores. O Amazon MSK fornece suporte a IPv6 por meio do tipo de rede de pilha dupla, não como. IPv6-only

Por padrão, os clientes se conectam aos clusters do Amazon MSK usando o tipo de rede IPv4. Todos os novos clusters que você cria também usam IPv4 por padrão. Para atualizar o tipo de rede de um cluster para pilha dupla, verifique se você atendeu aos pré-requisitos descritos na seção a seguir. Em seguida, use a UpdateConnectivity API para atualizar a conectividade para pilha dupla.

nota

Depois de atualizar seu cluster para usar o tipo de rede de pilha dupla, você não poderá voltar para o tipo de rede IPv4.

Pré-requisitos para usar o tipo de rede de pilha dupla

Antes de configurar o tipo de rede de pilha dupla para seus clusters, certifique-se de que todas as sub-redes fornecidas durante a criação do cluster sejam compatíveis com o tipo de rede de pilha dupla. Se até mesmo uma sub-rede em seu cluster não suportar pilha dupla, você não poderá atualizar o tipo de rede do cluster para pilha dupla.

Permissões do IAM para MSK Serverless

Você deve ter as seguintes permissões do IAM:

  • ec2:DescribeSubnets

  • ec2:ModifyVpcEndpoint

Para obter uma lista completa das permissões necessárias para realizar todas as ações do Amazon MSK, consulte a política AWS gerenciada: AmazonMSKFullAccess.

Use o tipo de rede de pilha dupla para um cluster

Você pode atualizar o tipo de rede de um cluster MSK Serverless usando o Console de gerenciamento da AWS, AWS CLI, ou SDK. AWS

Using Console de gerenciamento da AWS
  1. Abra o console do Amazon MSK em https://console.aws.amazon.com/msk/home? region=us-east-1#/home/.

  2. Escolha o cluster MSK Serverless para o qual você deseja configurar o tipo de rede de pilha dupla.

  3. Na página de detalhes do cluster, escolha Propriedades.

  4. Em Configurações de rede, escolha Editar tipo de rede.

  5. Em Tipo de rede, escolha Pilha dupla.

  6. Escolha Salvar alterações.

Using AWS CLI

Você pode usar a API update-connectivity para atualizar o tipo de rede do seu cluster MSK Serverless existente para pilha dupla. O exemplo a seguir usa o update-connectivity comando para definir o tipo de rede do cluster como pilha dupla.

No exemplo a seguir, substitua o ARN do cluster de amostra, arn:aws:kafka: ::cluster//, pelo ARN real do cluster us-east-1 123456789012 MSK. myCluster 12345678-1234-1234-1234-123456789012 -1 Para obter a versão atual do cluster, use o comando https://docs.aws.amazon.com/cli/latest/reference/kafka/describe-cluster.html describe-cluster.

aws kafka update-connectivity \ --cluster-arn "arn:aws:kafka:us-east-1:123456789012:cluster/myCluster/12345678-1234-1234-1234-123456789012-1" \ --current-version "KTVPDKIKX0DER" \ --connectivity-info '{ "networkType": "DUAL" }
Using AWS SDK

O exemplo a seguir usa a UpdateConnectivity API para definir o tipo de rede do cluster como pilha dupla.

No exemplo a seguir, substitua o ARN do cluster de amostra, arn:aws:kafka: ::cluster//, pelo ARN real do cluster us-east-1 123456789012 MSK. myCluster 12345678-1234-1234-1234-123456789012-1 Para obter a versão atual do cluster, use a DescribeCluster API.

import boto3 client = boto3.client("kafka") response = client.update_connectivity( ClusterArn="arn:aws:kafka:us-east-1:123456789012:cluster/myCluster/12345678-1234-1234-1234-123456789012-1", CurrentVersion="KTVPDKIKX0DER", ConnectivityInfo={ "NetworkType": "DUAL" } ) print("Connectivity update initiated:", response)

Considerações sobre o uso do tipo de rede de pilha dupla

  • Atualmente, o suporte a IPv6 está disponível somente no modo de pilha dupla (IPv4 + IPv6), não como. IPv6-only

  • Dual-stack o tipo de rede não está disponível para conectividade privada de várias VPCs.

  • Você pode alterar o tipo de rede de IPv4 para pilha dupla em um cluster existente somente se todas as suas sub-redes oferecerem suporte ao tipo de rede de pilha dupla.

  • Você não pode reverter para o tipo de rede IPv4 depois de ativar o dual-stack. Para voltar atrás, você deve excluir e recriar o cluster.

  • Você deve ter as seguintes permissões do IAM:

    • ec2:DescribeSubnets e ec2:ModifyVpcEndpoint