README
¶
Amazon ECS CLI v2
⚠️ Before you get started please note that this feature is in preview and the intention is to ensure it meets your requirements and give us any feedback on your use case. Please do not run production workloads till we announce the general availability of this feature. Using the instructions and assets in this repository folder is governed as a preview program under the AWS Service Terms: https://aws.amazon.com/service-terms/ .
The ECS CLI is a tool for developers to create, release and manage production ready containerized applications on ECS. From getting started, pushing to staging and releasing to production, the ECS CLI can help manage the entire lifecycle of your application development.
Once you've built something you're excited to deploy, let the ECS CLI set up a CI/CD pipeline for you, with built in testing hooks and manual gates. Tail your logs, monitor your key metrics and push updates all from the comfort of your terminal.
Use the ECS CLI to:
- Bring your existing Docker apps
- Set up staging and production environments, cross region and cross account
- Set up production-ready, battle tested ECS Clusters, Services and infrastructure
- Set up CI/CD Pipelines for all of the micro-services that make up your Project
- Monitor and debug your applications
🌟 Tenets (unless you know better ones)
- Create modern applications by default. Applications created with the ECS CLI use the best practices of modern applications by default: they are serverless, they use infrastructure-as-code, they are observable, and they are secure.
- Users think in terms of architecture, not of infrastructure. Developers creating a new microservice shouldn't have to specify VPCs, load balancer settings, or complex pipeline configuration. They may not know anything about other AWS services. They should be able to specify what "kind" of application it is and how it fits into their overall architecture; the infrastructure should be generated from that.
- Operations is part of the workflow. Modeling, provisioning, and deploying applications are only part of the application lifecycle for the developer. The CLI must support workflows around troubleshooting and debugging to help when things go wrong.
- Deliver applications continuously. While the ECS CLI can be used to manually deploy changes to an application, we always help customers to move to CI/CD by helping them set up and manage pipelines.
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 aws-security@amazon.com.
📝 License
This library is licensed under the Apache 2.0 License.
Directories
¶
| Path | Synopsis |
|---|---|
|
cmd
|
|
|
ecs-preview
Package main contains the root command.
|
Package main contains the root command. |
|
ecs-preview/template
Package template provides usage templates to render help menus.
|
Package template provides usage templates to render help menus. |
|
internal
|
|
|
pkg/archer
Package archer contains the structs that represent archer concepts, and the associated interfaces to manipulate them.
|
Package archer contains the structs that represent archer concepts, and the associated interfaces to manipulate them. |
|
pkg/aws/cloudwatchlogs
Package cloudwatchlogs contains utility functions for Cloudwatch Logs client.
|
Package cloudwatchlogs contains utility functions for Cloudwatch Logs client. |
|
pkg/aws/cloudwatchlogs/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/aws/ecr
Package ecr contains utility functions for dealing with ECR repos
|
Package ecr contains utility functions for dealing with ECR repos |
|
pkg/aws/ecr/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/aws/ecs
Package ecs contains utility functions for dealing with ECS repos.
|
Package ecs contains utility functions for dealing with ECS repos. |
|
pkg/aws/ecs/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/aws/identity
Package identity wraps AWS Security Token Service (STS) API functionality.
|
Package identity wraps AWS Security Token Service (STS) API functionality. |
|
pkg/aws/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/aws/profile
Package profile provides functionality to parse AWS named profiles.
|
Package profile provides functionality to parse AWS named profiles. |
|
pkg/aws/route53
Package route53 wraps AWS route 53 API functionality.
|
Package route53 wraps AWS route 53 API functionality. |
|
pkg/aws/session
Package session provides functions that return AWS sessions to use in the AWS SDK.
|
Package session provides functions that return AWS sessions to use in the AWS SDK. |
|
pkg/build/docker/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/cli
Package cli contains the ecs-preview subcommands.
|
Package cli contains the ecs-preview subcommands. |
|
pkg/cli/group
Package groups contains the names of command groups
|
Package groups contains the names of command groups |
|
pkg/cli/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/deploy
Package deploy holds the structures to deploy infrastructure resources.
|
Package deploy holds the structures to deploy infrastructure resources. |
|
pkg/deploy/cloudformation
Package cloudformation provides functionality to deploy ECS resources with AWS CloudFormation.
|
Package cloudformation provides functionality to deploy ECS resources with AWS CloudFormation. |
|
pkg/describe/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/ini
Package ini provides functionality to parse and read properties from INI files.
|
Package ini provides functionality to parse and read properties from INI files. |
|
pkg/manifest
Package manifest provides functionality to create Manifest files.
|
Package manifest provides functionality to create Manifest files. |
|
pkg/store
Package store implements CRUD operations for project, environment, application and pipeline configuration.
|
Package store implements CRUD operations for project, environment, application and pipeline configuration. |
|
pkg/store/secretsmanager
Package secretsmanager wraps AWS SecretsManager API functionality.
|
Package secretsmanager wraps AWS SecretsManager API functionality. |
|
pkg/term/color
Package color provides functionality to displayed colored text on the terminal.
|
Package color provides functionality to displayed colored text on the terminal. |
|
pkg/term/cursor
Package cursor provides functionality to interact with the terminal cursor.
|
Package cursor provides functionality to interact with the terminal cursor. |
|
pkg/term/log
Package log is a wrapper around the fmt package to print messages to the terminal.
|
Package log is a wrapper around the fmt package to print messages to the terminal. |
|
pkg/term/progress
Package progress provides data and functionality to display updates to the terminal.
|
Package progress provides data and functionality to display updates to the terminal. |
|
pkg/term/progress/mocks
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
|
pkg/term/prompt
Package prompt provides functionality to retrieve free-form text, selection, and confirmation input from the user via a terminal.
|
Package prompt provides functionality to retrieve free-form text, selection, and confirmation input from the user via a terminal. |
|
pkg/version
Package version holds variables for generating version information
|
Package version holds variables for generating version information |
|
pkg/workspace
Package workspace contains the service to manage a user's local workspace.
|
Package workspace contains the service to manage a user's local workspace. |
|
Package mocks is a generated GoMock package.
|
Package mocks is a generated GoMock package. |
Click to show internal directories.
Click to hide internal directories.