Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/vmware/terraform-provider-vcf

Terraform Provider for VMware Cloud Foundation
https://github.com/vmware/terraform-provider-vcf

sddc-manager terraform terraform-provider vmware-cloud-foundation

Last synced: 27 days ago
JSON representation

Terraform Provider for VMware Cloud Foundation

Awesome Lists containing this project

README

        

VMware Cloud Foundation

# Terraform Provider for VMware Cloud Foundation

[![Latest Release](https://img.shields.io/github/v/tag/vmware/terraform-provider-vcf?label=latest%20release&style=for-the-badge)](https://github.com/vmware/terraform-provider-vcf/releases/latest) [![License](https://img.shields.io/github/license/vmware/terraform-provider-vcf.svg?style=for-the-badge)](LICENSE)

The Terraform Provider for [VMware Cloud Foundation][product-documentation] is a plugin for Terraform that allows you to interact with VMware Cloud Foundation, specifically Cloud Builder and SDDC Manager.

Learn more:

* Read the provider [documentation][provider-documentation].

* Join the community [discussions][provider-discussions].

## Requirements

* [VMware Cloud Foundation][product-documentation]

The following table lists the supported platforms for this provider.

| Platform | Support |
|------------------------------|-------------|
| VMware Cloud Foundation 5.1+ | `≥ v0.9.0` |
| VMware Cloud Foundation 5.0 | `≥ v0.9.0` |
| VMware Cloud Foundation 4.5 | `≤ v0.8.0` |
| VMware Cloud Foundation 4.4 | `≤ v0.8.0` |

[^1]: VMware Cloud Foundation on Dell VxRAIL is **not supported** by this provider.

The plugin supports versions in accordance with the
[Broadcom Product Lifecycle][product-lifecycle]. [^1]

* [Terraform 1.4+][terraform-install]

For general information about Terraform, visit [HashiCorp Developer][terraform-install] and [the project][terraform-github] on GitHub.

* [Go 1.22.6][golang-install]

Required, if [building the provider][provider-build].

## Using the Provider

The Terraform Provider for VMware Cloud Foundation is a Partner tier provider.

Partner tier providers are owned and maintained by a partner in the HashiCorp Technology Partner Program. HashiCorp verifies the authenticity of the publisher and the provider is listed on the [Terraform Registry][terraform-registry] with a Partner tier label.

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 a
released version of the provider.

See [Installing the Terraform Provider for VMware Cloud Foundation][provider-install] 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:

```shell
terraform init -upgrade
```

## Contributing

The Terraform Provider for VMware Cloud Foundation 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][provider-issues].

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

## License

© Broadcom. All Rights Reserved.
The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.

The Terraform Provider for VMware Cloud Foundation is available under the [Mozilla Public License, version 2.0][provider-license] license.

[golang-install]: https://golang.org/doc/install
[product-documentation]: https://docs.vmware.com/en/VMware-Cloud-Foundation/index.html
[product-lifecycle]: https://support.broadcom.com/group/ecx/productlifecycle
[provider-contributing]: CONTRIBUTING.md
[provider-discussions]: https://github.com/vmware/terraform-provider-vcf/discussions
[provider-documentation]: https://registry.terraform.io/providers/vmware/vcf/latest/docs
[provider-build]: docs/build.md
[provider-install]: docs/install.md
[provider-issues]: https://github.com/vmware/terraform-provider-vcf/issues/new/choose
[provider-license]: LICENSE
[terraform-github]: https://github.com/hashicorp/terraform
[terraform-install]: https://developer.hashicorp.com/terraform/install
[terraform-registry]: https://registry.terraform.io