AWS CloudFormation
사용 설명서 (API 버전 2010-05-15)

AWS::ECS::TaskDefinition PortMapping

PortMapping 속성은 포트 매핑을 지정합니다. 포트 매핑은 컨테이너가 호스트 컨테이너 인스턴스의 포트에 액세스하여 트래픽을 송수신하도록 허용합니다. 포트 매핑은 컨테이너 정의의 일부로 지정됩니다.

awsvpc 또는 host 네트워크 모드를 사용하여 작업에 컨테이너를 사용할 경우, containerPort을 사용하여 퍼블릭 포트를 지정해야 합니다. hostPort는 빈 칸으로 둘 수 있습니다. 아니면 containerPort와 같은 값이어야 합니다.

작업이 RUNNING 상태가 되면 DescribeTasks API 응답의 networkBindings 섹션에 수동 및 자동 호스트/컨테이너 포트 할당이 표시됩니다.

구문

AWS CloudFormation 템플릿에서 이 개체를 선언하려면 다음 구문을 사용합니다.

JSON

{ "ContainerPort" : Integer, "HostPort" : Integer, "Protocol" : String }

YAML

ContainerPort: Integer HostPort: Integer Protocol: String

Properties

ContainerPort

사용자 지정 또는 자동 할당된 호스트 포트에 바인딩되는 컨테이너 포트 번호입니다.

awsvpc 또는 host 네트워크 모드를 사용하여 작업에 컨테이너를 사용할 경우, containerPort을 사용하여 퍼블릭 포트를 지정해야 합니다.

bridge 네트워크 모드로 작업의 컨테이너를 사용할 경우 컨테이너 포트는 지정하고 호스트 포트는 지정하지 않으면 컨테이너가 자동으로 임시 포트 범위에서 호스트 포트를 할당받습니다. 자세한 내용은 hostPort 단원을 참조하십시오. 이렇게 자동 할당된 포트 매핑은 컨테이너 인스턴스의 예약 포트 제한 100개에 해당 개수가 포함되지 않습니다.

중요

여러 프로토콜에 동일한 컨테이너 포트를 노출할 수 없습니다. 이렇게 노출하려고 하면 오류가 반환됩니다.

Required: 아니요

Type: 정수

Update requires: Replacement

HostPort

컨테이너용으로 예약할 컨테이너 인스턴스 포트 번호입니다.

작업에서 awsvpc 또는 host 네트워크 모드로 컨테이너를 사용할 경우 hostPort를 비워 두거나, containerPort와 동일한 값으로 설정할 수 있습니다.

작업에서 bridge 네트워크 모드로 컨테이너를 사용하는 경우 컨테이너 포트 매핑에 예약되지 않은 호스트 포트를 지정할 수 있습니다. 또는 hostPort를 지정하고 containerPort는 생략(또는 0으로 설정)할 수도 있습니다. 그러면 컨테이너가 자동으로 컨테이너 인스턴스 운영 체제 및 도커 버전의 임시 포트 범위에서 포트를 할당받습니다.

도커 버전 1.6.0 이상의 기본 휘발성 포트 범위는 인스턴스의 /proc/sys/net/ipv4/ip_local_port_range에 나열됩니다. 이 커널 파라미터를 사용할 수 없을 경우 기본 휘발성 포트 범위 49153-65535가 사용됩니다. 임시 포트 범위는 자동 할당을 위해 예약된 것이므로 여기에서 호스트 포트를 지정하지 마십시오. 일반적으로 32768 미만의 포트는 임시 포트 범위에 해당하지 않습니다.

참고

1.6.0 이전의 도커 버전에는 기본 임시 포트 범위 49153-65535가 항상 사용됩니다.

기본 예약 포트는 SSH용 22, 도커 포트 2375 및 2376, Amazon ECS 컨테이너 에이전트 포트 51678-51680입니다. 이미 실행 작업에 지정된 호스트 포트도 해당 작업이 실행되는 동안 예약됩니다(작업이 중지하면 호스트 포트가 해제됨). 현재 예약된 포트는 DescribeContainerInstances 출력의 remainingResources에 표시됩니다. 하나의 컨테이너 인스턴스는 한 번에 최대 100개의 예약 포트(기본 예약 포트 포함)를 가질 수 있습니다. 자동 할당된 포트는 예약 포트 제한 100개에 포함되지 않습니다.

Required: 아니요

Type: 정수

Update requires: Replacement

Protocol

포트 매핑에 사용되는 프로토콜입니다. 유효한 값은 tcpudp입니다. 기본값은 tcp입니다.

Required: 아니요

Type: 문자열

허용된 값: tcp | udp

Update requires: Replacement

이 페이지에서: