mirror of
https://github.com/opentffoundation/opentf.git
synced 2026-03-16 01:00:22 -04:00
Since we merged this so that the community could collaborate on improvements, I thought it would be prudent to inform potential users of the status of the provider so they know what to expect.
60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
---
|
|
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.
|
|
|
|
~> **NOTE:** The vSphere Provider currently represents _initial support_ and
|
|
therefore may undergo significant changes as the community improves it.
|
|
|
|
## 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.
|
|
|