Skip to main content

Task Definition

The Task Definition is a critical component within Amazon ECS (Elastic Container Service) that dictates how a container should run. This includes specifying parameters such as the Docker image to use, hardware requirements, network settings, and IAM roles. By defining these parameters, users can ensure consistent deployment and environment settings across different container instances. For more detailed information, please refer to the official AWS ECS Task Definition documentation.

Terraform Mappings:

  • aws_ecs_task_definition.family

Supported Methods​

  • GET: Get a task definition by revision name ((family):(revision))
  • LIST: List all task definitions
  • SEARCH: Search for task definitions by ARN

iam-role​

Task Definitions are often linked to IAM Roles to manage the permissions for containers to access various AWS services. The IAM Role specifies the permissions containers require to interact with AWS resources, which can be defined within the Task Definition itself. This tight integration is essential for maintaining secure and efficient access control for containerised applications running on ECS.