Merge pull request #3483 from hashicorp/d-vsphere
vsphere docs; first draft
This commit is contained in:
Paul Hinze
commit
60e9bec052
|
|
@ -23,6 +23,7 @@ body.layout-openstack,
|
||||||
body.layout-packet,
|
body.layout-packet,
|
||||||
body.layout-rundeck,
|
body.layout-rundeck,
|
||||||
body.layout-template,
|
body.layout-template,
|
||||||
|
body.layout-vsphere,
|
||||||
body.layout-docs,
|
body.layout-docs,
|
||||||
body.layout-downloads,
|
body.layout-downloads,
|
||||||
body.layout-inner,
|
body.layout-inner,
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,56 @@
|
||||||
|
---
|
||||||
|
layout: "vsphere"
|
||||||
|
page_title: "Provider: vSphere"
|
||||||
|
sidebar_current: "docs-vsphere-index"
|
||||||
|
description: |-
|
||||||
|
The vSphere provider is used to interact with the resources supported by
|
||||||
|
vSphere. The provider needs to be configured with the proper credentials before
|
||||||
|
it can be used.
|
||||||
|
---
|
||||||
|
|
||||||
|
# vSphere Provider
|
||||||
|
|
||||||
|
The vSphere provider is used to interact with the resources supported by vSphere.
|
||||||
|
The provider needs to be configured with the proper credentials before it can be used.
|
||||||
|
|
||||||
|
Use the navigation to the left to read about the available resources.
|
||||||
|
|
||||||
|
## Example Usage
|
||||||
|
|
||||||
|
```
|
||||||
|
# Configure the vSphere Provider
|
||||||
|
provider "vsphere" {
|
||||||
|
user = "${var.vsphere_user}"
|
||||||
|
password = "${var.vsphere_password}"
|
||||||
|
vcenter_server = "${var.vsphere_vcenter_server}"
|
||||||
|
}
|
||||||
|
|
||||||
|
# Create a virtual machine
|
||||||
|
resource "vsphere_virtual_machine" "web" {
|
||||||
|
name = "terraform_web"
|
||||||
|
vcpu = 2
|
||||||
|
memory = 4096
|
||||||
|
|
||||||
|
network_interface {
|
||||||
|
label = "VM Network"
|
||||||
|
}
|
||||||
|
|
||||||
|
disk {
|
||||||
|
size = 1
|
||||||
|
iops = 500
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Argument Reference
|
||||||
|
|
||||||
|
The following arguments are used to configure the vSphere Provider:
|
||||||
|
|
||||||
|
* `user` - (Required) This is the username for vSphere API operations. Can also
|
||||||
|
be specified with the `VSPHERE_USER` environment variable.
|
||||||
|
* `password` - (Required) This is the password for vSphere API operations. Can
|
||||||
|
also be specified with the `VSPHERE_PASSWORD` environment variable.
|
||||||
|
* `vcenter_server` - (Required) This is the vCenter server name for vSphere API
|
||||||
|
operations. Can also be specified with the `VSPHERE_VCENTER` environment
|
||||||
|
variable.
|
||||||
|
|
||||||
|
|
@ -0,0 +1,69 @@
|
||||||
|
---
|
||||||
|
layout: "vsphere"
|
||||||
|
page_title: "vSphere: vsphere_virtual_machine"
|
||||||
|
sidebar_current: "docs-vsphere-resource-virtual-machine"
|
||||||
|
description: |-
|
||||||
|
Provides a vSphere virtual machine resource. This can be used to create, modify, and delete virtual machines.
|
||||||
|
---
|
||||||
|
|
||||||
|
# vsphere\_virtual\_machine
|
||||||
|
|
||||||
|
Provides a vSphere virtual machine resource. This can be used to create,
|
||||||
|
modify, and delete virtual machines.
|
||||||
|
|
||||||
|
## Example Usage
|
||||||
|
|
||||||
|
```
|
||||||
|
resource "vsphere_virtual_machine" "web" {
|
||||||
|
name = "terraform_web"
|
||||||
|
vcpu = 2
|
||||||
|
memory = 4096
|
||||||
|
|
||||||
|
network_interface {
|
||||||
|
label = "VM Network"
|
||||||
|
}
|
||||||
|
|
||||||
|
disk {
|
||||||
|
size = 1
|
||||||
|
iops = 500
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Argument Reference
|
||||||
|
|
||||||
|
The following arguments are supported:
|
||||||
|
|
||||||
|
* `name` - (Required) The virtual machine name
|
||||||
|
* `vcpu` - (Required) The number of virtual CPUs to allocate to the virtual machine
|
||||||
|
* `memory` - (Required) The amount of RAM (in MB) to allocate to the virtual machine
|
||||||
|
* `datacenter` - (Optional) The name of a Datacenter in which to launch the virtual machine
|
||||||
|
* `cluster` - (Optional) Name of a Cluster in which to launch the virtual machine
|
||||||
|
* `resource_pool` (Optional) The name of a Resource Pool in which to launch the virtual machine
|
||||||
|
* `gateway` - (Optional) Gateway IP address to use for all network interfaces
|
||||||
|
* `domain` - (Optional) A FQDN for the virtual machine; defaults to "vsphere.local"
|
||||||
|
* `time_zone` - (Optional) The [time zone](https://www.vmware.com/support/developer/vc-sdk/visdk41pubs/ApiReference/timezone.html) to set on the virtual machine. Defaults to "Etc/UTC"
|
||||||
|
* `dns_suffixes` - (Optional) List of name resolution suffixes for the virtual network adapter
|
||||||
|
* `dns_servers` - (Optional) List of DNS servers for the virtual network adapter; defaults to 8.8.8.8, 8.8.4.4
|
||||||
|
* `network_interface` - (Required) Configures virtual network interfaces; see [Network Interfaces](#network-interfaces) below for details.
|
||||||
|
* `disk` - (Required) Configures virtual disks; see [Disks](#disks) below for details
|
||||||
|
* `boot_delay` - (Optional) Time in seconds to wait for machine network to be ready.
|
||||||
|
|
||||||
|
<a id="network-interfaces"></a>
|
||||||
|
## Network Interfaces
|
||||||
|
|
||||||
|
Network interfaces support the following attributes:
|
||||||
|
|
||||||
|
* `label` - (Required) Label to assign to this network interface
|
||||||
|
* `ip_address` - (Optional) Static IP to assign to this network interface. Interface will use DHCP if this is left blank.
|
||||||
|
* `subnet_mask` - (Optional) Subnet mask to use when statically assigning an IP.
|
||||||
|
|
||||||
|
<a id="disks"></a>
|
||||||
|
## Disks
|
||||||
|
|
||||||
|
Disks support the following attributes:
|
||||||
|
|
||||||
|
* `template` - (Required if size not provided) Template for this disk.
|
||||||
|
* `datastore` - (Optional) Datastore for this disk
|
||||||
|
* `size` - (Required if template not provided) Size of this disk (in GB).
|
||||||
|
* `iops` - (Optional) Number of virtual iops to allocate for this disk.
|
||||||
|
|
@ -188,6 +188,10 @@
|
||||||
<li<%= sidebar_current("docs-providers-template") %>>
|
<li<%= sidebar_current("docs-providers-template") %>>
|
||||||
<a href="/docs/providers/template/index.html">Template</a>
|
<a href="/docs/providers/template/index.html">Template</a>
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
|
<li<%= sidebar_current("docs-providers-vsphere") %>>
|
||||||
|
<a href="/docs/providers/vsphere/index.html">vSphere</a>
|
||||||
|
</li>
|
||||||
</ul>
|
</ul>
|
||||||
</li>
|
</li>
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -0,0 +1,26 @@
|
||||||
|
<% wrap_layout :inner do %>
|
||||||
|
<% content_for :sidebar do %>
|
||||||
|
<div class="docs-sidebar hidden-print affix-top" role="complementary">
|
||||||
|
<ul class="nav docs-sidenav">
|
||||||
|
<li<%= sidebar_current("docs-home") %>>
|
||||||
|
<a href="/docs/providers/index.html">« Documentation Home</a>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li<%= sidebar_current("docs-vsphere-index") %>>
|
||||||
|
<a href="/docs/providers/vsphere/index.html">vSphere Provider</a>
|
||||||
|
</li>
|
||||||
|
|
||||||
|
<li<%= sidebar_current(/^docs-vsphere-resource/) %>>
|
||||||
|
<a href="#">Resources</a>
|
||||||
|
<ul class="nav nav-visible">
|
||||||
|
<li<%= sidebar_current("docs-vsphere-resource-virtual-machine") %>>
|
||||||
|
<a href="/docs/providers/vsphere/r/virtual_machine.html">vsphere_virtual_machine</a>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</li>
|
||||||
|
</ul>
|
||||||
|
</div>
|
||||||
|
<% end %>
|
||||||
|
|
||||||
|
<%= yield %>
|
||||||
|
<% end %>
|
||||||
Loading…
Reference in New Issue