github.com/jsoriano/terraform@v0.6.7-0.20151026070445-8b70867fdd95/website/source/docs/providers/vsphere/index.html.markdown (about)

     1  ---
     2  layout: "vsphere"
     3  page_title: "Provider: vSphere"
     4  sidebar_current: "docs-vsphere-index"
     5  description: |-
     6    The vSphere provider is used to interact with the resources supported by
     7    vSphere. The provider needs to be configured with the proper credentials before
     8    it can be used.
     9  ---
    10  
    11  # vSphere Provider
    12  
    13  The vSphere provider is used to interact with the resources supported by vSphere.
    14  The provider needs to be configured with the proper credentials before it can be used.
    15  
    16  Use the navigation to the left to read about the available resources.
    17  
    18  ~> **NOTE:** The vSphere Provider currently represents _initial support_ and
    19  therefore may undergo significant changes as the community improves it.
    20  
    21  ## Example Usage
    22  
    23  ```
    24  # Configure the vSphere Provider
    25  provider "vsphere" {
    26    user           = "${var.vsphere_user}"
    27    password       = "${var.vsphere_password}"
    28    vcenter_server = "${var.vsphere_vcenter_server}"
    29  }
    30  
    31  # Create a virtual machine
    32  resource "vsphere_virtual_machine" "web" {
    33    name   = "terraform_web"
    34    vcpu   = 2
    35    memory = 4096
    36  
    37    network_interface {
    38      label = "VM Network"
    39    }
    40  
    41    disk {
    42      size = 1
    43      iops = 500
    44    }
    45  }
    46  ```
    47  
    48  ## Argument Reference
    49  
    50  The following arguments are used to configure the vSphere Provider:
    51  
    52  * `user` - (Required) This is the username for vSphere API operations. Can also
    53    be specified with the `VSPHERE_USER` environment variable.
    54  * `password` - (Required) This is the password for vSphere API operations. Can
    55    also be specified with the `VSPHERE_PASSWORD` environment variable.
    56  * `vcenter_server` - (Required) This is the vCenter server name for vSphere API
    57    operations. Can also be specified with the `VSPHERE_VCENTER` environment
    58    variable.
    59