terraform_tfs_generator

Overview Versions Insights

This role can be used to install tf tool binary and deploy tf manifest files (.tf) starting from an Ansible inventory, to create a fully atomated and idempotent Infrastructure as Code scenario.

Role Variables

All the useful variables are commented into the defaults file, the main ones are these:

---

# Install tf cmd binary
tf_binary_install: true
tf_binary_version: '0.14.2'
tf_binary_platform: 'linux_amd64'
tf_binary_url: "https://releases.hashicorp.com/terraform/{{ tf_binary_version }}/\
                terraform_{{ tf_binary_version }}_{{ tf_binary_platform }}.zip"

# Name of the command used to generate tf files
tf_cmd: 'terraform'

# Where to deploy tf resource files
tf_config_dir: 'tfs'

# Delete existing resources before deploying new ones
tf_purge: false

To start working with this role you'll need to choose which provider will be used to generate tf manifests, currently libvirt (default) and azure are the two supporterd providers.

# Which environment we're going to deploy
tf_cloud_provider: 'libvirt'

To get specific configuration options look at the Libvirt or Azure page:

Example playbook

To test this role and generate a set of tf manifests, just use the tests/tfs_generator.yml playbook passing the test inventory with -i tests/inventory:

> ansible-playbook -i tests/inventory tests/tfs_generator.yml

PLAY [Create tf manifests using tfs_generator Ansible role] ******************************************************************************

TASK [Gathering Facts] ************************************************************************************************************************************
ok: [localhost]

...
...

PLAY RECAP ************************************************************************************************************************************************
localhost                  : ok=15   changed=7    unreachable=0    failed=0    skipped=2    rescued=0    ignored=0

This will generate a tests/tf directory containing all the generated manifests.

To learn how to use this with the tf tool to automate environment generation check the Libvirt page.