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 un nom de domaine personnalisé de bout en bout

Cette rubrique décrit la configuration côté cluster pour les noms de domaine personnalisés. La couche réseau (Network Load Balancer, DNS et certificat TLS) est une condition préalable que vous possédez. Elle est décrite en détail dans la section Configurer un nom de domaine personnalisé pour votre cluster Amazon MSK sur le AWS blog Big Data. Une fois le réseau en place, les étapes suivantes concernent la configuration côté cluster.

Étape 1 : ajouter le domaine personnalisé à votre configuration Amazon MSK

Créez ou mettez à jour une configuration Amazon MSK qui inclut la custom.advertised.listeners propriété et qui correspond aux noms d'hôte et aux ports que vous avez configurés sur le Network Load Balancer. Pour un cluster IAM à trois courtiers dirigé par un Network Load Balancer avec les ports 9001 à 9003, placez la propriété dans un fichier.

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

Créez ensuite la configuration en transmettant le fichier comme propriétés du serveur.

aws kafka create-configuration \
    --name "custom-domain-iam" \
    --description "Custom advertised listeners for CLIENT_IAM" \
    --server-properties fileb://custom-domain-config.txt

Utilisez fileb:// (notfile://) pour que le fichier soit AWS CLI lu sous forme d'octets et qu'il le code en base64. La transmission de la valeur en ligne est fragile à cause des {broker_id} accolades. Laissez le {broker_id} texte littéral dans le fichier, car Amazon MSK le résout par courtier au moment de l'application. La réponse renvoie la configuration Arn etLatestRevision.Revision, que vous utiliserez à l'étape suivante.

Étape 2 : appliquer la configuration

Appliquez la configuration à votre cluster avecUpdateClusterConfiguration, à l'aide de la console, AWS CLI, AWS CloudFormation, AWS CDK ou Terraform. Il s'agit du même flux de travail que celui que vous utilisez déjà pour les modifications de configuration des courtiers.

aws kafka update-cluster-configuration \
    --cluster-arn your-cluster-arn \
    --configuration-info arn=configuration-arn,revision=revision \
    --current-version current-cluster-version

Utilisez cette DescribeCluster opération pour trouver la version actuelle de votre cluster. Les versions de cluster ne sont pas des entiers simples.

Amazon MSK valide la configuration de manière synchrone avant toute application, afin qu'une valeur mal formée ne parvienne jamais à vos courtiers. Amazon MSK rejette une configuration non valide avec une erreur HTTP 400. Pour des exemples d'erreurs, voirErreurs de configuration de noms de domaine personnalisés. Corrigez le problème signalé et présentez une nouvelle demande.

Étape 3 : suivre le déploiement

aws kafka describe-cluster-operation-v2 \
    --cluster-operation-arn operation-arn

Une fois la configuration acceptée, Amazon MSK l'applique par le biais d'un redémarrage progressif. Attendez que l'opération soit signaléeUPDATE_COMPLETE. S'il est signaléUPDATE_FAILED, un courtier ne pourrait pas appliquer la modification. Le déploiement s'arrête chez ce courtier, les autres courtiers conservent leur configuration précédente, et vous pouvez corriger la configuration et la réappliquer pour la rétablir.

Étape 4 : Vérifier

Vérifiez que les clients peuvent se connecter via le domaine personnalisé en répertoriant les sujets d'un client qui utilise les paramètres d'authentification de votre écouteur.

Si vous pouvez répertorier les sujets via le point de terminaison du domaine personnalisé, les clients se connectent correctement via votre domaine personnalisé. Si l'opération est signalée UPDATE_COMPLETE mais que les clients ne peuvent pas se connecter, la configuration côté cluster est correcte mais votre couche réseau nécessite probablement une attention particulière. Vérifiez les éléments suivants :

Bonnes pratiques

Une fois que vous avez configuré des noms de domaine personnalisés en suivant les étapes précédentes, nous vous recommandons de supprimer toute advertised.listeners dérogation dynamique en les 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.

Mise à l'échelle et remplacement des courtiers

Lorsque vous dimensionnez le cluster ou qu'un courtier est remplacé lors de la réparation automatique, Amazon MSK applique automatiquement la configuration au nouveau courtier. Amazon MSK résout {broker_id} les problèmes liés à l'identifiant du courtier, sans qu'aucune étape manuelle ne soit requise du côté du cluster.

Supprimer un domaine personnalisé

Pour revenir aux MSK-generated adresses Amazon par défaut, supprimez la custom.advertised.listeners propriété de votre configuration Amazon MSK et appliquez la configuration mise à jour à l'aide de. UpdateClusterConfiguration Amazon MSK effectue un redémarrage progressif et les courtiers recommencent à publier leurs adresses d'origine. Assurez-vous que vos clients peuvent accéder aux MSK-generated adresses Amazon d'origine avant de supprimer la configuration de domaine personnalisée.