Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Configuration du type de réseau à double pile

Amazon MSK prend en charge le type de réseau à double pile pour les clusters MSK sans serveur existants qui utilisent la version 3.6.0 ou ultérieure de Kafka, sans frais supplémentaires. Avec un réseau à double pile, vos clusters peuvent utiliser à la fois des adresses IPv4 et IPv6. Dual-stack les points de terminaison prennent également en charge l'IPv4, préservant ainsi la rétrocompatibilité. Amazon MSK fournit une prise en charge IPv6 via un type de réseau à double pile, et non en tant que. IPv6-only

Par défaut, les clients se connectent aux clusters Amazon MSK en utilisant le type de réseau IPv4. Tous les nouveaux clusters que vous créez utilisent également IPv4 par défaut. Pour mettre à jour le type de réseau d'un cluster vers le mode Dual-Stack, assurez-vous de remplir les conditions requises décrites dans la section suivante. Utilisez ensuite l'UpdateConnectivityAPI pour mettre à jour la connectivité vers Dual-Stack.

Conditions préalables à l'utilisation du type de réseau à double pile

Avant de configurer le type de réseau à double pile pour vos clusters, assurez-vous que tous les sous-réseaux que vous fournissez lors de la création du cluster doivent prendre en charge le type de réseau à double pile. Si même un sous-réseau de votre cluster ne prend pas en charge la double pile, vous ne pourrez pas mettre à jour le type de réseau de votre cluster vers la double pile.

Autorisations IAM pour MSK Serverless

Vous devez détenir les autorisations IAM suivants :

Pour une liste complète des autorisations requises pour effectuer toutes les actions Amazon MSK, consultez la politique AWS gérée : AmazonMSKFullAccess.

Utiliser un type de réseau à double pile pour un cluster

Vous pouvez mettre à jour le type de réseau d'un cluster MSK Serverless à l'aide du AWS Management Console AWS CLI, ou AWS du SDK.

Using AWS Management Console

1. Ouvrez la console Amazon MSK à https://console.aws.amazon.com/msk/home l'adresse ? region=us-east-1#/home/.

2. Choisissez le cluster MSK Serverless pour lequel vous souhaitez configurer le type de réseau à double pile.

3. Sur la page des détails du cluster, sélectionnez Propriétés.

4. Dans Paramètres réseau, choisissez Modifier le type de réseau.

5. Pour Type de réseau, choisissez Dual stack.

6. Sélectionnez Enregistrer les modifications.

Using AWS CLI

Vous pouvez utiliser l'API de mise à jour de connectivité pour mettre à jour le type de réseau de votre cluster MSK Serverless existant vers le mode Dual-Stack. L'exemple suivant utilise la update-connectivity commande pour définir le type de réseau du cluster sur Dual-Stack.

Dans l'exemple suivant, remplacez l'exemple d'ARN du cluster, arn:aws:kafka : us-east-1 ::cluster//, par l'ARN de votre cluster MSK réel 123456789012. myCluster 12345678-1234-1234-1234-123456789012 -1 Pour obtenir la version actuelle du cluster, utilisez la commande 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'exemple suivant utilise l'UpdateConnectivityAPI pour définir le type de réseau du cluster sur Dual-Stack.

Dans l'exemple suivant, remplacez l'exemple d'ARN du cluster, arn:aws:kafka : us-east-1 ::cluster//, par l'ARN de votre cluster MSK réel123456789012. myCluster 12345678-1234-1234-1234-123456789012-1 Pour obtenir la version actuelle du cluster, utilisez l'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)

Considérations relatives à l'utilisation du type de réseau à double pile