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 a versão 3.6.0 ou posterior do Kafka sem custo adicional. Com a rede de pilha dupla, seus clusters podem usar endereços e ambos IPv4 . IPv6 Os endpoints de pilha dupla também oferecem suporte, mantendo IPv4 assim a compatibilidade com versões anteriores. O Amazon MSK fornece IPv6 suporte por meio do tipo de rede de pilha dupla, não apenas como -only. IPv6

Por padrão, os clientes se conectam aos clusters do Amazon MSK usando o tipo IPv4 de rede. Todos os novos clusters que você cria também são usados 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 UpdateConnectivityAPI 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 pode voltar para o IPv4 tipo de rede.

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 seu 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: Amazon MSKFull Access.

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 Amazon MSK em https://console.aws.amazon.com/msk/casa? 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. Para Tipo de rede, escolha Dual stack.

6. Escolha Salvar alterações.

Using AWS CLI

Você pode usar a API de conectividade de atualização 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: us-east-1 ::cluster//, pelo ARN real do cluster MSK. 123456789012 myCluster 12345678-1234-1234-1234-123456789012 -1 Para obter a versão atual do cluster, use o comando 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 UpdateConnectivityAPI 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: us-east-1 ::cluster//, pelo ARN real do cluster MSK. 123456789012 myCluster 12345678-1234-1234-1234-123456789012-1 Para obter a versão atual do cluster, use a DescribeClusterAPI.

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

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

• O tipo de rede de pilha dupla não está disponível para conectividade privada de várias VPCs.

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

• Você não pode reverter para o tipo de IPv4 rede 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