Bash script to wrap some cloudformation operation. The script simplifies the process of creation, updating and deleting cloudformation stack ensuring the respect of some name convention.
- awscli installed and configured
- jq
- respect the name convention
The script to work correctly needs that the template and parameters files complies a simple convention.
- Template file name: "resource"."yaml"
- Parameter file name: "folder"/"service"-"environment"-"resource".json
resource, folder, yaml, environment, service can be configured using input parameters or bash variable.
The configuration is done setting the variable at the begining of the script or set them in console
- PROFILE: name of the aws-cli local profile
- PROJECT: name of the project. It is used in the stack name
- ENV: environment to use. It is used in the stack name and it must be included in parameters file name
- REGION: AWS region to use
- SERVICE: Name of the service. Should be name of the application. By default is common
- PARAMETERS_FOLDER: name of the folder where are located the parameters file
- TEMPLATE_EXTENSION: extension of the template file. (yaml, yml, template, json or your custom one)
- ENVIRONMENT_PARAMETER_NAME: name of the parameters inside the parameters file. If no parameter is preset it is not used in the stack name
There are 3 template and the parameters in the folder with parameters name
├── cfnwrapper.sh
├── rds.yaml
├── vpc.yaml
├── webapp.yaml
├── parameters
│ ├── application1-production-rds.json
│ ├── application1-staging-rds.json
│ ├── application1-production-vpc.json
│ ├── application1-staging-vpc.json
│ ├── application1-production-webapp.json
│ └── application1-staging-webapp.json
Launching the command ./cfnwrapper.sh -o create -d -e staging -s application1 vpc rds webapp the script prints:
aws cloudformation create-stack --profile profile-name --stack-name project-name-staging-vpc --template-body file://vpc.yml --parameters file://parameters/application1-staging-vpc.json --region eu-west-1 --capabilities CAPABILITY_NAMED_IAM
aws cloudformation create-stack --profile profile-name --stack-name project-name-staging-rds-v01 --template-body file://rds.yml --parameters file://parameters/application1-staging-rds.json --region eu-west-1 --capabilities CAPABILITY_NAMED_IAM
aws cloudformation create-stack --profile profile-name --stack-name project-name-staging-webapp-v23 --template-body file://webapp.yml --parameters file://parameters/application1-staging-webapp.json --region eu-west-1 --capabilities CAPABILITY_NAMED_IAM
Remove -d (dry run) option the script launches the command and wait the stack is completed before launches the next one.
To pass variable from cli: PROFILE=example ./cfnwrapper.sh -o create -e staging -s application1 vpc rds webapp