Skip to content

oberd/ecsy

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

83 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

$> 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.

Installation

Example (v0.2.13)

OSX
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
Linux
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

Updating

You can run ecsy self-update to get the latest version

Usage

Adding SSH Keys

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)

Running commands

Most other help is available on the CLI. Check it out, and good luck!