Need help with amazon-ecs-cli-v2?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

aws
1.4K Stars 158 Forks Other 1.9K Commits 232 Opened issues

Description

The AWS Copilot CLI is a tool for developers to build, release and operate production ready containerized applications on Amazon ECS and AWS Fargate.

Services available

!
?

Need anything else?

Contributors list

No Data

AWS Copilot CLI AWS Copilot CLI

Build, Release and Operate Containerized Applications on AWS.

latest version Join the chat at https://gitter.im/aws/copilot-cli

The AWS Copilot CLI is a tool for developers to build, release and operate production ready containerized applications on Amazon ECS and AWS Fargate.

Use Copilot to: * Deploy production-ready, scalable ECS services from a Dockerfile in one command * Organize all your related microservices in one application * Set up test and production environments, across regions and accounts * Set up CI/CD pipelines to release your services to your environments * Monitor and debug your services from your terminal

init

Installation

To install with homebrew:

sh
$ brew install aws/tap/copilot-cli
To install manually, we're distributing binaries from our GitHub releases:
Instructions for installing Copilot for your platform
Platform Command to install
macOS curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux x86 (64-bit) curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Linux (ARM) curl -Lo copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 && chmod +x copilot && sudo mv copilot /usr/local/bin/copilot && copilot --help
Windows Invoke-WebRequest -OutFile 'C:\Program Files\copilot.exe' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe

Getting started

Make sure you have the AWS command line tool installed and have already run

aws configure
before you start.

To get a sample app up and running in one command, run the following:

$ git clone [email protected]:aws-samples/aws-copilot-sample-service.git demo-app
$ cd demo-app
$ copilot init --app demo                \
  --name api                             \
  --type 'Load Balanced Web Service'     \
  --dockerfile './Dockerfile'            \
  --deploy

This will create a VPC, Application Load Balancer, an Amazon ECS Service with the sample app running on AWS Fargate. This process will take around 8 minutes to complete - at which point you'll get a URL for your sample app running! 🚀

Learning more

Want to learn more about what's happening? Check out our documentation https://aws.github.io/copilot-cli/ for a getting started guide, learning about Copilot concepts, and a breakdown of our commands.

Feedback

Have any feedback at all? 🙏 Drop us an issue or join us on gitter.

We're happy to hear feedback or answer questions, so reach out, anytime!

Security disclosures

If you think you’ve found a potential security issue, please do not post it in the Issues. Instead, please follow the instructions here or email AWS security directly at [email protected].

License

This library is licensed under the Apache 2.0 License.

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.