듀얼 스택 네트워크 유형 구성

Amazon MSK는 Kafka 버전 3.6.0 이상을 사용하는 기존 MSK Serverless 클러스터에 대해 추가 비용 없이 듀얼 스택 네트워크 유형을 지원합니다. 듀얼 스택 네트워킹을 사용하면 클러스터가 IPv4 및 IPv6 주소를 모두 사용할 수 있습니다. 듀얼 스택 엔드포인트는 IPv4도 지원하므로 이전 버전과의 호환성을 유지합니다. Amazon MSK는 IPv6 IPv6-only 지원을 제공합니다.

기본적으로 클라이언트는 IPv4 네트워크 유형을 사용하여 Amazon MSK 클러스터에 연결합니다. 생성하는 모든 새 클러스터도 기본적으로 IPv4를 사용합니다. 클러스터의 네트워크 유형을 듀얼 스택으로 업데이트하려면 다음 섹션에 설명된 사전 조건을 충족했는지 확인합니다. 그런 다음 UpdateConnectivity API를 사용하여 듀얼 스택에 대한 연결을 업데이트합니다.

참고

듀얼 스택 네트워크 유형을 사용하도록 클러스터를 업데이트한 후에는 IPv4 네트워크 유형으로 다시 전환할 수 없습니다.

듀얼 스택 네트워크 유형을 사용하기 위한 사전 조건

클러스터에 대해 듀얼 스택 네트워크 유형을 구성하기 전에 클러스터 생성 중에 제공하는 모든 서브넷이 듀얼 스택 네트워크 유형을 지원해야 합니다. 클러스터의 서브넷 하나가 듀얼 스택을 지원하지 않는 경우 클러스터의 네트워크 유형을 듀얼 스택으로 업데이트할 수 없습니다.

MSK Serverless에 대한 IAM 권한

이 경우 다음 IAM 권한이 있어야 합니다.

• ec2:DescribeSubnets

• ec2:ModifyVpcEndpoint

모든 Amazon MSK 작업을 수행하는 데 필요한 권한의 전체 목록은 관리형 정책: AmazonMSKFullAccess를 참조 AWS 하세요. AmazonMSKFullAccess

클러스터에 듀얼 스택 네트워크 유형 사용

AWS Management Console AWS CLI또는 AWS SDK를 사용하여 MSK Serverless 클러스터의 네트워크 유형을 업데이트할 수 있습니다.

Using AWS Management Console

1. https://console.aws.amazon.com/msk/home?region=us-east-1#/home/에서 Amazon MSK 콘솔을 엽니다.

2. 듀얼 스택 네트워크 유형을 구성할 MSK Serverless 클러스터를 선택합니다.

3. 클러스터 세부 정보 페이지에서 속성을 선택합니다.

4. 네트워크 설정에서 네트워크 유형 편집을 선택합니다.

5. 네트워크 유형에서 듀얼 스택을 선택합니다.

6. 변경 사항 저장을 선택합니다.

Using AWS CLI

update-connectivity API를 사용하여 기존 MSK Serverless 클러스터의 네트워크 유형을 듀얼 스택으로 업데이트할 수 있습니다. 다음 예제에서는 update-connectivity 명령을 사용하여 클러스터의 네트워크 유형을 듀얼 스택으로 설정합니다.

다음 예제에서 샘플 클러스터 ARN인 arn:aws:kafka:us-east-1: 123456789012:cluster/myCluster /12345678-1234-1234-1234-123456789012 -1을 실제 MSK 클러스터 ARN으로 바꿉니다. 현재 클러스터 버전을 가져오려면 describe-cluster 명령을 사용합니다.

aws kafka update-connectivity \
    --cluster-arn "arn:aws:kafka:us-east-1:123456789012:cluster/myCluster/12345678-1234-1234-1234-123456789012-1" \
    --current-version "KTVPDKIKX0DER" \
    --connectivity-info '{
        "networkType": "DUAL"
    }

Using AWS SDK

다음 예제에서는 UpdateConnectivity API를 사용하여 클러스터의 네트워크 유형을 듀얼 스택으로 설정합니다.

다음 예제에서 샘플 클러스터 ARN인 arn:aws:kafka:us-east-1:123456789012:cluster/myCluster/12345678-1234-1234-1234-123456789012-1을 실제 MSK 클러스터 ARN으로 바꿉니다. 현재 클러스터 버전을 가져오려면 DescribeCluster API를 사용합니다.

import boto3

client = boto3.client("kafka")

response = client.update_connectivity(
    ClusterArn="arn:aws:kafka:us-east-1:123456789012:cluster/myCluster/12345678-1234-1234-1234-123456789012-1",
    CurrentVersion="KTVPDKIKX0DER",
    ConnectivityInfo={
        "NetworkType": "DUAL"
    }
)
print("Connectivity update initiated:", response)

듀얼 스택 네트워크 유형 사용에 대한 고려 사항

• IPv6 지원은 현재 IPv6 전용이 아닌 듀얼 스택 모드(IPv4 + IPv6-only)에서만 사용할 수 있습니다.

• 다중 VPC 프라이빗 연결에는 듀얼 스택 네트워크 유형을 사용할 수 없습니다.

• 모든 서브넷이 듀얼 스택 네트워크 유형을 지원하는 경우에만 기존 클러스터의 네트워크 유형을 IPv4에서 듀얼 스택으로 변경할 수 있습니다.

• 듀얼 스택을 활성화한 후에는 IPv4 네트워크 유형으로 되돌릴 수 없습니다. 다시 전환하려면 클러스터를 삭제하고 다시 생성해야 합니다.

• 이 경우 다음 IAM 권한이 있어야 합니다.

  • ec2:DescribeSubnets 및 ec2:ModifyVpcEndpoint