terraform-provider-nsxt-virtual-private-cloud

This is the repository for VMware's NSX-T Virtual Private Cloud Terraform Provider, which one can use with Terraform to work with VMware NSX-T.

For general information about Terraform, visit the official website and the GitHub project page.

Documentation on the NSX platform can be found at the NSX-T Documentation page

Using the Provider

The latest version of this provider requires Terraform v0.12 or higher to run.

Note that you need to run terraform init to fetch the provider before deploying.

Full Provider Documentation

The provider is documented in full on the Terraform website and can be found here. Check the provider documentation for details on entering your connection information and how to get started with writing configuration for policy resources.

Controlling the provider version

Note that you can also control the provider version. This requires the use of a provider block in your Terraform configuration if you have not added one already.

The syntax is as follows:

provider "nsxt" {
  version = "~> 1.0.0"
  ...
}

Read more on provider version control.

Automated Installation (Recommended)

Download and initialization of Terraform providers is with the “terraform init” command. This applies to the NSX-T provider as well. Once the provider block for the NSX-T provider is specified in your .tf file, “terraform init” will detect a need for the provider and download it to your environment. You can list versions of providers installed in your environment by running “terraform version” command:

$ ./terraform version
Terraform v1.2.1
on linux_amd64
+ provider registry.terraform.io/vmware/nsxt-vpc v1.0.0

Manual Installation

NOTE: Unless you are developing or require a pre-release bugfix or feature, you will want to use the officially released version of the provider (see the section above).

NOTE: Recommended way to compile the provider is using Go Modules.

NOTE: For terraform 0.13, please refer to provider installation configuration in order to use custom provider.

Cloning the Project

First, you will want to clone the repository to $GOPATH/src/github.com/vmware/terraform-provider-nsxt-virtual-private-cloud:

mkdir -p $GOPATH/src/github.com/vmware
cd $GOPATH/src/github.com/vmware
git clone https://github.com/vmware/terraform-provider-nsxt-virtual-private-cloud.git

Building and Installing the Provider

Recommended golang version is go1.18 onwards. After the clone has been completed, you can enter the provider directory and build the provider.

cd $GOPATH/src/github.com/vmware/terraform-provider-nsxt-virtual-private-cloud
make

After the build is complete, copy the provider executable terraform-provider-nsxt-virtual-private-cloud into location specified in your provider installation configuration. Make sure to delete provider lock files that might exist in your working directory due to prior provider usage. Run terraform init. For developing, consider using dev overrides configuration. Please note that terraform init should not be used with dev overrides.

Developing the Provider

If you wish to work on the provider, you'll first need Go installed on your machine (version 1.14+ is recommended). You'll also need to correctly setup a GOPATH, as well as adding $GOPATH/bin to your $PATH.

See Manual Installation for details on building the provider.

Note: The files with filename starting with 'custom_' prefix are manually maintained files. Other files in 'nsxt' and 'website' directories are autogenerated by NSX build system. Please do not edit them.

Testing the Provider

NOTE: Testing the NSX-T provider is currently a complex operation as it requires having a NSX-T manager endpoint to test against, which should be hosting a standard configuration for a NSX-T cluster.

Configuring Environment Variables

Most of the tests in this provider require a comprehensive list of environment variables to run. See the individual *_test.go files in the nsxt/ directory for more details on the tunables that can be used to specify the locations of certain pre-created resources that the tests require.

Minimum environment variable :

$ export NSXT_MANAGER_HOST="10.191.155.100"
$ export NSXT_USERNAME="admin"
$ export NSXT_PASSWORD="r6.Or#F_z_.F"
$ export NSXT_ORG="org-1"
$ export NSXT_PROJECT="custom-project-1"
$ export NSXT_VPC="vpc-1"
$ export NSXT_ALLOW_UNVERIFIED_SSL=true

Running the Acceptance Tests

After this is done, you can run the acceptance tests by running:

$ make testacc

If you want to run against a specific set of tests, run make testacc with the TESTARGS parameter containing the run mask as per below:

make testacc TESTARGS="-run=TestNSXTStaticRoutesBasic"

This following example would run all of the acceptance tests matching TestNSXTStaticRoutesBasic. Change this for the specific tests you want to run.

Interoperability

The following versions of NSX are supported:

• NSX-T 4.1.2

Support

The NSX Virtual Private Cloud Terraform provider is now VMware supported as well as community supported. For bugs and feature requests please open a Github Issue and label it appropriately or contact VMware support.

License

Copyright © 2022-2023 VMware, Inc. All Rights Reserved.

The NSX VPC Terraform provider is available under MPL2.0 license.