View a markdown version of this page

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 indirizzi IPv4 che IPv6. Dual-stack gli endpoint supportano anche IPv4, mantenendo così la compatibilità con le versioni precedenti. Amazon MSK fornisce il supporto IPv6 tramite un tipo di rete dual-stack, non come. IPv6-only

Per impostazione predefinita, i client si connettono ai cluster Amazon MSK utilizzando il tipo di rete IPv4. Tutti i nuovi cluster che crei utilizzano anche IPv4 per impostazione predefinita. Per aggiornare il tipo di rete di un cluster a 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:. AmazonMSKFullAccess

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 all'indirizzohttps://console.aws.amazon.com/msk/home? 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

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

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

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

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

  • Bisogna possedere le seguenti autorizzazioni IAM:

    • ec2:DescribeSubnets e ec2:ModifyVpcEndpoint