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

Kinesis Video Streams에서 IPv6 사용

제어 영역 및 데이터 영역 작업 모두에 IPv6를 사용하도록 Kinesis Video Streams를 구성할 수 있습니다. 이를 통해 애플리케이션은 듀얼 스택 엔드포인트를 통해 IPv6 주소를 사용하여 Kinesis Video Streams 서비스와 통신할 수 있습니다.

Kinesis Video Streams는 생산자와 소비자 애플리케이션 모두에 대해 듀얼 스택 엔드포인트를 통해 IPv6를 지원합니다. 컨트롤 플레인 API 호출 및 데이터 플레인 스트리밍 작업에 IPv6를 사용하도록 애플리케이션을 구성할 수 있습니다.

IPv6용 AWS SDK 구성

AWS SDK를 사용하여 프로덕션 설정에서 Kinesis Video Streams 컨트롤 플레인 APIs 호출하는 경우 듀얼 스택 엔드포인트를 구성하여 IPv6를 활성화할 수 있습니다. AWS SDK는 듀얼 스택 엔드포인트를 활성화하는 여러 가지 표준화된 방법을 제공합니다.

환경 변수 사용

IPv6 듀얼 스택 엔드포인트를 활성화하려면 다음 환경 변수를 설정합니다.

export AWS_USE_DUALSTACK_ENDPOINT=true

AWS 구성 파일 사용

AWS 구성 파일(~/.aws/config)에 다음 설정을 추가합니다.

[default]
use_dualstack_endpoint = true

JVM 시스템 속성 사용(Java 및 Kotlin SDKs만 해당)

Java 및 Kotlin 애플리케이션의 경우 다음 JVM 시스템 속성을 설정합니다.

-Daws.useDualstackEndpoint=true

또는 Java 코드에서 프로그래밍 방식으로 다음을 수행할 수 있습니다.

System.setProperty("aws.useDualstackEndpoint", "true");

SDK 지원

다음 AWS SDKs 지원합니다.

듀얼 스택 엔드포인트를 구성한 후 AWS SDK는 Kinesis Video Streams 컨트롤 플레인 APIs를 호출할 때 IPv6 엔드포인트를 자동으로 사용합니다.

IPv6용 Kinesis Video Streams 생산자 SDK 구성

Kinesis Video Streams 생산자 SDK는 컨트롤 플레인 및 데이터 플레인 작업 모두에 대한 IPv6 구성 옵션을 제공합니다. 이러한 설정은 AWS SDK 듀얼 스택 엔드포인트 구성에서 작동합니다.

C/C++ 생산자 SDK 구성

기본 엔드포인트 및 DNS 확인 체인은 KVS Producer-C SDK 버전 1.6.0에서 구현됩니다. 이러한 파라미터에 대한 구성을 설정할 수 있는 각 위치를 순차적으로 확인한 다음 설정한 첫 번째 위치를 선택합니다. 사전 정의된 시퀀스는 다음과 같습니다.

생산자 SDKs에 대한 자세한 내용은 생산자 SDK for C, 생산자 SDK for C++ 및 생산자 SDK 관련 주제를 참조하세요.

엔드포인트 구성

2, 3, 4의 경우 엔드포인트는에 제공된 리전을 기반으로 구성됩니다createAbstractDefaultCallbacksProvider.

DNS 필터링

KVS 생산자 SDK는 구성에 따라 적절한 CURLOPT_IPRESOLVE 파라미터를 설정합니다.

C++ 생산자 SDK 버전 3.5.0은 KVS API 호출에 생산자-C SDK 1.6.0을 사용합니다.

GStreamer 플러그인 구성

GStreamer 플러그인은 기본 C 생산자 SDK를 사용하므로 앞서 설명한 대로 IPv6용 C SDK를 구성할 때 IPv6 구성이 자동으로 처리됩니다.

코드 수정은 필요하지 않습니다. CMake 파라미터를 사용하여 SDK를 빌드하거나 이전 섹션에 설명된 대로 적절한 환경 변수를 설정하기만 하면 됩니다.

데이터 영역 엔드포인트 해상도

데이터 영역 작업의 경우 GetDataEndpoint API를 사용하여 적절한 듀얼 스택 데이터 영역 엔드포인트를 검색합니다. 서비스는 요청 URL에 따라 해당 엔드포인트를 반환합니다.

예제:

IPv6 AWS CLI 용 구성

Kinesis Video Streams 작업(일반적으로 proof-of-concept 작업) AWS CLI 에를 사용하는 경우 듀얼 스택 엔드포인트를 구성하여 IPv6를 활성화할 수 있습니다.

환경 변수 사용

export AWS_USE_DUALSTACK_ENDPOINT=true

AWS 구성 파일 사용

AWS CLI 구성 파일(~/.aws/config)에 다음을 추가합니다.

[default]
use_dualstack_endpoint = true

구성 예제

C SDK 예제

IPV6-only 모드에서 KVS Producer-C SDK를 빌드하고 환경 변수 구성을 무시하려면 다음 명령을 사용하여 SDK를 빌드합니다.

cmake .. -DAWS_KVS_USE_DUAL_STACK_ENDPOINT_ONLY=TRUE -DAWS_KVS_IPV6_ONLY=TRUE
make -j

고려 사항

네트워크 요구 사항

SDK 호환성

테스트 및 검증

IPv6-enabled Kinesis Video Streams 애플리케이션을 프로덕션에 배포하기 전에:

IPv6로 업그레이드 시 영향을 받는 고객

Kinesis Video Streams용 IPv6를 활성화하면 몇 가지 영역에서 기존 구성 및 정책을 업데이트하여 지속적인 기능을 보장해야 할 수 있습니다.

IAM 정책 및 IP 주소 필터링

IAM 사용자 정책, 역할 정책 또는 리소스 기반 정책에서 소스 IP 주소 필터링을 사용하는 경우 IPv6 주소 범위를 포함하도록 이러한 정책을 업데이트해야 합니다.

IPv6에 대한 IAM 정책 업데이트 예:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": "*",
      "Action": "kinesisvideo:*",
      "Resource": "*",
      "Condition": {
        "IpAddress": {
          "aws:SourceIp": [
            "192.0.2.0/24",
            "203.0.113.0/24",
            "2001:db8::/32"
          ]
        }
      }
    }
  ]
}

로깅 및 모니터링

IPv6 주소는 IPv4 주소와 형식이 다르므로 로깅, 모니터링 및 분석 시스템에 영향을 미칠 수 있습니다.

로그

IPv6를 통해 요청하면 sourceIPAddress 필드에 IPv6 주소가 로그에 포함됩니다. IPv6 주소 형식을 처리하도록 로그 구문 분석 도구 및 스크립트를 업데이트합니다.

로그의 IPv6 주소 예:

{
  "sourceIPAddress": "2001:db8::1",
  "eventName": "CreateStream",
  "eventSource": "kinesisvideo.amazonaws.com"
}

문제 해결

일반적인 문제

확인 단계

구성 검증

다음을 확인하여 듀얼 스택 엔드포인트 구성을 확인할 수 있습니다.