Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Configure un nombre de dominio personalizado de principio a fin
En este tema se explica la configuración del clúster para los nombres de dominio personalizados. La capa de red (Network Load Balancer, DNS y certificado TLS) es un requisito previo de su propiedad y se describe en detalle en Configurar un nombre de dominio personalizado para su clúster de Amazon MSK
Compruebe la red antes de aplicar la configuración
Al realizar la solicitudcustom.advertised.listeners, el nombre de dominio personalizado reemplaza las direcciones predeterminadas del agente de escucha anulado. Su capa de red debe estar instalada y verificada antes de aplicar la configuración. Si los clientes no pueden resolver el dominio personalizado, pierden la conectividad.
Paso 1: Añade el dominio personalizado a la configuración de Amazon MSK
Cree o actualice una configuración de Amazon MSK que incluya la custom.advertised.listeners propiedad y que coincida con los nombres de host y los puertos que aprovisionó en el Network Load Balancer. En el caso de un clúster de IAM de tres agentes encabezado por un Network Load Balancer con los puertos 9001—9003, coloque la propiedad en un archivo.
custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id}A continuación, cree la configuración y transfiera el archivo como propiedades del servidor.
aws kafka create-configuration \ --name "custom-domain-iam" \ --description "Custom advertised listeners for CLIENT_IAM" \ --server-properties fileb://custom-domain-config.txt
Use fileb:// (notfile://) para que AWS CLI lea el archivo en bytes y lo codifique en base64. Pasar el valor entre líneas es frágil debido a las llaves. {broker_id} Déjelo {broker_id} literalmente en el archivo, ya que Amazon MSK lo resuelve por agente en el momento de la solicitud. La respuesta devuelve la configuración Arn yLatestRevision.Revision, que se utilizará en el siguiente paso.
Paso 2: Aplicar la configuración
Aplique la configuración a su clúster mediante UpdateClusterConfiguration la consola AWS CLI AWS CloudFormation, AWS CDK o Terraform. Este es el mismo flujo de trabajo que ya utiliza para los cambios de configuración de los corredores.
aws kafka update-cluster-configuration \ --cluster-arnyour-cluster-arn\ --configuration-info arn=configuration-arn,revision=revision\ --current-versioncurrent-cluster-version
Utilice la DescribeCluster operación para buscar la versión actual del clúster. Las versiones de clúster no son enteros simples.
Amazon MSK valida la configuración de forma sincrónica antes de aplicar nada, de modo que un valor con formato incorrecto nunca llegue a sus agentes. Amazon MSK rechaza una configuración no válida con un error HTTP 400. Para ver ejemplos de errores, consulteErrores de configuración de nombres de dominio personalizados. Corrija el problema notificado y vuelva a aplicarlo.
Paso 3: Realice un seguimiento de la implementación
aws kafka describe-cluster-operation-v2 \ --cluster-operation-arnoperation-arn
Una vez aceptada la configuración, Amazon MSK la aplica mediante un reinicio gradual. Espere hasta que se informe UPDATE_COMPLETE de la operación. Si informaUPDATE_FAILED, el bróker no podría aplicar el cambio. La implementación se detiene en ese corredor, los corredores restantes mantienen su configuración anterior y usted puede corregir la configuración y volver a aplicarla para recuperarla.
Paso 4: Verificar
Confirme que los clientes pueden conectarse a través del dominio personalizado enumerando los temas de un cliente que utilice la configuración de autenticación de su oyente.
Si puedes publicar los temas a través del punto de enlace del dominio personalizado, los clientes se están conectando correctamente a través de tu dominio personalizado. Si la operación se notificó UPDATE_COMPLETE pero los clientes no se pudieron conectar, la configuración del lado del clúster es correcta, pero es probable que su capa de red necesite atención. Comprueba lo siguiente:
-
Ruta de red: confirme que la regla de escucha, grupo objetivo y grupo de seguridad del Network Load Balancer existan para el broker y el puerto que utiliza el cliente, y que se puede acceder al Network Load Balancer desde la red del cliente.
-
Resolución de DNS: confirme que el dominio personalizado se resuelve en su Network Load Balancer desde todas las redes en las que se ejecutan sus clientes de Apache Kafka.
-
Certificado: confirme que el certificado TLS del balanceador de carga de red cubre el nombre de host del corredor resuelto (mediante el nombre común o un nombre alternativo del sujeto) y que el cliente confía en la CA (raíz e intermedia en el caso de una CA privada).
Prácticas recomendadas
Tras configurar los nombres de dominio personalizados mediante los pasos anteriores, le recomendamos que elimine cualquier advertised.listeners anulación dinámica kafka-configs.sh --alter --delete-config advertised.listeners ejecutándola en cada agente. Esto elimina solo la anulación anunciada por los oyentes y no afecta a otras configuraciones dinámicas.
Escalamiento y reemplazo de intermediarios
Al escalar el clúster o al sustituir a un agente durante la recuperación automática, Amazon MSK aplica automáticamente la configuración al nuevo agente. Amazon MSK {broker_id} busca el identificador del bróker, sin necesidad de realizar ningún paso manual por parte del clúster.
nota
Agregue el agente de escucha, el grupo objetivo y el registro de DNS de Network Load Balancer correspondientes para cualquier agente nuevo. La capa de red no se escala automáticamente.
Eliminar un dominio personalizado
Para volver a las MSK-generated direcciones de Amazon predeterminadas, elimina la custom.advertised.listeners propiedad de tu configuración de Amazon MSK y aplica la configuración actualizada mediante. UpdateClusterConfiguration Amazon MSK realiza un reinicio continuo y los corredores vuelven a anunciar sus direcciones originales. Asegúrate de que tus clientes puedan acceder a las MSK-generated direcciones originales de Amazon antes de eliminar la configuración de dominio personalizada.
