ansible-role-terraform

This is an Ansible role for installing Terraform and terraform-docs.

Requirements

None.

Role Variables

Variable	Description	Default	Required
terraform_docs_version	The version of terraform-docs to install.	0.18.0	No
terraform_group	The group associated with the Terraform and terraform-docs binaries.	root	No
terraform_install_dir	The directory where the Terraform and terraform-docs binaries are to be installed.	/usr/local/bin	No
terraform_mode	The mode of the Terraform and terraform-docs binaries.	0755	No
terraform_owner	The owner of the Terraform and terraform-docs binaries.	root	No
terraform_version	The version of Terraform to install.	1.5.7	No

Dependencies

None.

Installation

This role can be installed via the command:

ansible-galaxy install --role-file path/to/requirements.yml

where requirements.yml looks like:

---
- name: terraform
  src: https://github.com/cisagov/ansible-role-terraform

and may contain other roles as well.

For more information about installing Ansible roles via a YAML file, please see the ansible-galaxy documentation.

Example Playbook

Here's how to use it in a playbook:

- hosts: all
  become: true
  become_method: sudo
  tasks:
    - name: Install Terraform
      ansible.builtin.include_role:
        name: terraform

Contributing

We welcome contributions! Please see CONTRIBUTING.md for details.

License

This project is in the worldwide public domain.

This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication.

All contributions to this project will be released under the CC0 dedication. By submitting a pull request, you are agreeing to comply with this waiver of copyright interest.

Author Information

Shane Frasier - [email protected]