Ownership of this project has been transferred to https://github.com/button/ecsdeploy
There are already a few deploy tools for ECS out there, but none offer deploy progress reporting for
chatops or dashboards. ecsdeploy is built as an easily deployable binary that can be fit into any
deployment pipeline, but can also be used a library to embed directly into your team's deploy tool.
ecsdeploy can report deploy progress
- As a progress bar to Slack
- As number of running/pending/stopped tasks as a webhook
- As an annotation to Grafana
Deploy status reporters to additional targets are easy to add by implementing a simple interface.
Not only that, it also has "smart" monitoring of deploys, and can determine deploy failures due to resource constraints and task failures early.
usage: ecsdeploy [<flags>] <cluster> <service>
Flags:
--help Show context-sensitive help.
--timeout=10m How long to wait for the deploy to complete
--report-addr=REPORT-ADDR URL address to report deploy status changes to
--report-auth-token=REPORT-AUTH-TOKEN
Auth token to use for reporting deploy status via HTTP. Appears on the HTTP request as
an "Authorization: Bearer <...>" header
--slack-token=SLACK-TOKEN Auth token to use for reporting deploy status to Slack
--slack-channel=SLACK-CHANNEL Slack channel to post deploy status to
--grafana-url=GRAFANA-URL URL to a Grafana server to send annotations to
--grafana-api-token=GRAFANA-API-TOKEN
API token for the Grafana server
--task-definition=TASK-DEFINITION
Location of a task definition file to deploy. If not specified, creates a new task
definition based off the currently deployed one. If "-" is specified, reads stdin.
--desired-count=-1 Desired number of tasks
--max-percent=-1 The upper limit (as a percentage of the service's desiredCount) of the number of tasks
that are allowed in the RUNNING or PENDING state in a service during a deployment.
--min-percent=-1 The lower limit (as a percentage of the service's desiredCount) of the number of
running tasks that must remain in the RUNNING state in a service during.
--tag=TAG ... Overrides the docker image tag for a container definition, written as --tag
<container_name>=<image_tag>. If there is only one container definition, the
<container_name>= prefix can be omitted. This flag can be specified multiple times to
update tags for multiple containers
--detect-failures Enable to detect deploy failures early. Failures can include: cluster not having enough
cpu/memory, image to deploy does not exist, or service is in crash loop.
Args:
<cluster> Cluster to deploy to
<service> Name of service to deploy