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 support@aviatrix.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 support@aviatrix.com

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 support@aviatrix.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: