A suite of utilities for CloudFormation related activities.
1.3K
A small suite of scripts we use to manage cloudformation activities.
Seriously, use these at your own risk. They are not guaranteed to work, keep working, or anything. We build these as side projects, or specifically to meet the needs of one specific clients.
Make changes and build the docker image locally.
docker build -t trek10/cloudformation-toolbox:v1.2 .
Base command:
docker run --rm -it trek10/cloudformation-toolbox(:tag) [command] [options]
Runs a deploy of a cloudformation stack, currently it only works for a stack if you are modifying a "tag" parameter. It gathers and maintains the same value for all other parameters currently defined in the stack.
Usage
docker run --rm trek10/cloudformation-toolbox(:tag) ecs-deploy --key AWS_KEY --secret AWS_SECRET --region AWS_REGION --stack StackName --tag v1_1
Available [options]
usage: ecs-deploy [-h] --key KEY --secret SECRET --stack STACK --tag TAG
--region REGION
Deploy update to CloudFormation Stack
optional arguments:
-h, --help show this help message and exit
--key KEY AWS Access Key Id)
--secret SECRET AWS Secret Access Key)
--stack STACK The Stack name (ex: OurAppProduction)
--tag TAG The new tag to deploy to the Stack. (ex: v1.33.7)
--region REGION The region of the stack (ex: us-east-1)
Performs bit of behind the scenes magic to get the latest task version running on the stack, and creates a new task that is not attached to any running service. It provisons the task with all the expected environment variables and opens the user up to a bash-script in the newly created task. On exit, the task is killed and the command cleans up after itself.
Usage
docker run --rm -it trek10/cloudformation-toolbox(:tag) ecs-shell --sshkey "`cat .ssh/your-key.pub`" --key AWS_KEY --secret AWS_SECRET --region AWS_REGION --stack StackName
Note
-it is critical to be able to interact with the created shell.
--sshkey takes the full key text as an argument, not just a filename.
Available [options]
usage: ecs-shell [-h] --key KEY --sshkey SSHKEY --secret SECRET --stack STACK
--region REGION
Get a shell in a preconfigured container in your service stack
optional arguments:
-h, --help show this help message and exit
--key KEY AWS Access Key Id
--sshkey SSHKEY SSH Key content, not just the file name! Use `cat key.pem`
to read in a file to the command line)
--secret SECRET AWS Secret Access Key
--stack STACK The Stack name (ex: Production)
--region REGION The region of the stack (ex: us-east-1)
--private PRIVATE_IP boolean to use private VPN IPs vs public ones
--consoleversion required=False, default=1, help='console task definition version'
Performs bit of behind the scenes magic to get the latest task version running on the stack, and attaches to a running service task.
Usage
docker run --rm -it trek10/cloudformation-toolbox(:tag) ecs-service-shell --sshkey "`cat .ssh/your-key.pub`" --key AWS_KEY --secret AWS_SECRET --region AWS_REGION --stack StackName
Note
-it is critical to be able to interact with the created shell.
--sshkey takes the full key text as an argument, not just a filename.
Available [options]
usage: ecs-service-shell [-h] --key KEY --sshkey SSHKEY --secret SECRET --stack STACK --task TASKFILTER
--region REGION
Get a shell in attached to a running service running task in service stack
optional arguments:
-h, --help show this help message and exit
--key KEY AWS Access Key Id
--sshkey SSHKEY SSH Key content, not just the file name! Use `cat key.pem`
to read in a file to the command line)
--secret SECRET AWS Secret Access Key
--stack STACK The Stack name (ex: Production)
--task TASKFILTER The filter for the task runner (ex: ServiceTask|CronRunner)
--region REGION The region of the stack (ex: us-east-1)
--private PRIVATE_IP boolean to use private VPN IPs vs public ones
--serviceversion required=False, default=1, help='console task definition version'
Useful for adding and remove an ip address from an admin security group, particularly useful in combination with the ecs-shell command.
usage: securitygroup-ip-manager [-h] --key KEY --secret SECRET
--security-group-id SECURITY_GROUP_ID --region
REGION [--ip IP] [--add] [--remove]
Add / Remove an IP Address on a specific Security Group
optional arguments:
-h, --help show this help message and exit
--key KEY AWS Access Key Id
--secret SECRET AWS Secret Access Key
--security-group-id SECURITY_GROUP_ID
The Stack name (ex: Production)
--region REGION The region of the stack (ex: us-east-1)
--ip IP IP Address you would like added or removed form the
Security Group, defaults to current public IP
--add, -a Add IP Address
--remove, -r Remove IP Address
Content type
Image
Digest
Size
105.6 MB
Last updated
almost 10 years ago
docker pull trek10/cloudformation-toolbox:v1.3.4