AWS::ECS::TaskDefinition EnvironmentFile - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

AWS::ECS::TaskDefinition EnvironmentFile

A list of files containing the environment variables to pass to a container. You can specify up to ten environment files. The file must have a .env file extension. Each line in an environment file should contain an environment variable in VARIABLE=VALUE format. Lines beginning with # are treated as comments and are ignored. For more information about the environment variable file syntax, see Declare default environment variables in file.

If there are environment variables specified using the environment parameter in a container definition, they take precedence over the variables contained within an environment file. If multiple environment files are specified that contain the same variable, they're processed from the top down. We recommend that you use unique variable names. For more information, see Specifying environment variables in the Amazon Elastic Container Service Developer Guide.

This parameter is only supported for tasks hosted on Fargate using the following platform versions:

  • Linux platform version 1.4.0 or later.

  • Windows platform version 1.0.0 or later.


To declare this entity in your Amazon CloudFormation template, use the following syntax:


{ "Type" : String, "Value" : String }


Type: String Value: String



The file type to use. The only supported value is s3.

Required: No

Type: String

Allowed values: s3

Update requires: Replacement


The Amazon Resource Name (ARN) of the Amazon S3 object containing the environment variable file.

Required: No

Type: String

Update requires: Replacement