/terraform-provider-vsphere

Terraform VMware vSphere provider

Primary LanguageGoMozilla Public License 2.0MPL-2.0

Terraform

Terraform Provider for VMware vSphere

GitHub tag (latest SemVer) License

The Terraform Provider for VMware vSphere is a plugin for Terraform that allows you to interact with VMware vSphere, notably vCenter Server and ESXi. This provider can be used to manage a VMware vSphere environment, including virtual machines, host and cluster management, inventory, networking, storage, datastores, content libraries, and more.

Learn more:

Requirements

  • Terraform 0.13+

    For general information about Terraform, visit terraform.io and the project on GitHub.

  • Go 1.19

    Required if building the provider.

  • VMware vSphere

    The provider supports VMware vSphere versions in accordance with the VMware Product Lifecycle Matrix from General Availability to End of General Support.

    Learn more: VMware Product Lifecycle Matrix

    NOTE

    This provider requires API write access and is therefore not supported for use with a free VMware vSphere Hypervisor license.

Using the Provider

The Terraform Provider for VMware vSphere is an official provider. Official providers are maintained by the Terraform team at HashiCorp and are listed on the Terraform Registry.

To use a released version of the Terraform provider in your environment, run terraform init and Terraform will automatically install the provider from the Terraform Registry.

Unless you are contributing to the provider or require a pre-release bugfix or feature, use an officially released version of the provider.

See Installing the Terraform Provider for VMware vSphere for additional instructions on automated and manual installation methods and how to control the provider version.

For either installation method, documentation about the provider configuration, resources, and data sources can be found on the Terraform Registry.

Upgrading the Provider

The provider does not upgrade automatically. After each new release, you can run the following command to upgrade the provider:

terraform init -upgrade

Contributing

The Terraform Provider for VMware vSphere is the work of many contributors and the project team appreciates your help!

If you discover a bug or would like to suggest an enhancement, submit an issue. Once submitted, your issue will follow the lifecycle process.

If you would like to submit a pull request, please read the contribution guidelines to get started. In case of enhancement or feature contribution, we kindly ask you to open an issue to discuss it beforehand.

Learn more in the Frequently Asked Questions.

License

The Terraform Provider for VMware vSphere is available under the Mozilla Public License, version 2.0 license.