Amazon ECS container agent

The Amazon ECS container agent allows container instances to connect to your cluster. The Amazon ECS container agent is included in the Amazon ECS-optimized AMIs, but you can also install it on any Amazon EC2 instance that supports the Amazon ECS specification. The Amazon ECS container agent is only supported on Amazon EC2 instances.

The source code for the Amazon ECS container agent is available on GitHub. We encourage you to submit pull requests for changes that you would like to have included. However, Amazon Web Services does not currently support running modified copies of this software.

Note

For tasks using the Fargate launch type and platform version 1.3.0 and prior, the Amazon ECS container agent is installed on the AWS managed infrastructure used for these tasks. If you are only using tasks with the Fargate launch type, no additional configuration is needed and the content in this topic does not apply. For tasks using the Fargate and platform version 1.4.0 and later, the Fargate container agent is used. For more information, see AWS Fargate platform versions in the Amazon Elastic Container Service User Guide for AWS Fargate.

Topics

• Installing the Amazon ECS container agent
• Amazon ECS container agent versions
• Updating the Amazon ECS container agent
• Amazon ECS container agent configuration
• Private registry authentication for container instances
• Automated task and image cleanup
• Amazon ECS container metadata file
• Amazon ECS task metadata endpoint
• Amazon ECS container agent introspection
• HTTP proxy configuration