- Notifications
You must be signed in to change notification settings - Fork427
The AWS Copilot CLI is a tool for developers to build, release and operate production ready containerized applications on AWS App Runner or Amazon ECS on AWS Fargate.
License
aws/copilot-cli
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
- Documentation:https://aws.github.io/copilot-cli/
The AWS Copilot CLI is a tool for developers to build, release and operate production-ready containerized applicationson AWS App Runner or Amazon ECS on AWS Fargate.
Use Copilot to:
- Deploy production-ready, scalable services on AWS from a Dockerfile in one command.
- Add databases or inject secrets to your services.
- Grow from one microservice to a collection of related microservices in an 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.
To install with homebrew:
$ 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 |
Make sure you have the AWS command line tool installed and have already runaws configure before you start.
To get a sample app up and running in one command, run the following:
$ git clone git@github.com: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! 🚀
Want to learn more about what's happening? Check out our documentationhttps://aws.github.io/copilot-cli/ for a getting started guide, learning about Copilot concepts, and a breakdown of our commands.
Have any feedback at all? 🙏 Drop us anissue or join us ongitter.
We're happy to hear feedback or answer questions, so reach out, anytime!
If you think you’ve found a potential security issue, please do not post it in the Issues. Instead, please follow the instructionshere or email AWS security directly ataws-security@amazon.com.
This library is licensed under the Apache 2.0 License.
About
The AWS Copilot CLI is a tool for developers to build, release and operate production ready containerized applications on AWS App Runner or Amazon ECS on AWS Fargate.