Skip to content
master
Go to file
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
exe
 
 
lib
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

Sonic Screwdriver

CircleCI Gitter Support

BoltOps Badge

Sonic is a multi-functional tool that helps you manage AWS resources. Sonic contains a group of commands that help debug EC2 instances and ECS containers quickly.

See sonic-screwdriver.cloud for full documentation.

Why Sonic Was Created

After I exhaust debugging an ECS service with CloudWatch Logs, I usually take it to the next step: ssh into the instance. I jump into an instance with a running task or docker container and poke around to figure out the root issue.

To find the instance with the service's docker container I click around on the ECS console website until I locate the container instance's DNS name and then paste it into the terminal. While this process is not complicated, it is tedious. For example, the typical process is:

  1. Click on the cluster
  2. Click on the service
  3. Click on the tasks tab
  4. Click on one of the tasks
  5. Click on the container instance
  6. Highlight and copy the DNS name
  7. Paste the DNS name into the terminal to build up the ssh ec2-user@[dnsname] command
  8. Ssh into the machine
  9. Find the docker container with "docker ps"
  10. Run docker exec -ti [container_id] bash
  11. Finally, debug the actual problem

By the time I get into the container, I need to remind my brain of what the original issue was. This tool automates the process, so you do not waste your precious mental energy clicking on links and use it to focus on better things like fixing the actual issue.

Install

You can install sonic with RubyGems

gem install sonic

Full installation instructions are at Install Sonic Screwdriver. There are some server side dependencies for some of the sonic commands, so it is important to read through the full installation guide.

Quick Start

Here is a quick overview of sonic abilities:

# ssh into an instance
sonic ssh i-0f7f833131a51ce35
sonic ssh demo-web # ec2 tag
sonic ssh demo-web --cluster staging # ecs service name
sonic ssh demo-web --cluster staging # ecs service name
sonic ssh 7fbc8c75-4675-4d39-a5a4-0395ff8cd474 --cluster staging # ECS container id
sonic ssh 1ed12abd-645c-4a05-9acf-739b9d790170 --cluster staging # ECS task id

# docker exec to a running ECS docker container
sonic ecs exec demo-web

# docker run with the same environment as the ECS docker running containers
sonic ecs sh demo-web

# run command with instance ids
sonic execute --instance-ids i-111 uptime
sonic execute --instance-ids i-111,i-222 uptime

# run command on all instances tagged with Name demo-web and worker
sonic execute --tags Name=demo-web,demo-worker uptime

# run command on all instances with multiple tags
# Quotes are important due to semi-colon
sonic execute --tags "Name=demo-web,demo-worker;Owner=test" uptime

# list ec2 instances
sonic list demo-web

Contributing

Everyone can contribute to making sonic-screwdriver better. Please fork the project and open a pull request! We love your pull requests. Contributions are encouraged and welcomed!

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request

About

Multi-functional tool to manage AWS infrastructure

Resources

License

Packages

No packages published
You can’t perform that action at this time.