Infoblox IPAM Plug-In for Terraform is a Terraform provider that allows Terraform to interface with NIOS or vNIOS appliances for the purpose of managing the DDI resource objects. The plug-in and its source code are available on the Terraform Registry page of the Terraform portal, so you can either use the published plug-in or build one by customizing the source code to include additional features.
The sections covered in this topic are:
Note
If you are upgrading a prior version of the IPAM Plug-In for Terraform to the latest version available in the Terraform portal, see Upgrading Infoblox IPAM Plug-In for Terraform for additional instructions.
Prerequisites
Whether you intend to use the published plug-in or the customized version that you have built yourself, you must complete the following prerequisites:
- Install and set up a physical or virtual Infoblox NIOS appliance that has necessary licenses installed.
To try out the plug-in, you can download and install the evaluation version of vNIOS from the Infoblox Support Portal.
After the installation, set up NIOS as described in the Setting Up NIOS for IPAM Plug-In for Terraform section. - Download and install Terraform. See the table below for compatible versions.
- Configure the access permissions for Terraform to interact with NIOS Grid objects.
- If you plan to develop a plug-in that includes features that are not in the published version, then install the Go client and Go programming language.
See the table below for compatible versions. - To use the Infoblox IPAM Plug-In for Terraform, you must either define the following extensible attributes or install the Cloud Network Automation license in the NIOS Grid, which adds the extensible attributes by default:
Tenant ID: String Type
CMP Type: String Type
Cloud API Owned: List Type (Values True, False)
You may add other extensible attributes that you want to use. - Create an extensible attribute by name Terraform Internal ID of type string in Infoblox NIOS. For more information, see the Creating the Terraform Internal ID Extensible Attribute section.
The following table lists the recommended software combinations that are verified for compatibility with Infoblox IPAM Plug-In for Terraform:
Plug-In Version | NIOS Version | WAPI Version | Golang | Terraform |
---|---|---|---|---|
2.7.0 | NIOS 8.6.x and NIOS 9.0.x | 2.9.0 or later | 1.21 or later | 1.8.1 or later |
2.6.0 | NIOS 8.6.x and NIOS 9.0.x | 2.9.0 or later | 1.17 or later | 0.14 |
2.5.0, 2.4.1, 2.4.0, 2.3.0 | NIOS 8.6.x and NIOS 9.0.x | 2.5 or later | 1.17 or later | 0.14 |
2.2.0 | NIOS 8.5.x, NIOS 8.6.x, and later | 2.5 or later | 1.16 or later | 0.14 |
2.1.0 | NIOS 8.5.x and 8.6.x | 2.5 or later | 1.15 or later | 0.14 or later |
Setting Up NIOS for IPAM Plug-In for Terraform
After installing NIOS as described, complete the following steps to set up NIOS for the plug-in:
(Optional) Install the Cloud Network Automation license on the NIOS appliance.
This will allow you to create cloud objects and manage them from the Cloud tab of NIOS Grid Manager. For more information, see Infoblox NIOS Documentation.
Go to the next step if you do not intend to use a Cloud Network Automation license.
Note: To manage NIOS objects when Cloud Network Automation license is not installed, you can use the published version of the IPAM Plug-In for Terraform, which is available in the Terraform portal.- To manage DNS records, in NIOS, manually add forward and reverse mapping zones that are specified in the Infoblox.tf file.
For example, if you are creating a networkcidr="10.10.20.0/24"
, then add the corresponding authoritative reverse mapping zone in NIOS.