NetworkMode

class aws_cdk.aws_ecs.NetworkMode(value)

Bases: Enum

The networking mode to use for the containers in the task.

ExampleMetadata:

infused

Example:

ec2_task_definition = ecs.Ec2TaskDefinition(self, "TaskDef",
    network_mode=ecs.NetworkMode.BRIDGE
)

container = ec2_task_definition.add_container("WebContainer",
    # Use an image from DockerHub
    image=ecs.ContainerImage.from_registry("amazon/amazon-ecs-sample"),
    memory_limit_mi_b=1024
)

Attributes

AWS_VPC

The task is allocated an elastic network interface.

BRIDGE

The task utilizes Docker’s built-in virtual network which runs inside each container instance.

HOST

The task bypasses Docker’s built-in virtual network and maps container ports directly to the EC2 instance’s network interface directly.

In this mode, you can’t run multiple instantiations of the same task on a single container instance when port mappings are used.

NAT

The task utilizes NAT network mode required by Windows containers.

This is the only supported network mode for Windows containers. For more information, see Task Definition Parameters.

NONE

The task’s containers do not have external connectivity and port mappings can’t be specified in the container definition.