What are the requirements to use Terraform with Aviatrix System?¶
We are constantly improving and enhancing our Terraform support, so we request you to stay with the latest Aviatrix software and use the corresponding Terraform Aviatrix Provider Resource from our Github repository. Please do update the provider resource as we are frequently updating it.
Please note the below requirements for the Aviatrix Terraform Provider:
- Terraform 0.10.x / 0.11.x (0.12.x is incompatible)
- Go 1.11+
Which branch of Terraform Aviatrix Provider Resource should I use?¶
Our Github repository for the Terraform Aviatrix Provider Resource has multiple branches. Please make sure that you pick the branch which matches with the version of the software release on your Aviatrix Controller. The latest release is supported with the master branch. Here is the supported list
If you were using the master branch in the past, please move to the right release based branch as listed above to avoid incompatibility issues.
What if my Terraform scripts are timing out?¶
If you run into timeout issues, please use the IP address of the controller instead of the hostname of the controller and let us know if that helps. Please open a ticket by sending an email to email@example.com
Terraform sends all the operations to the controller at the same time, so if you see any issues during large operations - try serializing the operations by setting the value for parallelism to 1. More information at https://www.terraform.io/docs/commands/apply.html#parallelism-n. Please do let us know if you run into this issue, by sending an email to firstname.lastname@example.org
How do I debug Terraform issues?¶
If you run into issues with Terraform, please turn on debug logs by doing
export TF_LOG=TRACE on your terminal and then running your terraform scripts again. Please share the output with our support team at email@example.com
How can I launch a new Aviatrix Controller with Terraform?¶
Launching a new controller typically involves multiple steps as described here. We do support setting up, launching and initializing an Aviatrix Controller from Terrafrom. Here are the steps involved:
How can I create my IAM roles and policies in AWS using Terraform?¶
You can use our terraform iam_roles module to create the Aviatrix IAM roles required to connect your Aviatrix Controller to an existing AWS account. This should be run in the account where you are installing the Controller and any additional accounts that will be connected to the Controller. This performs a similar role as the CloudFormation script does in “Controller UI > Accounts > Access Accounts > New Account > Select AWS > Select IAM-role-based > Launch CloudFormation Script” - it does not create the account, only creates the IAM roles/profiles like this CloudFormation script. Similar to what is mentioned here.