TFW - Terraform Wrapper

Terraform Wrapper writes terraform configuration using TFDSL (Terraform DSL for Ruby) and invokes the terraform binary.

Motivation (Short Version)

Terraform is an excellent tool, but it lacks funcionalities like Loops and Conditionals, actually since version 0.12+ it has loops as meta-arguments which is a hacky implementation in my humble opinion.

For years I was templating terraform configuration with ERB / Jinja, that's reasonable way to avoid repetition in terraform but it's not very flexible nor reusable.

The solution was writing a tool which mimics terraform usage but writes configuration in plain Ruby.


  1. let's create a file called foo.rb

    resource 'local_file', 'foo' do 
    content 'foo'
    filename '/tmp/foo.txt'
  2. Just like in terrraform, run init and apply

    $ tfw init && tfw apply
    ... <omitted output>
    An execution plan has been generated and is shown below.
    Resource actions are indicated with the following symbols:
    + create

Terraform will perform the following actions:

# will be created

  • resource "local_file" "foo" {
    • content = "foo"
    • directory_permission = "0777"
    • file_permission = "0777"
    • filename = "/tmp/foo.txt"
    • id = (known after apply) }

Plan: 1 to add, 0 to change, 0 to destroy.

Do you want to perform these actions? Terraform will perform the actions described above. Only 'yes' will be accepted to approve.

Enter a value: yes Creating... Creation complete after 0s [id=0beec7b5ea3f0fdbc95d0dd47f3c5bc275da8a33]

Apply complete! Resources: 1 added, 0 changed, 0 destroyed.

## How it works

TFW will create a subdirectory called `.tfw`, and it will create a file called `.tfw/` which is the dynamically generated terraform file, and will invoke terrafom in that directory. 

## Installation

TFW is just a ruby gem and can easily be installed as below: 

gem install tfw