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.

Configurer le type de réseau à double pile

Amazon MSK prend en charge le type de réseau à double pile pour les clusters MSK Serverless existants qui utilisent la version 3.6.0 ou ultérieure de Kafka, sans frais supplémentaires. Grâce à la mise en réseau à double pile, vos clusters peuvent utiliser à la fois des adresses IPv4 et IPv6. Dual-stack les terminaux prennent également en charge 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 par le biais d'un réseau. IPv6-only

Par défaut, les clients se connectent aux clusters Amazon MSK via 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 Dual-Stack, assurez-vous de remplir les conditions préalables décrites dans la section suivante. Utilisez ensuite l'UpdateConnectivityAPI pour mettre à jour la connectivité vers la double pile.

Conditions préalables à l'utilisation d'un 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 un seul 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 obtenir la liste complète des autorisations requises pour effectuer toutes les actions Amazon MSK, consultez la section 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 pour un cluster MSK Serverless à l'aide du Console de gestion AWS AWS CLI, ou AWS du SDK.

Using Console de gestion AWS

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

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, choisissez 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 update-connectivity pour mettre à jour le type de réseau de votre cluster MSK Serverless existant vers une pile double. 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 de cluster, arn:aws:kafka : us-east-1 ::cluster//, par l'ARN de votre cluster MSK actuel 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 de cluster, arn:aws:kafka : us-east-1 ::cluster//, par l'ARN de votre cluster MSK actuel123456789012. 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 d'un type de réseau à double pile