Skip to content

Commit f1b42a1

Browse files
author
Ryan Johnson
authored
Update README.md
Address review comments from @frodenas in #409. Signed-off-by: Ryan Johnson <[email protected]>
1 parent f8eca9b commit f1b42a1

File tree

1 file changed

+1
-57
lines changed

1 file changed

+1
-57
lines changed

README.md

Lines changed: 1 addition & 57 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,11 @@
11
# Terraform Provider for VMware vRealize Automation
22

3-
![License](https://img.shields.io/github/license/vmware/terraform-provider-vra?style=for-the-badge) ![Release](https://img.shields.io/github/release/vmware/terraform-provider-vra?style=for-the-badge)
4-
53
A self-contained deployable integration between Terraform and VMware vRealize Automation which allows Terraform users to request and provision IaaS resources such as machines, networks, load balancers, along with the configuration of cloud accounts, zones, and projects. This provider supports both vRealize Automation Cloud (SaaS) and vRealize Automation 8 (on-premises).
64

75
> Note: There is a separate provider available for [vRealize Automation 7.x](https://github.com/terraform-providers/terraform-provider-vra7).
86
97
## Requirements
108

11-
![Terraform](https://img.shields.io/badge/Terraform-0.12%2B-blue?style=for-the-badge&logo=terraform) ![Go](https://img.shields.io/github/go-mod/go-version/vmware/terraform-provider-vra?style=for-the-badge&logo=go)
12-
139
* [Terraform 0.12+](https://www.terraform.io/downloads.html)
1410
* [Go 1.16](https://golang.org/dl/) (to build the provider plugin)
1511

@@ -19,62 +15,12 @@ The [Terraform Provider for VMware vRealize Automation](https://registry.terrafo
1915

2016
To use a released version of the Terraform provider in your environment, run [`terraform init`](https://www.terraform.io/docs/commands/init.html) and Terraform will automatically install the provider from the Terraform Registry.
2117

22-
See [Installing the Terraform Provider for VMware vRealize Automation](docs/install_provider.md) for additional instructions on automated and manual installation methods.
18+
See [Installing the Terraform Provider for VMware vRealize Automation](docs/install_provider.md) for additional instructions on automated and manual installation methods and how to control the provider version.
2319

2420
For either installation method, documentation about the provider configuration, resources, and data sources can be found on the [provider page](https://registry.terraform.io/providers/vmware/vra/latest/docs) on the Terraform Registry.
2521

2622
Examples on the use of the provider configuration, resources, and data sources can be found in the project's `examples` directory.
2723

28-
## Controlling the Provider Version
29-
30-
To specify a particular provider version when installing released providers, see the [Terraform documentation on provider versioning](https://www.terraform.io/docs/configuration/providers.html#version-provider-versions).
31-
32-
![Terraform](https://img.shields.io/badge/Terraform-0.13%2B-blue?style=for-the-badge&logo=terraform)
33-
34-
Providers listed on the Terraform Registry can be automatically downloaded when initializing a working directory with `terraform init`. The Terraform configuration block is used to configure some behaviors of Terraform itself, such as the Terraform version and the required providers and versions.
35-
36-
**Example**: A Terraform configuration block.
37-
38-
```hcl
39-
terraform {
40-
required_providers {
41-
vra = {
42-
source = "vmware/vra"
43-
}
44-
}
45-
required_version = ">= 0.13"
46-
}
47-
```
48-
49-
You can use `version` locking and operators to require specific versions of the provider.
50-
51-
```hcl
52-
terraform {
53-
required_providers {
54-
vra = {
55-
source = "vmware/vra"
56-
version = ">= x.y.z"
57-
}
58-
}
59-
required_version = ">= 0.13"
60-
}
61-
```
62-
63-
[Read more](https://www.terraform.io/docs/configuration/providers.html#provider-versions) on Terraform provider configuration.
64-
65-
![Terraform](https://img.shields.io/badge/Terraform-0.12-blue?style=for-the-badge&logo=terraform)
66-
67-
The version meta-argument specifies a version constraint for a provider, and works the same way as the version argument in a `required_providers` block for the Terraform configuration block. The version constraint in a provider configuration is only used if the `required_providers` is not included for the provider in the Terraform configuration block.
68-
69-
```hcl
70-
provider "vra" {
71-
version = ">= x.y.z"
72-
...
73-
}
74-
```
75-
76-
> Important: The version argument in provider configurations is deprecated. In Terraform 0.13 and later. Version constraints should always be declared in the Terraform block using the `required_providers`.
77-
7824
## Upgrading the Provider
7925

8026
The provider does not upgrade automatically. After each new release, you can run the following command to upgrade the provider:
@@ -89,6 +35,4 @@ The project team welcomes contributions from the community. Before you start wor
8935

9036
## License
9137

92-
Copyright 2019-2021 VMware, Inc.
93-
9438
The Terraform Provider for VMware vRealize Automation is available under the [Mozilla Public License, version 2.0 license](LICENSE).

0 commit comments

Comments
 (0)