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.
Configura nombres de dominio personalizados para tu clúster de Amazon MSK
Puedes configurar tu clúster aprovisionado por MSK para que anuncie nombres de dominio personalizados en lugar de las direcciones de bróker AWS generadas por defecto. Los nombres de dominio personalizados se definen una vez en la configuración de Amazon MSK y se aplican automáticamente a todos los agentes del clúster, incluidos los nuevos agentes que se añaden durante las operaciones de escalado. Esto funciona tanto en el modo de administración de metadatos de ZooKeeper KrAFT como en el modo de administración de metadatos.
Temas
Cómo funcionan los nombres de dominio personalizados
Al añadir la custom.advertised.listeners propiedad a la configuración de Amazon MSK, Amazon MSK hace lo siguiente:
-
Valida la configuración (nombre del oyente, formato y exclusividad).
-
Resuelve la
{broker_id}plantilla de cada corredor. -
Aplica la configuración mediante un reinicio continuo, un broker a la vez.
La propiedad tiene el siguiente formato.
custom.advertised.listeners=LISTENER_NAME://hostname-pattern:port+{broker_id}Por ejemplo, en un clúster de IAM con tres agentes:
custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id}Esto se resuelve en las siguientes direcciones:
-
Agente 1:
b-1.example.com:9001 -
Corredor 2:
b-2.example.com:9002 -
Bróker 3:
b-3.example.com:9003
La variable de {broker_id} plantilla es obligatoria y debe aparecer en el puerto para que cada agente resuelva en una dirección única. El + operador agrega el ID del corredor al puerto base (9000 + 1 = 9001, 9000 + 2 = 9002, 9000 + 10 = 9010).
Si su clúster tiene varios oyentes orientados al cliente, puede asignar un dominio diferente a cada uno separándolos con comas.
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}Cada oyente se asigna a un dominio personalizado. No puedes asignar varios dominios al mismo oyente. Sin embargo, los oyentes pueden compartir el mismo nombre de dominio siempre que cada uno de ellos utilice una host:port combinación única por agente. Por ejemplo, dos oyentes solo pueden compartir b-{broker_id}.example.com y diferir por puerto.
custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id},CLIENT_SASL_SCRAM://b-{broker_id}.example.com:19000+{broker_id}Este comportamiento es idéntico en el modo de administración ZooKeeper de metadatos de KrAFT.
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. Por lo tanto, su capa de red debe estar instalada y verificada antes de aplicar la configuración. Si la capa de redes y de confianza no está establecida, no se puede resolver, se puede acceder a ella y no se puede confiar en ella desde el cliente, este no podrá volver a conectarse. Esto es cierto incluso si el cliente se conectó momentos antes. Si los clientes no pueden resolver el dominio personalizado, pierden la conectividad.
Requisitos previos
Antes de configurar los nombres de dominio personalizados en el clúster, asegúrese de que se cumpla lo siguiente:
-
Su clúster es un clúster aprovisionado por MSK (agentes Standard o Express) en el
ACTIVEestado. -
Cada agente de escucha corresponde a un tipo de autenticación de su clúster. Puede configurar puntos de enlace anunciados personalizados solo para los oyentes del cliente:
CLIENT,,CLIENT_SECURE,CLIENT_SECURE_PUBLICCLIENT_SASL_SCRAM,CLIENT_SASL_SCRAM_PUBLICy.CLIENT_IAMCLIENT_IAM_PUBLICLos oyentes internos (REPLICATIONyCONTROLLER) no son compatibles y se rechazan en el momento de la validación. El agente de escucha que especifique también debe estar enlazado (activo) en su clúster. Por ejemplo, si el clúster utiliza únicamente la autenticación de IAM,CLIENT_SECUREse rechaza la especificación y el mensaje de error muestra los agentes de escucha de cliente válidos para el clúster. -
La capa de red está instalada y verificada antes de aplicar la configuración. Tras aplicarla, todos los clientes que actualizan los metadatos reciben la dirección de dominio personalizada. Si los clientes no pueden resolver el dominio personalizado, pierden la conectividad. Asegúrese de que su capa de red esté configurada y que todos los clientes puedan acceder a ella antes de aplicar la configuración. Para ver un recorrido completo y esquemático de la configuración de Network Load Balancer, Route 53 y AWS Certificate Manager, consulte Configurar un nombre de dominio personalizado para su clúster AWS de Amazon
MSK en el blog Big Data.
Migre del modo KrAFT al modo KrAFT ZooKeeper
Si actualmente utiliza el kafka-configs.sh ZooKeeper modo advertised.listeners dinámico, debe configurarlo custom.advertised.listeners en su configuración de Amazon MSK antes de iniciar la migración ZooKeeper al modo KrAFT. La actualización local comprueba si existen anulaciones dinámicas de oyentes anunciadas y existentes. Si detecta alguna, la actualización no se realizará y recibirás un mensaje de error que te pedirá que la elimines primero. Para disfrutar de una experiencia fluida, haz lo siguiente:
-
Añada
custom.advertised.listenersa su configuración de Amazon MSK el mismo patrón de dominio que utiliza en la actualidad. Para averiguar los pasos, consulte Configure un nombre de dominio personalizado de principio a fin. -
Elimine la anulación dinámica ejecutándola
kafka-configs.sh --alter --delete-config advertised.listenersen cada corredor. Esto elimina solo la anulación anunciada por los oyentes y no afecta a otras configuraciones dinámicas. -
Inicie la migración.
Para obtener más información sobre la migración de un clúster al modo KrAFT, consulte. Migre del modo kRafT ZooKeeper al modo KrAFT
