Running workloads on external instances
After an external instance is registered to your cluster, you can run your
containerized workloads. The first step is to register a task definition. Amazon ECS provides
the requiresCompatibilities
parameter to validate the task definition is
compatible with your external instances. When you deploy your workload, use the
EXTERNAL
launch type when creating your service or running your
standalone task.
Creating a task definition that is compatible with your external instances
When registering an Amazon ECS task definition, use the
requiresCompatibilities
parameter and specify EXTERNAL
which validates that the task definition is compatible to use when running Amazon ECS
workloads on your external instances. For more information, see Creating a task definition using the new
console.
If your tasks require a task execution IAM role, make sure that it's specified in the task definition. For more information, see Conditional IAM permissions.
The following is an example task definition.
Running a standalone task or creating a service
After you register your external instances to your cluster, grant the relevant
IAM permissions, and register a valid task definition, you can start to run your
workloads on Amazon ECS. When running your standalone tasks or creating a service,
specify the EXTERNAL
launch type, and the Amazon ECS scheduler places the
tasks on your external instances.
For instructions on how to create services, see Creating an Amazon ECS service.
For more information about running standalone tasks, see Run a standalone task.
Verifying your running tasks on an external Windows instance
After you launch a task, you can verify the status by checking the Amazon ECS agent log
(ecs-agent.log
) which is located in the
\ProgramData\Amazon\ECS\log
directory.