Skip to main content
Version: Next


Table to manage AWS ECS container definitions. Container definitions are used in task definitions to describe the different containers that are launched as part of a task.


image > repository > publicRepository digest > tag > null


Optional container_port: number

Port to expose at container level


Optional cpu: number

The number of cpu units reserved for the container.


Optional digest: string

The sha-256 digest of the used image. Either tag or digest needs to be specified


env_variables: Object

Complex type to specify a list of environment variables that the container can consume


Type definition

[key: string]: string

essential: boolean

If the essential parameter of a container is marked as true, and that container fails or stops for any reason, all other containers that are part of the task are stopped. If the essential parameter of a container is marked as false, its failure doesn't affect the rest of the containers in a task. If this parameter is omitted, a container is assumed to be essential.


Optional host_port: number

Port to expose at host level. It can be left blank depending on the networking mode


Optional image: string

The image used to start the container


Optional log_group: log_group

The log group where to render the container logs


Optional memory: number

The amount (in MiB) of memory to present to the container.


Optional memory_reservation: number

The soft limit (in MiB) of memory to reserve for the container.


name: string

Name of the container definition

Optional protocol: transport_protocol

The protocol for the exposed ports


Optional public_repository: public_repository

Reference to the public repository where this image is hosted

region: string

Region for the container definition

Optional repository: repository

Reference of the repository where this image is hosted

Optional tag: string

The tag for the image used to start the container


task_definition: task_definition

Reference of the associated task definition