ecs-bootstrap

Start ECS tasks when EC2s bootstrap

Usage no npm install needed!

<script type="module">
  import ecsBootstrap from 'https://cdn.skypack.dev/ecs-bootstrap';
</script>

README

ecs-bootstrap

Run a specific task definition on the EC2 this command is executed from. Put a call to ecs-bootstrap into your EC2's UserData script to insure that a task is started when the EC2s starts up.

Prerequisites

  • The EC2 must have node.js and npm installed

  • The EC2 must be running the AWS ecs-agent

  • The EC2 must have IAM permissions to ecs:StartTask and ecs:DescribeTasks

    {
  "Action": [
    "ecs:StartTask",
    "ecs:DescribeTasks"
  ],
  "Effect": "Allow",
  "Resource": [
    "arn:aws:ecs:us-east-1:123456789012:task-definition/my-task-definition:*"
  ]
}

Features

  • Makes up to 10 attempts to connect to the ecs-agent over 20 seconds before failing
  • Makes an API call to start the desired task, then polls the ECS API until the task is running, waiting up to 10 minutes
  • Makes up to 10 attempts to start the tasks

Usage

$ npm install -g ecs-bootstrap
$ ecs-bootstrap my-task-definition