View a markdown version of this page

Configura nomi di dominio personalizzati per il tuo cluster Amazon MSK - Amazon Managed Streaming per Apache Kafka
Come funzionano i nomi di dominio personalizzatiPrerequisitiMigrare dalla modalità KRAFT ZooKeeper

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Configura nomi di dominio personalizzati per il tuo cluster Amazon MSK

È possibile configurare il cluster MSK Provisioned per pubblicizzare nomi di dominio personalizzati anziché gli indirizzi dei broker generati di default AWS. I nomi di dominio personalizzati vengono definiti una sola volta nella configurazione di Amazon MSK e applicati automaticamente a tutti i broker del cluster, inclusi i nuovi broker aggiunti durante le operazioni di scalabilità. Funziona sia in modalità di gestione dei metadati che in modalità di ZooKeeper gestione dei metadati di Kraft.

Argomenti

Come funzionano i nomi di dominio personalizzati

Quando aggiungi la custom.advertised.listeners proprietà alla tua configurazione Amazon MSK, Amazon MSK esegue le seguenti operazioni:

  1. Convalida la configurazione (nome, formato e unicità del listener).

  2. Risolve il modello per ogni broker{broker_id}.

  3. Applica la configurazione tramite un riavvio progressivo, un broker alla volta.

La proprietà assume il formato seguente.

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

Ad esempio, su un cluster IAM con tre broker:

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

Questo si risolve nei seguenti indirizzi:

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

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

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

La variabile {broker_id} template è obbligatoria e deve apparire nella porta in modo che ogni broker risponda a un indirizzo univoco. L'+operatore aggiunge l'ID del broker alla porta di base (9000 + 1 = 9001, 9000 + 2 = 9002, 9000 + 10 = 9010).

Se il cluster dispone di più listener rivolti ai clienti, puoi assegnare un dominio diverso a ciascuno separandoli con virgole.

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}

Ogni listener esegue il mapping su un dominio personalizzato. Non puoi assegnare più domini allo stesso listener. Tuttavia, i listener possono condividere lo stesso nome di dominio purché ognuno di essi si risolva in una combinazione unica per broker. host:port Ad esempio, due listener possono condividere b-{broker_id}.example.com e differire solo in base alla porta.

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

Questo comportamento è identico nella modalità di ZooKeeper gestione dei metadati Kraft.

Verificate la rete prima di applicare la configurazione

Quando effettui la richiestacustom.advertised.listeners, il nome di dominio personalizzato sostituisce gli indirizzi predefiniti per il listener sovrascritto. Pertanto, il livello di rete deve essere installato e verificato prima di applicare la configurazione. Se il livello di rete e affidabilità non è presente, risolvibile, raggiungibile e affidabile dal client, il client non può riconnettersi. Questo è vero anche se il client era connesso qualche istante prima. Se i client non riescono a risolvere il dominio personalizzato, perdono la connettività.

Prerequisiti

Prima di configurare nomi di dominio personalizzati sul cluster, assicurati che sia vero quanto segue:

  • Il cluster è un cluster MSK Provisioned (broker Standard o Express) nello stato. ACTIVE

  • Ogni listener corrisponde a un tipo di autenticazione sul cluster. Puoi impostare endpoint pubblicizzati personalizzati solo per i client listener:CLIENT,,,, CLIENT_SECURE CLIENT_SECURE_PUBLICCLIENT_SASL_SCRAM, CLIENT_SASL_SCRAM_PUBLIC e. CLIENT_IAM CLIENT_IAM_PUBLIC I listener interni (REPLICATIONandCONTROLLER) non sono supportati e vengono rifiutati al momento della convalida. Il listener specificato deve inoltre essere associato (attivo) al cluster. Ad esempio, se il cluster utilizza solo l'autenticazione IAM, la specifica CLIENT_SECURE viene rifiutata e il messaggio di errore elenca i client listener validi per il cluster.

  • Il livello di rete è pronto e verificato prima di applicare la configurazione. Dopo averlo applicato, tutti i client che aggiornano i metadati ricevono l'indirizzo di dominio personalizzato. Se i client non riescono a risolvere il dominio personalizzato, perdono la connettività. Assicurati che il livello di rete sia configurato e raggiungibile da tutti i client prima di applicare la configurazione. Per una panoramica completa e schematica della configurazione di Network Load Balancer, Route 53 e Certificate AWS Manager, consulta Configurare un nome di dominio personalizzato per il cluster Amazon MSK sul Big Data Blog. AWS

Esegui la migrazione dalla modalità KRAFT ZooKeeper

Se attualmente utilizzi la ZooKeeper modalità kafka-configs.sh di impostazione advertised.listeners dinamica, devi eseguire l'impostazione custom.advertised.listeners nella configurazione di Amazon MSK prima di iniziare la migrazione dalla ZooKeeper modalità Kraft. L'aggiornamento in loco verifica la presenza di sostituzioni dinamiche dei listener pubblicizzati esistenti. Se ne rileva uno, l'aggiornamento non procede e viene visualizzato un messaggio di errore che richiede di rimuoverli prima. Per un'esperienza senza interruzioni, procedi come segue:

  1. Aggiungilo custom.advertised.listeners alla tua configurazione Amazon MSK con lo stesso modello di dominio che usi oggi. Per la procedura, consultare Imposta un nome di dominio personalizzato dall'inizio alla fine.

  2. Rimuovi l'override dinamico eseguendolo kafka-configs.sh --alter --delete-config advertised.listeners su ogni broker. Ciò rimuove solo l'override degli ascoltatori pubblicizzati e non influisce su altre configurazioni dinamiche.

  3. Avvia la migrazione.

Per ulteriori informazioni sulla migrazione di un cluster alla modalità Kraft, vedere. Esegui la migrazione dalla modalità ZooKeeper KRAFT