View a markdown version of this page

Configurer des noms de domaine personnalisés pour votre cluster Amazon MSK - Amazon Managed Streaming for Apache Kafka
Comment fonctionnent les noms de domaine personnalisésConditions préalablesMigrer du ZooKeeper mode KraFT

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 des noms de domaine personnalisés pour votre cluster Amazon MSK

Vous pouvez configurer votre cluster MSK Provisioned pour publier des noms de domaine personnalisés au lieu des adresses de courtier AWS générées par défaut. Les noms de domaine personnalisés sont définis une seule fois dans votre configuration Amazon MSK et appliqués automatiquement à tous les courtiers du cluster, y compris aux nouveaux courtiers ajoutés lors des opérations de dimensionnement. Cela fonctionne à la fois en mode de gestion des métadonnées Kraft ZooKeeper et en mode Kraft.

Rubriques

Comment fonctionnent les noms de domaine personnalisés

Lorsque vous ajoutez la custom.advertised.listeners propriété à votre configuration Amazon MSK, Amazon MSK effectue les opérations suivantes :

  1. Valide la configuration (nom de l'écouteur, format et caractère unique).

  2. Résout le {broker_id} modèle pour chaque courtier.

  3. Applique la configuration par le biais d'un redémarrage progressif, un courtier à la fois.

La propriété prend le format suivant.

custom.advertised.listeners=LISTENER_NAME://hostname-pattern:port+{broker_id}

Par exemple, sur un cluster IAM avec trois courtiers :

custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id}

Cela résout les problèmes suivants :

  • Courtier 1 : b-1.example.com:9001

  • Courtier 2 : b-2.example.com:9002

  • Courtier 3 : b-3.example.com:9003

La variable de {broker_id} modèle est obligatoire et doit apparaître dans le port afin que chaque broker trouve une adresse unique. L'+opérateur ajoute l'ID du courtier au port de base (9000 + 1 = 9001, 9000 + 2 = 9002, 9000 + 10 = 9010).

Si votre cluster possède plusieurs écouteurs orientés client, vous pouvez attribuer un domaine différent à chacun d'eux en les séparant par des virgules.

custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.iam.example.com:9000+{broker_id},CLIENT_SASL_SCRAM://b-{broker_id}.scram.example.com:19000+{broker_id}

Chaque écouteur est mappé vers un domaine personnalisé. Vous ne pouvez pas attribuer plusieurs domaines au même écouteur. Cependant, les auditeurs peuvent partager le même nom de domaine tant que chacun d'entre eux correspond à une host:port combinaison unique par courtier. Par exemple, deux écouteurs peuvent se partager b-{broker_id}.example.com et ne différer que par port.

custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id},CLIENT_SASL_SCRAM://b-{broker_id}.example.com:19000+{broker_id}

Ce comportement est identique en mode ZooKeeper de gestion des métadonnées Kraft.

Vérifiez le réseau avant d'appliquer la configuration

Lorsque vous postulezcustom.advertised.listeners, votre nom de domaine personnalisé remplace les adresses par défaut de l'écouteur remplacé. Par conséquent, votre couche réseau doit être en place et vérifiée avant d'appliquer la configuration. Si la couche réseau et de confiance n'est pas en place, résoluble, joignable et fiable par le client, celui-ci ne peut pas se reconnecter. Cela est vrai même si le client était connecté quelques instants plus tôt. Si les clients ne peuvent pas résoudre le domaine personnalisé, ils perdent leur connectivité.

Conditions préalables

Avant de configurer des noms de domaine personnalisés sur votre cluster, assurez-vous que ce qui suit est vrai :

  • Votre cluster est un cluster MSK Provisioned (courtiers Standard ou Express) situé dans l'ACTIVEÉtat.

  • Chaque écouteur correspond à un type d'authentification sur votre cluster. Vous pouvez définir des points de terminaison personnalisés annoncés uniquement pour les auditeurs clients :CLIENT,,CLIENT_SECURE,CLIENT_SECURE_PUBLIC, CLIENT_SASL_SCRAMCLIENT_SASL_SCRAM_PUBLIC, CLIENT_IAM et. CLIENT_IAM_PUBLIC Les écouteurs internes (REPLICATIONetCONTROLLER) ne sont pas pris en charge et sont rejetés lors de la validation. L'écouteur que vous spécifiez doit également être lié (actif) à votre cluster. Par exemple, si votre cluster utilise uniquement l'authentification IAM, la spécification CLIENT_SECURE est rejetée et le message d'erreur répertorie les écouteurs clients valides pour votre cluster.

  • Votre couche réseau est en place et vérifiée avant d'appliquer la configuration. Une fois que vous l'avez appliquée, tous les clients qui actualisent les métadonnées reçoivent l'adresse de domaine personnalisée. Si les clients ne peuvent pas résoudre le domaine personnalisé, ils perdent leur connectivité. Assurez-vous que votre couche réseau est configurée et accessible depuis tous les clients avant d'appliquer la configuration. Pour une présentation schématique complète de la configuration de Network Load Balancer, Route 53 et Certificate AWS Manager, consultez Configurer un nom de domaine personnalisé pour votre cluster Amazon MSK sur le AWS Big Data Blog.

Migrer du ZooKeeper mode KraFT

Si vous utilisez actuellement le ZooKeeper mode kafka-configs.sh de configuration advertised.listeners dynamique, vous devez le configurer custom.advertised.listeners dans votre configuration Amazon MSK avant de lancer votre migration du ZooKeeper mode KraFT. La mise à niveau sur place vérifie les remplacements d'écouteurs dynamiques annoncés existants. S'il en détecte, la mise à niveau ne se poursuit pas et vous recevez un message d'erreur vous demandant de les supprimer d'abord. Pour une expérience fluide, procédez comme suit :

  1. Ajoutez custom.advertised.listeners à votre configuration Amazon MSK le même modèle de domaine que celui que vous utilisez aujourd'hui. Pour les étapes, consultez Configurer un nom de domaine personnalisé de bout en bout.

  2. Supprimez la dérogation dynamique en l'exécutant kafka-configs.sh --alter --delete-config advertised.listeners sur chaque broker. Cela supprime uniquement le remplacement des écouteurs annoncés et n'affecte pas les autres configurations dynamiques.

  3. Lancez la migration.

Pour plus d'informations sur la migration d'un cluster vers le mode KraFT, consultezMigrer depuis ZooKeeper le mode KRAFT.