This page explains how to use the AWS ECS task family identifier to uniquely identify workloads deployed on AWS ECS Fargate. The task family is a key identifier for defining and managing your ECS tasks.
Understanding the AWS ECS task family identifier
Section titled “Understanding the AWS ECS task family identifier”When deploying applications to AWS ECS Fargate, the task family provides a logical grouping and versioning mechanism. Each ECS task definition belongs to a specific task family. Refer to the official AWS documentation for additional details.
Applicable deployment type
Section titled “Applicable deployment type”Aembit specifically designed the ECS Task Family identification method for Edge-based deployments on AWS ECS Fargate.
Create a Client Workload with an AWS ECS task family identifier
Section titled “Create a Client Workload with an AWS ECS task family identifier”To configure a Client Workload with an AWS ECS task family identifier, follow these steps:
-
Log into your Aembit Tenant.
-
Click Client Workloads in the left nav pane.
-
Click New, revealing the Client Workload pop out menu.
-
Enter the Name and optional Description for the Client Workload.
-
Under Client Identification, select AWS ECS Task Family.
For Value, enter the task family name (without the revision) you have configured in AWS ECS.
For example, if the task definition is
my-fargate-app:1
in the AWS ECS Console, entermy-fargate-app
in the Value field.If you don’t know the task family name or how to find it, see Find task family name in AWS ECS.
-
Click Save.
Aembit displays the new Client Workload on the Client Workloads page.
Find task family name in AWS ECS
Section titled “Find task family name in AWS ECS”To find the task family name in the AWS ECS Console, follow these steps:
-
Open your AWS ECS Console
Open the AWS Management Console and go to the Elastic Container Service (ECS).
-
Find your Task Definition
In the ECS console, go to Task Definitions in the left menu.
-
Locate the Task Family
The Task definition column displays the task family name.
This is the string you’ll use in your Aembit configuration.