How do I get an exit code from an Amazon ECS Task?

Question

When I launch tasks in Amazon AWS ECS containers, I need to recover the exit code programmatically via the Java SDK.

It appears in the Amazon web interface, and in the SDK I can get a text-based failure reason, but is there a way to get the explicit exit code?

Answer 1

The exit code is available through the DescribeTasks API as exitCode for each of the containers.

Answer 2

This is how I'm getting the exit code of a task's specific container name

aws ecs describe-tasks \
  --cluster $ECS_CLUSTER \
  --tasks $TASK_ARN \
  --query "tasks[0].containers[?name=='$CONTAINER_NAME'].exitCode" \
  --output text

In a script

AWS_PROFILE=default
ECS_CLUSTER=cluster_name
CONTAINER_NAME=migrate

# Run task and get its arn
# NOTE: many of the necessary cli inputs have been omitted here
TASK_ARN=$(aws ecs run-task \
  --cluster $ECS_CLUSTER \
  --query 'tasks[].taskArn' \
  --output text | rev | cut -d'/' -f1 | rev)

# Wait for ecs task to stop
aws ecs wait tasks-stopped \
  --cluster $ECS_CLUSTER \
  --tasks $TASK_ARN

# Get exit code
TASK_EXIT_CODE=$(aws ecs describe-tasks \
  --cluster $ECS_CLUSTER \
  --tasks $TASK_ARN \
  --query "tasks[0].containers[?name=='$CONTAINER_NAME'].exitCode" \
  --output text)

# exit with the same code
exit $TASK_EXIT_CODE