- Terraform 0.10+
- Go 1.11 (to build the provider plugin)
- FortiOS 6.0 or 6.2. This provider uses the FortiOS API. All the resources are validated with FortiOS 6.0 and 6.2.
Building the Provider
Clone repository to:
$ mkdir -p $GOPATH/src/github.com/terraform-providers; cd $GOPATH/src/github.com/terraform-providers $ git clone firstname.lastname@example.org:terraform-providers/terraform-provider-fortios
Enter the provider directory and build the provider.
$ cd $GOPATH/src/github.com/terraform-providers/terraform-provider-fortios $ make build
Using the Provider
If you're building the provider, follow the instructions to install it as a plugin. After placing it into your plugins directory, run
terraform init to initialize it.
$ terraform init
Developing the Provider
If you wish to work on the provider, you'll first need Go installed on your machine (version 1.11+ is required). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.
To compile the provider, run
make build. This will build the provider and put the provider binary in the $GOPATH/bin directory.
$ make build ...
Running the acceptance test suite requires a FortiGate VM/device to test against.
To run the test:
FORTIOS_ACCESS_HOSTNAMEto point to a FortiGate VM/device.
FORTIOS_ACCESS_TOKENto the access token of a Rest API user on that device.
For more information about acceptance testing in Terraform, see Running an Acceptance Test.