resilien
/
terraform
2
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
terraform/builtin/providers/vsphere
History
dkalleg 6f62248471 Add functionality to specify and mount vmdks (#6146) 
User may specify a vmdk in their disk definition.
The options size, template, and vmdk are considered
to be mutually exclusive. User may also set whether each disk
associated with the vm should try to boot after creation.
Todo: Enforce mutual exclusivity, validate the bootable_vmdk_path
 		2016-04-27 17:22:22 +01: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 provider/vsphere: restore vcenter_server as deprecated field 2015-12-10 12:11:51 -06:00
provider_test.go rename vcenter_server config parameter to something clearer 2015-11-20 20:37:49 +09: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 Add functionality to specify and mount vmdks (#6146) 2016-04-27 17:22:22 +01:00
resource_vsphere_virtual_machine_test.go Add functionality to specify and mount vmdks (#6146) 2016-04-27 17:22:22 +01: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.