History

Paul Stack 501c05d0f7 provider/vsphere: IPv6 support. (#6457 ) IPv6 support added. We support 1 IPv6 address per interface. It seems like the vSphere SDK supports more than one, since it's provided as a list. I can change it to support more than one address. I decided to stick with one for now since that's how the configuration parameters had been set up by other developers. The global gateway configuration option has been removed. Instead the user should specify a gateway on NIC level (ipv4_gateway and ipv6_gateway). For now, the global gateway will be used as a fallback for every NICs ipv4_gateway. The global gateway configuration option has been marked as deprecated.		2016-05-03 18:27:24 +02:00
..
README.md	Initial role documentation (#6302 )	2016-04-26 00:14:11 +01:00
config.go	provider/vsphere: Add allow_unverified_ssl flag for unverified SSL requests	2015-12-04 08:49:22 -06:00
provider.go	Adding File Resource for vSphere provider	2016-05-02 22:25:35 +02:00
provider_test.go	rename vcenter_server config parameter to something clearer	2015-11-20 20:37:49 +09:00
resource_vsphere_file.go	Adding File Resource for vSphere provider	2016-05-02 22:25:35 +02:00
resource_vsphere_file_test.go	Adding File Resource for vSphere provider	2016-05-02 22:25:35 +02:00
resource_vsphere_folder.go	error checks for vsphere create and delete folder (#6095 )	2016-04-08 16:22:36 -05:00
resource_vsphere_folder_test.go	Merge pull request #4284 from matt-deboer/master	2016-02-25 08:44:27 -06:00
resource_vsphere_virtual_machine.go	provider/vsphere: IPv6 support. (#6457 )	2016-05-03 18:27:24 +02:00
resource_vsphere_virtual_machine_test.go	provider/vsphere: IPv6 support. (#6457 )	2016-05-03 18:27:24 +02:00

README.md

Terraform vSphere Provider Dev Docs

This document is in place for developer documentation. User documentation is located HERE on Terraform's website.

Thank-you @tkak and Rakuten, Inc. for there original contribution of the source base used for this provider!

Introductory Documentation

Both README.md and BUILDING.md should be read first!

Base API Dependency ~ govmomi

This provider utilizes govmomi Go Library for communicating to VMware vSphere APIs (ESXi and/or vCenter). Because of the dependency this provider is compatible with VMware systems that are supported by govmomi. Much thanks to the dev team that maintains govmomi, and even more thanks to there guidance with the development of this provider. We have had many issues answered by the govomi team!

vSphere CLI ~ govc

One of the great tools that govmomi contains is govc. It is a command line tool for using the govmomi API. Not only is it a tool to use, but also it's source base is a great resource of examples on how to exercise the API.

Required privileges for running Terraform as non-administrative user

Most of the organizations are concerned about administrative privileges. In order to use Terraform provider as non priviledged user, we can define a new Role within a vCenter and assign it appropriate privileges: Navigate to Administration -> Access Control -> Roles Click on "+" icon (Create role action), give it appropraite name and select following privileges:

Datastore
- Allocate space
- Browse datastore
- Low level file operations
- Remove file
- Update virtual machine files
- Update virtual machine metadata
Folder (all)
- Create folder
- Delete folder
- Move folder
- Rename folder
Network
- Assign network
Resource
- Apply recommendation
- Assign virtual machine to resource pool
Virtual Machine
- Configuration (all) - for now
- Guest Operations (all) - for now
- Interaction (all)
- Inventory (all)
- Provisioning (all)

These settings were tested with vSphere 6.0 and vSphere 5.5. For additional information on roles and permissions, please refer to official VMware documentation.

This section is a work in progress and additional contributions are more than welcome.