Skip to content

/AWS1/CL_ECSEXPRESSGWCONTAINER

Defines the configuration for the primary container in an Express service. This container receives traffic from the Application Load Balancer and runs your application code.

The container configuration includes the container image, port mapping, logging settings, environment variables, and secrets. The container image is the only required parameter, with sensible defaults provided for other settings.

CONSTRUCTOR

IMPORTING

Required arguments:

iv_image TYPE /AWS1/ECSSTRING /AWS1/ECSSTRING

The image used to start a container. This string is passed directly to the Docker daemon. Images in the Docker Hub registry are available by default. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest.

For Express services, the image typically contains a web application that listens on the specified container port. The image can be stored in Amazon ECR, Docker Hub, or any other container registry accessible to your execution role.

Optional arguments:

iv_containerport TYPE /AWS1/ECSBOXEDINTEGER /AWS1/ECSBOXEDINTEGER

The port number on the container that receives traffic from the load balancer. Default is 80.

io_awslogsconfiguration TYPE REF TO /AWS1/CL_ECSEXPRESSGWSVCAWSL00 /AWS1/CL_ECSEXPRESSGWSVCAWSL00

The log configuration for the container.

io_repositorycredentials TYPE REF TO /AWS1/CL_ECSEXPRESSGWREPOCREDS /AWS1/CL_ECSEXPRESSGWREPOCREDS

The configuration for repository credentials for private registry authentication.

it_command TYPE /AWS1/CL_ECSSTRINGLIST_W=>TT_STRINGLIST TT_STRINGLIST

The command that is passed to the container.

it_environment TYPE /AWS1/CL_ECSKEYVALUEPAIR=>TT_ENVIRONMENTVARIABLES TT_ENVIRONMENTVARIABLES

The environment variables to pass to the container.

it_secrets TYPE /AWS1/CL_ECSSECRET=>TT_SECRETLIST TT_SECRETLIST

The secrets to pass to the container.


Queryable Attributes

image

The image used to start a container. This string is passed directly to the Docker daemon. Images in the Docker Hub registry are available by default. Other repositories are specified with either repository-url/image:tag or repository-url/image@digest.

For Express services, the image typically contains a web application that listens on the specified container port. The image can be stored in Amazon ECR, Docker Hub, or any other container registry accessible to your execution role.

Accessible with the following methods

Method Description
GET_IMAGE() Getter for IMAGE, with configurable default
ASK_IMAGE() Getter for IMAGE w/ exceptions if field has no value
HAS_IMAGE() Determine if IMAGE has a value

containerPort

The port number on the container that receives traffic from the load balancer. Default is 80.

Accessible with the following methods

Method Description
GET_CONTAINERPORT() Getter for CONTAINERPORT, with configurable default
ASK_CONTAINERPORT() Getter for CONTAINERPORT w/ exceptions if field has no value
HAS_CONTAINERPORT() Determine if CONTAINERPORT has a value

awsLogsConfiguration

The log configuration for the container.

Accessible with the following methods

Method Description
GET_AWSLOGSCONFIGURATION() Getter for AWSLOGSCONFIGURATION

repositoryCredentials

The configuration for repository credentials for private registry authentication.

Accessible with the following methods

Method Description
GET_REPOSITORYCREDENTIALS() Getter for REPOSITORYCREDENTIALS

command

The command that is passed to the container.

Accessible with the following methods

Method Description
GET_COMMAND() Getter for COMMAND, with configurable default
ASK_COMMAND() Getter for COMMAND w/ exceptions if field has no value
HAS_COMMAND() Determine if COMMAND has a value

environment

The environment variables to pass to the container.

Accessible with the following methods

Method Description
GET_ENVIRONMENT() Getter for ENVIRONMENT, with configurable default
ASK_ENVIRONMENT() Getter for ENVIRONMENT w/ exceptions if field has no value
HAS_ENVIRONMENT() Determine if ENVIRONMENT has a value

secrets

The secrets to pass to the container.

Accessible with the following methods

Method Description
GET_SECRETS() Getter for SECRETS, with configurable default
ASK_SECRETS() Getter for SECRETS w/ exceptions if field has no value
HAS_SECRETS() Determine if SECRETS has a value