ansible-role-terragrunt

This role helps you install Terragrunt on your target host.

Requirements

This role works with Ansible version 2.8. Older versions may not work. To install the role on your system, use the command: ansible-galaxy install diodonfrost.terragrunt.

Role Variables

This role has several variables. The default values are as follows:

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

# Version of Terragrunt to install
# Possible values can be found here: https://api.github.com/repos/gruntwork-io/terragrunt/releases
# Default value: latest
terragrunt_version: latest

# Location to install the Terragrunt binary
# Default: uses the local system path defined in Ansible vars/*.yml
terragrunt_path: "{{ terragrunt_default_path }}"

Dependencies

None

Example Playbook

Here is a sample playbook to deploy the Ansible Galaxy Terragrunt role on a localhost and install the latest version of Terragrunt.

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

You can also specify a certain version of Terragrunt to install like this:

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

Local Testing

This project uses Molecule for development and testing.

To develop or test, you need:

• Linux (like Ubuntu)
• Docker
• Python (with python-pip)
• Ansible
• Molecule
• Libvirt (for Windows tests only)
• Vagrant (for Windows tests only)

Testing with Docker

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

# Test the Ansible role using CentOS 8
molecule test

# Test the Ansible role using Ubuntu 18.04
image=ansible-ubuntu:18.04 molecule test

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

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

# Run tests on the CentOS 7 instance
image=ansible-centos:7 molecule verify

Testing with Vagrant and Libvirt

# Test the Ansible role on Windows
molecule test -s windows

License

Apache 2

Author Information

This role was created by diodonfrost in 2019.