https://github.com/turnerlabs/waypoint-plugin-fargate
A waypoint plugin that deploys AWS ECS/Fargate applications
https://github.com/turnerlabs/waypoint-plugin-fargate
aws ci deploy ecs fargate waypoint
Last synced: over 1 year ago
JSON representation
A waypoint plugin that deploys AWS ECS/Fargate applications
- Host: GitHub
- URL: https://github.com/turnerlabs/waypoint-plugin-fargate
- Owner: turnerlabs
- Created: 2020-10-27T20:42:14.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2020-10-29T18:53:07.000Z (over 5 years ago)
- Last Synced: 2025-03-23T20:43:50.004Z (over 1 year ago)
- Topics: aws, ci, deploy, ecs, fargate, waypoint
- Language: Go
- Homepage:
- Size: 74.2 KB
- Stars: 10
- Watchers: 2
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# waypoint-plugin-fargate
A [waypoint](https://www.waypointproject.io/) plugin that deploys [AWS ECS/Fargate](https://aws.amazon.com/fargate/) applications.
This plugin is similar to the built-in [aws-ecs](https://www.waypointproject.io/plugins/aws-ecs) plugin, however it does not create or provision any cloud infrastructure resources. The plugin assumes that you already have an existing ECS service and simply deploys your application container on top of the infrastructure.
The plugin is optimized to work well with the [fargate-create](https://github.com/turnerlabs/fargate-create/) tool which uses [Terraform](https://github.com/turnerlabs/terraform-ecs-fargate) to provision the AWS cloud infrastructure.
The great thing about `waypoint` is that it enables simple, declarative, and portable build/push/deploy flows that run the same on your laptop as they do in any of your CI/CD pipelines.
### install
To install the plugin, download the asset for your platform from [releases](https://github.com/turnerlabs/waypoint-plugin-fargate/releases), unzip it and put it in your `${HOME}/.config/waypoint/plugins/` directory (or use one of the [other options](https://www.waypointproject.io/docs/extending-waypoint/creating-plugins/compiling#installing-the-plugin)).
### usage example
The following example will build your application container (assuming you have a `Dockerfile`), push it to AWS ECR, register a new task definition which references the newly build image, and finally update the service to run the new task definition.
`waypoint.hcl`
```hcl
project = "waypoint-test"
app "waypoint-test" {
build {
use "docker" {}
registry {
use "aws-ecr" {
region = "us-east-1"
repository = "waypoint-test"
tag = gitrefpretty()
}
}
}
deploy {
use "fargate" {
cluster = "waypoint-test-dev"
service = "waypoint-test-dev"
}
}
}
```
```
waypoint up
```
If you have more than one container in your app, you can specify which container you'd like to deploy using the `container` field.
```hcl
deploy {
use "fargate" {
region = "us-east-1"
cluster = "my-cluster"
service = "my-service"
container = "my-container"
}
}
```
Later, you can list your deployments.
```
waypoint deployment list
| ID | PLATFORM | DETAILS | STARTED | COMPLETED
-----+----+----------+-------------+---------------+----------------
🚀 | 74 | fargate | artifact:32 | 8 minutes ago | 8 minutes ago
✔ | 73 | fargate | artifact:30 | 21 hours ago | 21 hours ago
```
### build from source
```
make build
make install
```