Terraform module generator

Scaffolding 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 frameworks

  • 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

• terraform pro tip: use tfenv
• terraform-docs
• pre-commit
• For tests
  • terratest
    • golang pro tip: use gvm
    • golint
  • kitchen-terraform
    • ruby pro tip: use rvm

Installation

1. Install nodejs pro tip: use nvm

2. Install Yeoman

npm install -g yo

3. Install this generator

npm install -g generator-tf-module

Usage

To use the included generator execute the below command in shell and provide your new module name for the prompt

> yo tf-module
...
? Enter name for the new terraform module :  example-module
? Enter description for the new terraform module :  A new terraform module
? Enter author name :  sudokar
? 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

Support my project

To support maintenance of this project, Buy Me a Coffee

Contribution

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

Maintainers

This project is maintained by sudokar

License

MIT

Keywords

terraform scaffolding yeoman terraform module