The Terraform Provider for Ansible provides a more straightforward and robust means of executing Ansible automation from Terraform than local-exec. Paired with the inventory plugin in the Ansible cloud.terraform collection, users can run Ansible playbooks and roles on infrastructure provisioned by Terraform. The provider also includes integrated ansible-vault support.
This provider can be found in the Terraform Registry here.
For more details on using Terraform and Ansible together see these blog posts:
Run make
. This will build a terraform-provider-ansible
binary in the top level of the project. To get Terraform to use this binary, configure the development overrides for the provider installation. The easiest way to do this will be to create a config file with the following contents:
provider_installation {
dev_overrides {
"ansible/ansible" = "/path/to/project/root"
}
direct {}
}
The /path/to/project/root
should point to the location where you have cloned this repo, where the terraform-provider-ansible
binary will be built. You can then set the TF_CLI_CONFIG_FILE
environment variable to point to this config file, and Terraform will use the provider binary you just built.
Lint:
curl -L https://github.com/golangci/golangci-lint/releases/download/v1.50.1/golangci-lint-1.50.1-linux-amd64.tar.gz \
| tar --wildcards -xzf - --strip-components 1 "**/golangci-lint"
curl -L https://github.com/nektos/act/releases/download/v0.2.34/act_Linux_x86_64.tar.gz \
| tar -xzf - act
# linters
./golangci-lint run -v
# tests
make test
# GH actions locally
./act
The examples subdirectory contains a usage example for this provider.
See the generated changelog.
To release a new version of the provider:
go generate
to regenerate docsantsibull-changelog release --version <version>
to release a new version of the project.GNU General Public License v3.0. See LICENSE for full text.