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à.
Imposta un nome di dominio personalizzato dall'inizio alla fine
Questo argomento illustra la configurazione lato cluster per i nomi di dominio personalizzati. Il livello di rete (certificato Network Load Balancer, DNS e TLS) è un prerequisito di tua proprietà ed è trattato in dettaglio nella sezione Configurare un nome di dominio personalizzato per il tuo cluster Amazon MSK
Verifica 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. Il livello di rete deve essere installato e verificato prima di applicare la configurazione. Se i client non riescono a risolvere il dominio personalizzato, perdono la connettività.
Passaggio 1: aggiungi il dominio personalizzato alla tua configurazione Amazon MSK
Crea o aggiorna una configurazione Amazon MSK che includa la custom.advertised.listeners proprietà, che corrisponda ai nomi host e alle porte che hai fornito sul Network Load Balancer. Per un cluster IAM a tre broker gestito da un Network Load Balancer con porte 9001—9003, inserisci la proprietà in un file.
custom.advertised.listeners=CLIENT_IAM://b-{broker_id}.example.com:9000+{broker_id}Quindi crea la configurazione, passando il file come proprietà del server.
aws kafka create-configuration \ --name "custom-domain-iam" \ --description "Custom advertised listeners for CLIENT_IAM" \ --server-properties fileb://custom-domain-config.txt
Usa fileb:// (notfile://) in modo che AWS CLI legga il file come byte e lo codifichi in base64. Il passaggio del valore in linea è fragile a causa delle parentesi. {broker_id} Lascia il {broker_id} valore letterale nel file, perché Amazon MSK lo risolve per broker al momento della richiesta. La risposta restituisce la configurazione Arn eLatestRevision.Revision, che utilizzerai nel passaggio successivo.
Passaggio 2: applicare la configurazione
Applica la configurazione al cluster conUpdateClusterConfiguration, utilizzando la console, AWS CLI AWS CloudFormation, AWS CDK o Terraform. Questo è lo stesso flusso di lavoro che utilizzi già per le modifiche alla configurazione del broker.
aws kafka update-cluster-configuration \ --cluster-arnyour-cluster-arn\ --configuration-info arn=configuration-arn,revision=revision\ --current-versioncurrent-cluster-version
Usa l'DescribeClusteroperazione per trovare la versione corrente del tuo cluster. Le versioni del cluster non sono interi semplici.
Amazon MSK convalida la configurazione in modo sincrono prima di applicare qualsiasi cosa, in modo che un valore non valido non raggiunga mai i tuoi broker. Amazon MSK rifiuta una configurazione non valida con un errore HTTP 400. Per esempi di errori, vedi. Errori di configurazione del nome di dominio personalizzato Risolvete il problema segnalato e riapplicatelo.
Fase 3: Tieni traccia del rollout
aws kafka describe-cluster-operation-v2 \ --cluster-operation-arnoperation-arn
Dopo che la configurazione è stata accettata, Amazon MSK la applica tramite un riavvio progressivo. Attendi che l'operazione venga UPDATE_COMPLETE segnalata. Se segnalaUPDATE_FAILED, un broker non potrebbe applicare la modifica. L'implementazione si interrompe presso quel broker, i broker rimanenti mantengono la configurazione precedente e puoi correggere la configurazione e riapplicarla per ripristinarla.
Fase 4: verifica
Verifica che i client possano connettersi tramite il dominio personalizzato elencando gli argomenti di un client che utilizza le impostazioni di autenticazione per il tuo listener.
Se riesci a elencare gli argomenti tramite l'endpoint del dominio personalizzato, i client si connettono correttamente tramite il tuo dominio personalizzato. Se l'operazione è stata segnalata UPDATE_COMPLETE ma i client non riescono a connettersi, la configurazione lato cluster è corretta, ma è probabile che il livello di rete richieda attenzione. Verifica quanto segue:
-
Percorso di rete: verifica che la regola Network Load Balancer listener, target group e security group esista per il broker e la porta utilizzati dal client e che il Network Load Balancer sia raggiungibile dalla rete del client.
-
Risoluzione DNS: verifica che il dominio personalizzato si risolva nel Network Load Balancer da ogni rete su cui sono in esecuzione i client Apache Kafka.
-
Certificato: verifica che il certificato TLS di Network Load Balancer copra il nome host del broker risolto (tramite il nome comune o un nome alternativo del soggetto) e che il client si fidi della CA (principale e intermedia per una CA privata).
Best practice
Dopo aver impostato i nomi di dominio personalizzati utilizzando i passaggi precedenti, ti consigliamo di rimuovere qualsiasi override dinamico eseguendoli su ogni brokeradvertised.listeners. kafka-configs.sh --alter --delete-config advertised.listeners Ciò rimuove solo l'override dei listener pubblicizzati e non influisce su altre configurazioni dinamiche.
Scalabilità e sostituzione del broker
Quando si ridimensiona il cluster o si sostituisce un broker durante la correzione automatica, Amazon MSK applica automaticamente la configurazione al nuovo broker. Amazon MSK utilizza {broker_id} l'ID del broker, senza passaggi manuali sul lato del cluster.
Nota
Aggiungi il listener Network Load Balancer, il gruppo target e il record DNS corrispondenti per ogni nuovo broker. Il livello di rete non viene scalato automaticamente.
Rimuovi un dominio personalizzato
Per ripristinare gli MSK-generated indirizzi Amazon predefiniti, rimuovi la custom.advertised.listeners proprietà dalla tua configurazione Amazon MSK e applica la configurazione aggiornata utilizzando. UpdateClusterConfiguration Amazon MSK esegue un riavvio progressivo e i broker tornano a pubblicizzare i loro indirizzi originali. Assicurati che i tuoi clienti possano raggiungere gli MSK-generated indirizzi Amazon originali prima di rimuovere la configurazione personalizzata del dominio.
