Before diving deeper into the documentation, let's first see how to create a simple CloudFormation stack using Takomo.
Initialize a new NPM project and add Takomo as a development dependency:
You need to have valid AWS credentials configured. Create a profile named takomo-example in your ~/.aws/credentials file:
You can also provide credentials using some other method described here, but rest of this quick start guide assumes that you are using the takomo-example profile.
Initializing a new Takomo project using CLI
The rest of this quick start guide describes how to create all the needed directories and files manually. If you just want to try out how to deploy infrastructure with Takomo, you can initialize a new project and create the files using the following command:
Our stack contains a VPC whose CIDR range can be parameterized. First, we need to create the stacks directory that will host all stack configurations. Create the directory and add a file named vpc.yml with the following contents:
Next, we need to provide a CloudFormation template for our stack. Create the templates directory next to the stacks directory, and add a file named vpc.yml with the following contents:
Now, you should have the following files in place:
Alright, we are ready to deploy our stack. Change to the project root directory and run:
Review the changes and continue to deploy the stack.
You can delete the stack with this command:
Continue to the next section to learn the basics of how Takomo works.