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:
- Click on the cluster
- Click on the service
- Click on the tasks tab
- Click on one of the tasks
- Click on the container instance
- Highlight and copy the DNS name
- Paste the DNS name into the terminal to build up the ssh ec2-user@[dnsname] command
- Ssh into the machine
- Find the docker container with "docker ps"
- Run docker exec -ti [container_id] bash
- 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.
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.
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
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!
- Fork it
- Create your feature branch (
git checkout -b my-new-feature)
- Commit your changes (
git commit -am 'Add some feature')
- Push to the branch (
git push origin my-new-feature)
- Create new Pull Request