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 supported on Amazon EC2 instances and external instances (on-premises server or VM). For more information about external instances, see Updating the Amazon ECS agent on an external instance.

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 (for Linux ) or 1.0.0 or later (for Windows), 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 Linux container agent versions
• Amazon EC2 Windows containers
• 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 endpoint
• Amazon ECS container agent introspection
• HTTP proxy configuration
• Using gMSAs for Windows Containers
• Updating the Amazon ECS container agent with the console
• Container agent management using the AWS CLI