A collection of CLI tools for use with AWS stack deployed services.
Download the latest binaries from the Releases page on this repository. Choose the correct distribution that suits the platform where the commands will be run.
Unzip the tar.gz file onto your local system, somewhere that the PATH environment variable can reach. If unsure, run which stacks and it should return the path to the command. If nothing is returned, then the files are not installed where PATH can see them.
- Ensure your system is setup for Go development.
- Run
go get github.com/aws/aws-sdk-go. - Run
git clone git@github.com:unbounce/stack-toolkit.git $GOPATH/src/github.com/unbounce/stack-toolkit - Run
makein the stack-toolkit directory to compile the binaries in this project.
Commands will never ask you for your AWS credentials. Your credentials are assumed to be loaded as environment variables as AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY.
stacks REGION
This command lists the active CloudFormation stacks in a given REGION.
stack-instances STACK_NAME REGION
This command lists the EC2 instances that belong to a given STACK_NAME within a given REGION.
The output from the commands can be combined with other Unix/Linux utilities to form a workflow.
Provide an alphabetically sorted list of stacks labeled "production" from the us-east-1 AWS region.
$ stacks us-east-1 | grep production | sort
Provide the ssh command with one EC2 public DNS name, retrieved from the example-stack in us-east-1. The head -1 ensures that only one result is returned (in the case of instances behind an autoscaling group).
$ ssh $(stack-instances example-stack us-east-1 | head -1)