View a markdown version of this page

Amazon MSK 클러스터의 사용자 지정 도메인 이름 구성 - Amazon Managed Streaming for Apache Kafka
사용자 지정 도메인 이름의 작동 방식사전 조건

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

Amazon MSK 클러스터의 사용자 지정 도메인 이름 구성

기본 AWS생성 브로커 주소 대신 사용자 지정 도메인 이름을 알리도록 MSK 프로비저닝 클러스터를 구성할 수 있습니다. 사용자 지정 도메인 이름은 Amazon MSK 구성에서 한 번 정의되며 조정 작업 중에 추가된 새 브로커를 포함하여 클러스터의 모든 브로커에 자동으로 적용됩니다. ZooKeeper 및 KRaft 메타데이터 관리 모드에서 모두 작동합니다.

주제

사용자 지정 도메인 이름의 작동 방식

Amazon MSK 구성에 custom.advertised.listeners 속성을 추가하면 Amazon MSK는 다음을 수행합니다.

  1. 구성(리스너 이름, 형식 및 고유성)을 검증합니다.

  2. 각 브로커의 {broker_id} 템플릿을 해결합니다.

  3. 한 번에 하나의 브로커인 롤링 재시작을 통해 구성을 적용합니다.

속성은 다음 형식을 취합니다.

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

예를 들어 브로커가 3개인 IAM 클러스터의 경우:

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

이렇게 하면 다음 주소로 확인됩니다.

  • 브로커 1: b-1.example.com:9001

  • 브로커 2: b-2.example.com:9002

  • 브로커 3: b-3.example.com:9003

{broker_id} 템플릿 변수는 필수이며 각 브로커가 고유한 주소로 확인되도록 포트에 나타나야 합니다. 연+산자는 브로커 ID를 기본 포트에 추가합니다(9000 + 1 = 9001, 9000 + 2 = 9002, 9000 + 10 = 9010).

클러스터에 여러 클라이언트 대상 리스너가 있는 경우 쉼표로 구분하여 서로 다른 도메인을 할당할 수 있습니다.

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}

각 리스너는 하나의 사용자 지정 도메인에 매핑됩니다. 동일한 리스너에 여러 도메인을 할당할 수 없습니다. 그러나 리스너는 각 도메인 이름이 브로커당 고유한 host:port 조합으로 확인되는 한 동일한 도메인 이름을 공유할 수 있습니다. 예를 들어 두 리스너는 포트별로 공유하고 b-{broker_id}.example.com 다를 수 있습니다.

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

이 동작은 ZooKeeper 및 KRaft 메타데이터 관리 모드에서 동일합니다.

구성을 적용하기 전에 네트워킹 확인

custom.advertised.listeners를 적용하면 사용자 지정 도메인 이름이 재정의된 리스너의 기본 주소를 대체합니다. 따라서 구성을 적용하기 전에 네트워킹 계층을 마련하고 확인해야 합니다. 네트워킹 및 신뢰 계층이 없고, 확인 가능하며, 연결 가능하고, 클라이언트에서 신뢰할 수 없는 경우 클라이언트는 다시 연결할 수 없습니다. 이는 클라이언트가 이전에 연결된 경우에도 마찬가지입니다. 클라이언트가 사용자 지정 도메인을 확인할 수 없는 경우 연결이 끊어집니다.

사전 조건

클러스터에서 사용자 지정 도메인 이름을 구성하기 전에 다음이 true인지 확인합니다.

  • 클러스터는 ACTIVE 상태의 MSK 프로비저닝된 클러스터(Standard 또는 Express 브로커)입니다.

  • 각 리스너는 클러스터의 인증 유형에 해당합니다. , CLIENT, , , CLIENT_SECURE, 및 클라이언트 리스너에 대해서만 사용자 지정 광고 엔드포인트CLIENT_SECURE_PUBLICCLIENT_SASL_SCRAM를 설정할 수 CLIENT_SASL_SCRAM_PUBLIC CLIENT_IAM있습니다CLIENT_IAM_PUBLIC. 내부 리스너(REPLICATION 및 CONTROLLER)는 지원되지 않으며 검증 시 거부됩니다. 지정한 리스너도 클러스터에 바인딩(활성)되어 있어야 합니다. 예를 들어 클러스터가 IAM 인증만 사용하는 경우 지정CLIENT_SECURE이 거부되고 오류 메시지에 클러스터에 유효한 클라이언트 리스너가 나열됩니다.

  • 구성을 적용하기 전에 네트워킹 계층이 마련되어 확인됩니다. 이를 적용하면 메타데이터를 새로 고치는 모든 클라이언트가 사용자 지정 도메인 주소를 받습니다. 클라이언트가 사용자 지정 도메인을 확인할 수 없는 경우 연결이 끊어집니다. 구성을 적용하기 전에 네트워킹 계층이 설정되어 있고 모든 클라이언트에서 연결할 수 있는지 확인합니다. Network Load Balancer, Route 53 및 AWS Certificate Manager 설정에 대한 다이어그램으로 표시된 전체 연습은 AWS 빅 데이터 블로그의 Amazon MSK 클러스터에 대한 사용자 지정 도메인 이름 구성을 참조하세요.