{"id":21513067,"url":"https://github.com/turnerlabs/waypoint-plugin-fargate","last_synced_at":"2025-04-09T18:50:34.452Z","repository":{"id":56593073,"uuid":"307822897","full_name":"turnerlabs/waypoint-plugin-fargate","owner":"turnerlabs","description":"A waypoint plugin that deploys AWS ECS/Fargate applications","archived":false,"fork":false,"pushed_at":"2020-10-29T18:53:07.000Z","size":76,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-23T20:43:50.004Z","etag":null,"topics":["aws","ci","deploy","ecs","fargate","waypoint"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/turnerlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-10-27T20:42:14.000Z","updated_at":"2024-11-28T16:34:52.000Z","dependencies_parsed_at":"2022-08-15T21:31:30.864Z","dependency_job_id":null,"html_url":"https://github.com/turnerlabs/waypoint-plugin-fargate","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turnerlabs%2Fwaypoint-plugin-fargate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turnerlabs%2Fwaypoint-plugin-fargate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turnerlabs%2Fwaypoint-plugin-fargate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/turnerlabs%2Fwaypoint-plugin-fargate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/turnerlabs","download_url":"https://codeload.github.com/turnerlabs/waypoint-plugin-fargate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248092197,"owners_count":21046431,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","ci","deploy","ecs","fargate","waypoint"],"created_at":"2024-11-23T22:52:32.252Z","updated_at":"2025-04-09T18:50:34.434Z","avatar_url":"https://github.com/turnerlabs.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# waypoint-plugin-fargate\n\nA [waypoint](https://www.waypointproject.io/) plugin that deploys [AWS ECS/Fargate](https://aws.amazon.com/fargate/) applications.\n\nThis 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.\n\nThe 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.\n\nThe 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.\n\n\n### install\n\nTo 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)).\n\n\n### usage example\n\nThe 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.\n\n`waypoint.hcl`\n\n```hcl\nproject = \"waypoint-test\"\n\napp \"waypoint-test\" {\n\n  build {\n    use \"docker\" {}\n\n    registry {\n      use \"aws-ecr\" {\n        region     = \"us-east-1\"\n        repository = \"waypoint-test\"\n        tag        = gitrefpretty()\n      }\n    }\n  }\n\n  deploy {\n    use \"fargate\" {\n      cluster = \"waypoint-test-dev\"\n      service = \"waypoint-test-dev\"\n    }\n  }\n}\n```\n\n```\nwaypoint up\n```\n\nIf you have more than one container in your app, you can specify which container you'd like to deploy using the `container` field.\n\n```hcl\n  deploy {\n    use \"fargate\" {\n      region    = \"us-east-1\"\n      cluster   = \"my-cluster\"\n      service   = \"my-service\"\n      container = \"my-container\"\n    }\n  }\n```\n\n\nLater, you can list your deployments.\n\n```\nwaypoint deployment list\n\n     | ID | PLATFORM |   DETAILS   |    STARTED    |   COMPLETED    \n-----+----+----------+-------------+---------------+----------------\n  🚀 | 74 | fargate  | artifact:32 | 8 minutes ago | 8 minutes ago  \n  ✔  | 73 | fargate  | artifact:30 | 21 hours ago  | 21 hours ago\n```\n\n\n### build from source\n\n```\nmake build\nmake install\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturnerlabs%2Fwaypoint-plugin-fargate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fturnerlabs%2Fwaypoint-plugin-fargate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fturnerlabs%2Fwaypoint-plugin-fargate/lists"}