Terraform module generator

Scaffolding / Boilerplate generator for new Terraform module projects

Features

• main.tf, variables.tf,outputs.tf files to module root path

• .editorconfig, .gitignore, .gitattributes and .terraform-version files to module root path

• Option to choose test framework

  • Terratest
  • kitchen-terraform

• test directory with an example test based on test framework selection

• .pre-commit-config.yaml for terraform fmt, terraform-docs, check-merge-conflict and (go fmt, golint) / rubocop

• example directory with module usage tf files

Prerequisites

• terraformpro tip: use tfenv
• terraform-docs
• pre-commit
• For tests
  • terratest
    • golangpro tip: use gvm
    • golint
  • kitchen-terraform
    • rubypro tip: use rvm

Installation

• To use generator using Docker, Install Dockerrecommended
• To use generator using Nodejs, Install nodejspro tip: use nvm

Usage

To use the included generator execute the below command in shell and provide your answers to the prompts.

With Docker:

> docker run --rm -it -v $(pwd):/generated -e myuid="$(id -u):$(id -g)" sudokar/generator-tf-module

With NodeJs:

> npx -p yo -p generator-tf-module -c 'yo tf-module'

Prompts:

...
? Enter name for the new terraform module : example-module
? Enter description for the new terraform module : Example terraform module
? Enter author name : sudokar
? Choose terraform version (Use arrow keys)
❯ 0.15
0.14
0.13
? Choose test framework (Use arrow keys)
❯ Terratest
kitchen-terraform

Project layout generated for the new module with Terratest selection

example-module
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .pre-commit-config.yaml
├── .terraform-version
├── README.md
├── main.tf
├── outputs.tf
├── variables.tf
├── example
│ ├── main.tf
│ ├── outputs.tf
│ └── variables.tf
├── test
└── example_test.go

Project layout generated for the new module with kitchen-terraform selection

example-module
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .pre-commit-config.yaml
├── .terraform-version
├── .ruby-version
├── .kitchen.yml
├── Gemfile
├── README.md
├── main.tf
├── outputs.tf
├── variables.tf
├── example
│ ├── main.tf
│ ├── outputs.tf
│ └── variables.tf
├── test
└── integration
└── default
└── example_spec.rb

Post generation steps

Step 1

On the generated module's root path, Initialize git repository

git init

Step 2

On the generated module's root path, Install pre-commit hooks

pre-commit install

Step 3 (Applicable only for terratest)

For golang tests, get below libs

> go get github.com/gruntwork-io/terratest/modules/terraform
> go get github.com/stretchr/testify/assert

Contribution

Found a bug? feel free to raise an issue.
Pull requests are always welcome. Keen to review and merge asap.

Maintainer

This project is authored and maintained by sudokar

License

MIT