ansible-role-terragrunt

This role provide a compliance for install terragrunt on your target host.

Requirements

This role was developed using Ansible 2.8 Backwards compatibility is not guaranteed. Use ansible-galaxy install diodonfrost.terragrunt to install the role on your system.

Role Variables

This role has multiple variables. The defaults for all these variables are the following:

---
# defaults file for ansible-role-terragrunt

# Define terragrunt version to install
# Possible values: https://api.github.com/repos/gruntwork-io/terragrunt/releases
# Default: latest
terragrunt_version: latest

# Define where to install Terragrunt binary
# Default: use local system path defined in Ansible vars/*.yml
terragrunt_path: "{{ terragrunt_default_path }}"

Dependencies

None

Example Playbook

This is a sample playbook file for deploying the Ansible Galaxy terragrunt role in a localhost and installing latest terragrunt version.

---
- hosts: localhost
  become: true
  roles:
    - role: diodonfrost.terragrunt

This role can also install a specific version of terragrunt.

---
- hosts: localhost
  become: true
  roles:
    - role: ansible-role-terragrunt
      vars:
        terragrunt_version: v0.18.0

Local Testing

This project uses Molecule to aid in the development and testing.

To develop or test you'll need to have installed the following:

• Linux (e.g. Ubuntu)
• Docker
• Python (including python-pip)
• Ansible
• Molecule
• Libvirt (windows tests only)
• Vagrant (windows tests only)

Testing with Docker

# Install requirements
pip install -r requirements-dev.txt

# Test ansible role with centos 8
molecule test

# Test ansible role with ubuntu 18.04
image=ansible-ubuntu:18.04 molecule test

# Create centos 7 instance
image=ansible-centos:7 molecule create

# Apply role on centos 7 instance
image=ansible-centos:7 molecule converge

# Launch tests on centos 7 instance
image=ansible-centos:7 molecule verify

Testing with Vagrant and Libvirt

# Test ansible role with Windows
molecule test -s windows

License

Apache 2

Author Information

This role was created in 2019 by diodonfrost.