Takomo makes it easy to organize, parameterize and deploy your CloudFormation stacks across multiple regions and accounts.
Let's see how to create a simple CloudFormation stack using Takomo.
Install Takomo globally:
npm i -g takomo
Verify installation:
tkm --version
You need to have valid AWS credentials configured. Create a profile named takomo-example in your ~/.aws/credentials file:
[takomo-example]
aws_access_key_id=XXXXXXXXXXXXXXXXXXXX
aws_secret_access_key=YYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYYY
Our stack contains a VPC whose CIDR range can be parameterized. First, we need to create a stacks directory that will host all stack configurations. Create the directory and add there a file named vpc.yml with the following contents:
regions: eu-west-1
parameters:
CidrBlock: 10.0.0.0/24
Next, we need to provide a CloudFormation template for our stack. Create templates directory next to the stacks directory, and add there a file named vpc.yml with the following contents:
Description: My VPC
Parameters:
CidrBlock:
Type: String
Description: VPC CIDR block
Resources:
VPC:
Type: AWS::EC2::VPC
Properties:
CidrBlock: !Ref CidrBlock
Alright, we are ready to deploy our stack. Change to the project root directory and run:
tkm stacks deploy --profile takomo-example
You will be prompted if you want to continue the deployment. You also need to review and approve the changes. If you answer yes to both questions, then the deploy will proceed, and given your AWS credentials had all the needed IAM permissions, it should also succeed.
You can delete the stack with command:
tkm stacks undeploy --profile takomo-example
Take a look at https://takomo.io for more documentation.