$> ecsy help
Wraps the ECS SDK in a more user-friendly (for me at least) way
Usage:
ecsy [command]
Available Commands:
add Associates a .pem SSH key with a cluster, allowing SSH into EC2 instances
copy-task-revision duplicate a task definition into a new revision with a different image
create-post-deployment-task Creates an events rule that runs an ecs task with [command] after a service reaches steady state
create-task-revision duplicate a task definition into a new revision with a different image
deploy deploys a new image to a cluster service
deploy-newest-task deploy newest task definition to a service
describe Show current task configuration for service
env Used to manage environment variables of service task definitions
events Show recent events for a service in a cluster
help Help about any command
list-clusters lists clusters
list-services list services in a cluster
logs Show recent logs for a service in a cluster (must be cloudwatch based)
ports List out exposed service ports for creating new services
run Run an ssh command on all the servers in a cluster
run-task Run an individual task into an ECS cluster
scale Set the number of desired instances of a service
schedule-task Creates a scheduled task with a command override
self-update Update the ecsy cli binary on your system
ssh Secure Shell into one of the service container instances' EC2 host machines
status View current cluster or service deployment status
update-agent Update the Container Instance Agents
Flags:
--config string config file (default is $HOME/.ecsy.yaml)
-h, --help help for ecsy
Use "ecsy [command] --help" for more information about a command.
Example (v0.2.13)
wget -O /usr/local/bin/ecsy https://github.com/oberd/ecsy/releases/download/v0.2.13/ecsy-v0.2.13-darwin-amd64
chmod +x /usr/local/bin/ecsy
sudo wget -O /usr/local/bin/ecsy https://github.com/oberd/ecsy/releases/download/v0.2.13/ecsy-v0.2.13-linux
sudo chmod +x /usr/local/bin/ecsy
You can run ecsy self-update
to get the latest version
To get started, you will need to register some ssh keys (per cluster).
For example, if you have an ECS cluster called my-app-dev
, whose instances
use the ssh key my-app.pem
, register an ssh key with:
ecsy add my-app-dev ~/.ssh/my-app.pem
You only have to do this once, it will persist to ~/.ecsy.yaml
(by default)
Most other help is available on the CLI. Check it out, and good luck!