hostPort property
The port number on the container instance to reserve for your container.
If you are using containers in a task with the awsvpc
or
host
network mode, the hostPort
can either be left
blank or set to the same value as the containerPort
.
If you are using containers in a task with the bridge
network
mode, you can specify a non-reserved host port for your container port
mapping, or you can omit the hostPort
(or set it to
0
) while specifying a containerPort
and your
container automatically receives a port in the ephemeral port range for your
container instance operating system and Docker version.
The default ephemeral port range for Docker version 1.6.0 and later is
listed on the instance under
/proc/sys/net/ipv4/ip_local_port_range
. If this kernel
parameter is unavailable, the default ephemeral port range from 49153
through 65535 is used. Do not attempt to specify a host port in the
ephemeral port range as these are reserved for automatic assignment. In
general, ports below 32768 are outside of the ephemeral port range.
The default reserved ports are 22 for SSH, the Docker ports 2375 and 2376,
and the Amazon ECS container agent ports 51678-51680. Any host port that was
previously specified in a running task is also reserved while the task is
running (after a task stops, the host port is released). The current
reserved ports are displayed in the remainingResources
of
DescribeContainerInstances output. A container instance can have up
to 100 reserved ports at a time, including the default reserved ports.
Automatically assigned ports don't count toward the 100 reserved ports
limit.
Implementation
final int? hostPort;