Terraform Provider for Ansible

This site uses Just the Docs, a documentation theme for Jekyll.

Installation

Table of Contents

  1. Terraform Provider
    1. Installing a Pre-Compiled Release (recommended)
    2. Compiling From Source
  2. Ansible Dynamic Inventory Script
    1. Download Script
    2. Using Dynamic Inventory

Terraform Provider

Downloading and installing a pre-compiled terraform-provider-ansible release is the recommended method of installation since it requires no additional tools or libraries to be installed on your workstation.

  1. Visit the releases page and download the latest release for your target architecture.

  2. Unzip the downloaded file and copy the terraform-provider-ansible binary to a designated directory as described in Terraform’s plugin installation instructions.

Compiling From Source

Note: Terraform requires Go 1.11 or later to successfully compile.

Note: Dependencies are no longer included in this repository. You may need the bazaar version control utility to download some of Terraform’s Go-lang module dependencies.

If you’d like to take advantage of features not yet available in a pre-compiled release, you can compile terraform-provider-ansible from source.

In order to compile, you will need to have Go installed on your workstation. Official instructions on how to install Go can be found here.

Alternatively, you can use gimme as a quick and easy way to install Go:

$ sudo wget -O /usr/local/bin/gimme https://raw.githubusercontent.com/travis-ci/gimme/master/gimme
$ sudo chmod +x /usr/local/bin/gimme
$ gimme 1.10
# copy the output to your `.bashrc` and source `.bashrc`.

Once you have a working Go installation, you can compile terraform-provider-ansible by doing the following:

$ go get github.com/nbering/terraform-provider-ansible
$ cd $GOPATH/src/github.com/nbering/terraform-provider-ansible
$ make

You should now have a terraform-provider-ansible binary located at $GOPATH/bin/terraform-provider-ansible. Copy this binary to a designated directory as described in Terraform’s plugin installation instructions

Ansible Dynamic Inventory Script

Download Script

Download terraform.py (latest), or any past version from the releases page on it’s releases page.

Copy the script file to a location on your system. Ansible’s own documentation suggests placing it at /etc/ansible/terraform.py, but the particular location does not matter to the script. Ensure it has executable permissions (chmod +x /etc/ansible/terraform.py).

Using Dynamic Inventory

With your Ansible playbook and Terraform configuration in the same directory, run Ansible with the -i flag to set the path you used to install the inventory script.

$ ansible-playbook -i /etc/ansible/terraform.py playbook.yml