View a markdown version of this page

직접 Apache ZooKeeper 클라이언트 액세스 비활성화 또는 활성화 - Amazon Managed Streaming for Apache Kafka

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

직접 Apache ZooKeeper 클라이언트 액세스 비활성화 또는 활성화

Amazon MSK 프로비저닝 클러스터에서 직접 Apache ZooKeeper 클라이언트 액세스를 비활성화하여 애플리케이션이 직접 ZooKeeper 연결에 의존하지 않는지 확인할 수 있습니다. ZooKeeper 액세스가 비활성화되면 클라이언트는 더 이상 포트 2181(일반 텍스트) 및 2182(TLS)의 Apache ZooKeeper 노드에 연결할 수 없습니다. 언제든지 ZooKeeper 액세스를 다시 활성화할 수 있습니다.

참고

이 기능은 표준 브로커와 함께 ZooKeeper 메타데이터 모드를 사용하는 Amazon MSK 프로비저닝 클러스터에서만 사용할 수 있습니다. 다음 클러스터 유형에는 사용할 수 없습니다.

  • KRaft 메타데이터 모드에서 실행되는 클러스터

  • Express 브로커를 사용하는 클러스터. ZooKeeper 액세스는 Express 클러스터에서 자동으로 관리되며 수동으로 구성할 수 없습니다.

  • Amazon MSK Serverless 클러스터

콘솔을 사용하여 ZooKeeper 액세스 비활성화

  1. 에 로그인 AWS Management Console하고 https://console.aws.amazon.com/msk/home Amazon MSK 콘솔을 엽니다.region=us-east-1#/home/.

  2. 클러스터 목록에서 ZooKeeper 액세스를 비활성화할 클러스터를 선택합니다.

  3. 속성 탭을 선택한 다음 네트워크 설정 섹션을 찾습니다.

  4. ZooKeeper 액세스 비활성화를 선택합니다.

를 사용하여 ZooKeeper 액세스 비활성화 AWS CLI

  1. 다음 AWS CLI 명령을 실행하여 ClusterArn 및 Current-Cluster-Version을 클러스터의 ARN 및 현재 버전으로 바꿉니다. 클러스터의 현재 버전을 찾으려면 DescribeCluster 작업 또는 describe-cluster AWS CLI 명령을 사용합니다. 버전의 예를 들면 KTVPDKIKX0DER입니다.

    aws kafka update-connectivity --cluster-arn ClusterArn --current-version Current-Cluster-Version --zookeeper-access '{"Enabled": false}'

    이 update-connectivity 명령의 출력은 다음 JSON 예제와 같습니다.

    {
    "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
    "ClusterOperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef"
}
    참고

    ZooKeeper 액세스를 다시 활성화하려면 --zookeeper-access 대신에 대해 다음 값과 유사한 AWS CLI 명령을 사용합니다.

    '{"Enabled": true}'

  2. update-connectivity 작업 결과를 가져오려면 다음 명령을 실행하여 ClusterOperationArn을 update-connectivity 명령의 출력에서 가져온 ARN으로 바꿉니다.

    aws kafka describe-cluster-operation --cluster-operation-arn ClusterOperationArn

    이 describe-cluster-operation 명령의 출력은 다음 JSON 예제와 같습니다.

    {
    "ClusterOperationInfo": {
        "ClientRequestId": "982168a3-939f-11e9-8a62-538df00285db",
        "ClusterArn": "arn:aws:kafka:us-east-1:012345678012:cluster/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2",
        "CreationTime": "2026-01-15T21:08:57.735Z",
        "OperationArn": "arn:aws:kafka:us-east-1:012345678012:cluster-operation/exampleClusterName/abcdefab-1234-abcd-5678-cdef0123ab01-2/0123abcd-abcd-4f7f-1234-9876543210ef",
        "OperationState": "UPDATE_COMPLETE",
        "OperationType": "UPDATE_CONNECTIVITY",
        "SourceClusterInfo": {
            "ZookeeperAccess": {
                "Enabled": true
            }
        },
        "TargetClusterInfo": {
            "ZookeeperAccess": {
                "Enabled": false
            }
        }
    }
}

    OperationState 값이 UPDATE_IN_PROGRESS인 경우, 잠시 기다린 다음 describe-cluster-operation 명령을 다시 실행합니다.

Amazon MSK API를 사용하여 ZooKeeper 액세스 비활성화

  • API를 사용하여 클러스터에서 ZooKeeper 액세스를 비활성화하거나 활성화하려면 UpdateConnectivity를 참조하세요.