Project

awshark

0.0
No release in over a year
Custom CLI for for AWS to simplify common tasks with EC2, S3 and Cloud Formation
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Project Readme

Awshark

GitHub Actions Test Status

Simple command-line tool for some useful tasks for AWS EC2, S3 and CloudFormation.

Installation

gem install awshark

Usage

Use AWS_PROFILE=PROFILE and/or AWS_REGION=REGION to configure the internal AWS clients.

S3 commands

List all S3 buckets with number of objects and total size. (Data depends on AWS Cloudwatch Metrics so there is a time difference to the actual data.)

awshark s3 list

List all objects in a specific S3 bucket.

awshark s3 objects BUCKET_NAME fonts/

EC2 commands

List all EC2 instances in a region.

awshark ec2 list

ECS commands

List all ECS services in a region.

awshark ecs list

Cloud Formation commands

Display changes to AWS Cloud Formation stack.

awshark cf diff TEMPLATE_PATH --stage=STAGE --bucket=S3_BUCKET.bundesimmo.de --format=json|yaml

Update or create AWS Cloud Formation stack.

awshark cf deploy TEMPLATE_PATH --stage=STAGE --bucket=S3_BUCKET.bundesimmo.de --format=json|yaml

Save AWS Cloud Formation stack as file STACK_NAME-STAGE.json.

awshark cf save TEMPLATE_PATH --stage=STAGE

For a further information visit the Wiki.

Development

After checking out the repo, run bin/setup to install dependencies. You can also run bin/console for an interactive prompt that will allow you to experiment.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/jdahlke/awshark.