A self-contained deployable integration between Terraform and vRealize Automation (vRA) which allows Terraform users to request/provision entitled vRA catalog items using Terraform. Supports Terraform destroying vRA provisioned resources.
These instructions will get you a copy of the project up and run on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.
To get the vRA plugin up and running you need the following things.
Setup a GOLang project structure
|-/home/<USER>/TerraformPluginProject
|-bin
|-pkg
|-src
Set following environment variables
Linux Users
GOROOT is a golang library path
export GOROOT=/usr/local/go
GOPATH is a path pointing toward the source code directory
export GOPATH=/home/<user>/TerraformPluginProject
Windows Users
GOROOT is a golang library path
set GOROOT=C:\Go
GOPATH is a path pointing toward the source code directory
set GOPATH=C:\TerraformPluginProject
Linux Users
Create ~/.terraformrc and put following content in it.
providers {
vra7 = "/home/<USER>/TerraformPluginProject/bin/terraform-provider-vra7"
}
Windows Users
Create %APPDATA%/terraform.rc and put following content in it.
providers {
vra7 = "C:\\TerraformPluginProject\\bin\\terraform-provider-vra7.exe"
}
Clone repo code into go project using go get
go get github.com/vmware/terraform-provider-vra7
Linux and MacOS Users
Navigate to /home//TerraformPluginProject/src/github.com/vmware/terraform-provider-vra7 and run go build command to generate plugin binary
dep ensure
go build -o /home/<USER>/TerraformPluginProject/bin/terraform-provider-vra7
Windows Users
Navigate to C:\TerraformPluginProject\src\github.com\vmware\terraform-provider-vra7 and run go build command to generate plugin binary
dep ensure
go build -o C:\TerraformPluginProject\bin\terraform-provider-vra7.exe
The VMware vRA terraform configuration file contains two objects
This part contains service provider details.
Configure Provider
Provider block contains four mandatory fields
- username - vRA portal username
- password - vRA portal password
- tenant - vRA portal tenant
- host - End point of REST API
- insecure - In case of self-signed certificates. Default value is false.
Example
provider "vra7" {
username = "[email protected]"
password = "password123!"
tenant = "corp.local.tenant"
host = "http://myvra.example.com/"
insecure = false
}
This part contains any resource that can be deployed on that service provider. For example, in our case machine blueprint, software blueprint, complex blueprint, network, etc.
Configure Resource
Syntax
resource "vra7" "<resource_name1>" {
}
The resource block contains mandatory and optional fields as follows:
Mandatory:
One of catalog_name or catalog_id must be specified in the resource configuration.
-
catalog_name - catalog_name is a field which contains valid catalog name from your vRA
-
catalog_id - catalog_id is a field which contains a valid catalog id from your vRA.
Optional:
-
businessgroup_id - This is an optional field. You can specify a different Business Group ID from what provided by default in the template reques, provided that your account is allowed to do it
-
catalog_configuration - This is an optional field. If catalog properties have default values or no mandatory user input required for catalog service then you can skip this field from the terraform configuration file. This field contains user inputs to catalog services. Value of this field is a key value pair. Key is any field name of catalog and value is any valid user input to the respective field.
-
count - This field is used to create replicas of resources. If count is not provided then it will be considered as 1 by default.
-
deployment_configuration - This is an optional field. Can only be used to specify the description or reasons field at the deployment level. Key is any field name of catalog and value is any valid user input to the respective field.
-
resource_configuration - This is an optional field. If blueprint properties have default values or no mandatory property value is required then you can skip this field from terraform configuration file. This field contains user inputs to catalog services. Value of this field is in key value pair. Key is service.field_name and value is any valid user input to the respective field.
-
wait_timeout - This is an optional field with a default value of 15. It defines the time to wait (in minutes) for a resource operation to complete successfully.
Example 1
resource "vra7_resource" "example_machine1" {
catalog_name = "CentOS 6.3"
resource_configuration = {
Linux.cpu = "1"
Windows2008R2SP1.cpu = "2"
Windows2012.cpu = "4"
Windows2016.cpu = "2"
}
catalog_configuration = {
lease_days = "5"
}
deployment_configuration = {
reasons = "I have some"
description = "deployment via terraform"
}
count = 3
}
Example 2
resource "vra7_resource" "example_machine2" {
catalog_id = "e5dd4fba7f96239286be45ed"
resource_configuration = {
Linux.cpu = "1"
Windows2008.cpu = "2"
Windows2012.cpu = "4"
Windows2016.cpu = "2"
}
count = 4
}
Save this configuration in main.tf in a path where the binary is placed.
These are the Terraform commands that can be used for the vRA plugin:
-
terraform init - The init command is used to initialize a working directory containing Terraform configuration files.
-
terraform plan - Plan command shows plan for resources like how many resources will be provisioned and how many will be destroyed.
-
terraform apply - apply is responsible to execute actual calls to provision resources.
-
terraform refresh - By using the refresh command you can check the status of the request.
-
terraform show - show will set a console output for resource configuration and request status.
-
terraform destroy - destroy command will destroy all the resources present in terraform configuration file.
Navigate to the location where main.tf and binary are placed and use the above commands as needed.
The terraform-provider-vra7 project team welcomes contributions from the community. Before you start working with terraform-provider-vra7, please read our Developer Certificate of Origin. All contributions to this repository must be signed as described on that page. Your signature certifies that you wrote the patch or have the right to pass it on as an open-source patch. For more detailed information, refer to CONTRIBUTING.md.
terraform-provider-vra7 is available under the MIT license.