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-nsxt

Terraform Provider for VMware NSX
https://github.com/vmware/terraform-provider-nsxt

nsx nsx-t terraform terraform-provider

Last synced: 2 days ago
JSON representation

Terraform Provider for VMware NSX

Awesome Lists containing this project

README

        

VMware NSX

# Terraform Provider for VMware NSX

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

The Terraform Provider for [VMware NSX][product-documentation] is a plugin for Terraform that allows you to interact with VMware NSX.

Learn more:

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

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

## Requirements

- [VMware NSX][product-documentation]

The following table lists the supported product versions for this provider.

- VMware NSX 4.2.x
- VMware NSX 4.1.x
- VMware NSX 4.0.x
- VMware NSX-T Data Center 3.2.x
- VMware NSX-T Data Center 3.1.x
- VMware NSX-T Data Center 3.1.x
- VMware NSX-T Data Center 2.5.x [^1]

[^1]: Support for VMware NSX-T Data Center 2.5.x is limited with v3.2.x and later.

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

- [Terraform 0.12+][terraform-install]

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

- [Go 1.22][golang-install]

Required, if [building][provider-build] and [testing][provider-test].

## Using the Provider

The Terraform Provider for VMware NSX 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 NSX][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 NSX 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.

## Support

The Terraform Provider for VMware NSX is supported by Broadcom and the provider community. For bugs and feature requests please open a Github Issue and label it appropriately or contact Broadcom support.

## License

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

The Terraform Provider for VMware NSX 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-NSX/index.html
[product-lifecycle]: https://support.broadcom.com/group/ecx/productlifecycle
[provider-contributing]: CONTRIBUTING.md
[provider-discussions]: https://github.com/vmware/terraform-provider-nsxt/discussions
[provider-documentation]: https://registry.terraform.io/providers/vmware/nsxt/latest/docs
[provider-build]: docs/build.md
[provider-install]: docs/install.md
[provider-test]: docs/test.md
[provider-issues]: https://github.com/vmware/terraform-provider-nsxt/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