Skip to content

Latest commit

 

History

History
102 lines (66 loc) · 3.45 KB

install_provider.md

File metadata and controls

102 lines (66 loc) · 3.45 KB

Installing the vRA Terraform provider

The provider is currently considered to be a third-party provider and thus won't be automatically downloaded by terraform, which means you have to either install or build it yourself. The provider is made available in a pre-built binary version via the GitHub repository in the form of releases. This document will walk you through installing a released version of the provider. (The following snippets will use v0.1.9, but you will need to update the version as necessary)

Downloading the provider

The most recent version of the provider can be found at https://github.com/vmware/terraform-provider-vra/releases/latest

example release

You can download the appropriate version of the provider for your OS via either your browser or the commandline using a tool like curl or wget.

Linux

Create a terraform plugins directory with your hardware platform subdirectory. Typically for 64bit Linux this will be in ~/.terraform.d/plugins/linux_amd64 on non-Windows platforms.

mkdir -p ~/.terraform.d/plugins/linux_amd64 

Download the plugin (via a browser or command line)

wget -q https://github.com/vmware/terraform-provider-vra/releases/download/v0.1.9/terraform-provider-vra-linux_amd64-v0.1.9.tgz

Untar/unzip the plugin

tar xvf terraform-provider-vra-linux_amd64-v0.1.9.tgz

If you already have an existing version of provider, either remove the existing provider file from the terraform plugins directory or update all configuration files to include latest version

rm ~/.terraform.d/plugins/terraform-provider-vra*

Move the extracted plugin to the terraform plugins directory

mv terraform-provider-vra_v0.1.9 ~/.terraform.d/plugins/

Linux Example

downloading with wget - Linux

Windows

Create a terraform plugins directory typically this will be in %APPDATA%\terraform.d\plugins.

 #powershell
 mkdir $ENV:APPDATA\terraform.d\plugins
#CMD
mkdir %APPDATA%\terraform.d\plugins

Download the plugin (via a browser or command line)

wget https://github.com/vmware/terraform-provider-vra/releases/download/v0.1.9/terraform-provider-vra-windows_amd64-v0.1.9.tgz -outfile terraform-provider-vra-windows_amd64-v0.1.9.tgz

Untar/unzip the plugin (Depending on your setup this may require two steps)

#using 7zip to unzip
7z x .\terraform-provider-vra-windows_amd64-v0.1.9.tgz

# then untar resulting file
tar xvf terraform-provider-vra-windows_amd64-v0.1.9.tar

Move the extracted plugin to the terraform plugins directory

#Powershell
move terraform-provider-vra_v0.1.9.exe $ENV:APPDATA\terraform.d\plugins
#CMD
move terraform-provider-vra_v0.1.9.exe %APPDATA%\terraform.d\plugins

Windows Example

downloading with wget - Powershell

Validating the install

To validate the installation you can simply change to the location where your terraform configuration is located and run terraform init. You should see a message indicating that terraform has been successfully initialized.

init success

Get Provider version

To find the provider version, you can simply change to the location where your terraform configuration is located and run terraform -version. You should see a message indicating the provider version.