A basic Terraform provider for Aviatrix. Read this tutorial as an alternative to the README, only if the instructions are unclear.
-> NOTE: This release has a big structure change from release v1.*, please read this changelist-v2 first, and change your cloud infrastructures accordingly.
- Install Terraform 0.12.x/0.13.x (0.11.x or lower is incompatible)
- Install Go 1.12+ (This will be used to build the provider plugin.)
- Create a directory, go, follow this doc to edit ~/.bash_profile to setup the GOPATH environment variable)
Clone repository to: $GOPATH/src/github.com/terraform-providers/terraform-provider-aviatrix
$ mkdir -p $GOPATH/src/github.com/terraform-providers
$ cd $GOPATH/src/github.com/terraform-providers
$ git clone https://github.com/AviatrixSystems/terraform-provider-aviatrix.git
To clone on windows
mkdir %GOPATH%\src\github.com\terraform-providers
cd %GOPATH%\src\github.com\terraform-providers
git clone https://github.com/AviatrixSystems/terraform-provider-aviatrix.git
Enter the provider directory and build the provider
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-aviatrix
$ make fmt
$ make build
To build on Windows
cd %GOPATH%\src\github.com\terraform-providers\terraform-provider-aviatrix
go fmt
go install
Run the following command:
$ make build13
Activate the provider by adding the following to ~/.terraformrc
on Linux/Unix.
providers {
"aviatrix" = "$GOPATH/bin/terraform-provider-aviatrix"
}
For Windows, the file should be at '%APPDATA%\terraform.rc'. Do not change $GOPATH to %GOPATH%.
In Windows, for terraform 0.11.8 and lower use the above text.
In Windows, for terraform 0.11.9 and higher use the following at '%APPDATA%\terraform.rc'
providers {
"aviatrix" = "$GOPATH/bin/terraform-provider-aviatrix.exe"
}
If the rc file is not present, it should be created
For Terraform v0.13+, to use a locally built version of a provider you must add the following snippet to every module that you want to use the provider in.
terraform {
required_providers {
aviatrix = {
source = "aviatrix.com/aviatrix/aviatrix"
version = "99.0.0"
}
}
}
Check examples and documentation here
Visit here for the complete documentation for all resources on github
Due to some non-backward compatible changes in REST API not all controller versions are supported. If you find a branch with the controller version please use that branch Controller versions older than 3.3 are not supported For example:
- UserConnect-3.3 for 3.3.x controller version
- UserConnect-3.4 for 3.4.x controller version
master
branch is a development branch, thus it is unverified for all use cases and supports features that may not be available in the latest released version of the controller. For production use cases, please only use a released version from the Terraform Registry.
We also recommend you to update to the latest controller version to stay on top of fixes/features.