Configura il tipo di rete dual-stack - Amazon Managed Streaming per Apache Kafka

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura il tipo di rete dual-stack

Amazon MSK supporta il tipo di rete dual-stack per i cluster MSK Serverless esistenti che utilizzano Kafka versione 3.6.0 o successiva senza costi aggiuntivi. Con la rete dual-stack, i cluster possono utilizzare sia gli indirizzi che gli indirizzi. IPv4 IPv6 Gli endpoint dual-stack supportano inoltre il mantenimento della compatibilità con le versioni precedenti. IPv4 Amazon MSK fornisce IPv6 supporto tramite un tipo di rete dual-stack, non solo come -only. IPv6

Per impostazione predefinita, i client si connettono ai cluster Amazon MSK utilizzando il tipo di IPv4 rete. Tutti i nuovi cluster che crei vengono utilizzati IPv4 anche per impostazione predefinita. Per aggiornare il tipo di rete di un cluster al dual-stack, assicurati di aver soddisfatto i prerequisiti descritti nella sezione seguente. Quindi, utilizza l'UpdateConnectivityAPI per aggiornare la connettività al dual-stack.

Nota

Dopo aver aggiornato il cluster per utilizzare il tipo di rete dual-stack, non puoi tornare al tipo di rete. IPv4

Prerequisiti per l'utilizzo del tipo di rete dual-stack

Prima di configurare il tipo di rete dual-stack per i cluster, assicurati che tutte le sottoreti fornite durante la creazione del cluster supportino il tipo di rete dual-stack. Se anche una sola sottorete del cluster non supporta il dual-stack, non sarà possibile aggiornare il tipo di rete del cluster a dual-stack.

Autorizzazioni IAM per MSK Serverless

Bisogna possedere le seguenti autorizzazioni IAM:

  • ec2:DescribeSubnets

  • ec2:ModifyVpcEndpoint

Per un elenco completo delle autorizzazioni necessarie per eseguire tutte le azioni di Amazon MSK, consulta la policy AWS gestita: Amazon MSKFull Access.

Usa un tipo di rete dual-stack per un cluster

È possibile aggiornare il tipo di rete per un cluster MSK Serverless utilizzando, o SDK. Console di gestione AWS AWS CLI AWS

Using Console di gestione AWS
  1. Aprire la console Amazon MSK a https://console.aws.amazon.com/msk/casa? region=us-east-1#/home/.

  2. Scegliete il cluster MSK Serverless per il quale desiderate configurare il tipo di rete dual-stack.

  3. Nella pagina dei dettagli del cluster, scegli Proprietà.

  4. In Impostazioni di rete, scegli Modifica tipo di rete.

  5. Per Tipo di rete, scegli Dual stack.

  6. Scegli Save changes (Salva modifiche).

Using AWS CLI

È possibile utilizzare l'API update-connectivity per aggiornare il tipo di rete del cluster MSK Serverless esistente a dual-stack. L'esempio seguente utilizza il update-connectivity comando per impostare il tipo di rete del cluster su dual-stack.

Nell'esempio seguente, sostituite l'ARN del cluster di esempio, arn:aws:kafka: ::cluster/, con l'ARN effettivo del us-east-1 cluster 123456789012 MSK. myCluster 12345678-1234-1234-1234-123456789012 -1 Per ottenere la versione corrente del cluster, utilizzare il 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

L'esempio seguente utilizza l'UpdateConnectivityAPI per impostare il tipo di rete del cluster su dual-stack.

Nell'esempio seguente, sostituite l'ARN del cluster di esempio, arn:aws:kafka: ::cluster/, con l'ARN effettivo del us-east-1 cluster 123456789012 MSK. myCluster 12345678-1234-1234-1234-123456789012-1 Per ottenere la DescribeClusterversione corrente del cluster, usa l'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)

Considerazioni sull'utilizzo del tipo di rete dual-stack

  • IPv6 il supporto è attualmente disponibile solo in modalità dual-stack (IPv4 +), non come -only. IPv6 IPv6

  • Il tipo di rete dual-stack non è disponibile per la connettività privata multi-VPC.

  • È possibile modificare il tipo di rete da dual-stack IPv4 per un cluster esistente solo se tutte le relative sottoreti supportano il tipo di rete dual-stack.

  • Non è possibile tornare al tipo di rete dopo aver abilitato il dual-stack. IPv4 Per tornare indietro, è necessario eliminare e ricreare il cluster.

  • Bisogna possedere le seguenti autorizzazioni IAM:

    • ec2:DescribeSubnets e ec2:ModifyVpcEndpoint