build.md

Building the Terraform Provider for VMware vSphere

The instructions outlined below are specific to macOS and Linux only.

If you wish to work on the provider, you'll first need Go installed on your machine. Check the requirements before proceeding.

1. Clone the repository to: $GOPATH/src/github.com/vmware/terraform-provider-vsphere

   mkdir -p $GOPATH/src/github.com/vmware
   cd $GOPATH/src/github.com/vmware
   git clone git@github.com:vmware/terraform-provider-vsphere.git

2. Enter the provider directory to build the provider.

   cd $GOPATH/src/github.com/vmware/terraform-provider-vsphere
   go get
   go build -o terraform-provider-vsphere

3. Add the following to your ~/.terraformrc:

   provider_installation {
     dev_overrides {
       "vmware/vsphere" = "/Users/example/go/bin"
     }
   
     direct {}
   }

   Where /Users/example/go/bin is your GOPATH/bin path.

4. Run go install to install the development binary.