diff --git a/CHANGELOG.md b/CHANGELOG.md index de710d8..2084bd9 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,259 +1,373 @@ -## 1.15.1 (Apr 5, 2024) +# Release History -BUG FIXES: -* bump protobuf due to a security vulnerability +## 1.15.2 + +> Release Date: 2024-12-09 + +DOCUMENTATION: + +- Added install, build, and test documentation. [#265](https://github.com/vmware/terraform-provider-vmc/pull/265) + +CHORE: + +- Updated copyright and SPDX. [#246](https://github.com/vmware/terraform-provider-vmc/pull/246) +- Update `NOTICE`. [#241](https://github.com/vmware/terraform-provider-vmc/pull/241) +- Updated Code of Conduct. [#242](https://github.com/vmware/terraform-provider-vmc/pull/242) +- Removed superfluous files. [#260](https://github.com/vmware/terraform-provider-vmc/pull/260) + +- Go: + - Updated Go to v1.22.7. [#284](https://github.com/vmware/terraform-provider-vmc/pull/284) + +- Library Dependencies: + - Updated `github.com/stretchr/testify` from 1.10.0. [#283](https://github.com/vmware/terraform-provider-vmc/pull/283) + - Updated `github.com/hashicorp/terraform-plugin-sdk/v2` to 2.34.0. [#238](https://github.com/vmware/terraform-provider-vmc/pull/238) + - Updated `github.com/golang-jwt/jwt/v4` to 4.5.1. [#279](https://github.com/vmware/terraform-provider-vmc/pull/279) + - Updated `github.com/gofrs/uuid/v5` to 5.3.0. [#257](https://github.com/vmware/terraform-provider-vmc/pull/257) + +- Specific Packages: + - Updated `golang.org/x/oauth2` to 0.24.0. [#280](https://github.com/vmware/terraform-provider-vmc/pull/280) + - Updated `golang.org/x/net` to 0.23.0. [#233](https://github.com/vmware/terraform-provider-vmc/pull/233) -## 1.15 (Jan 25, 2024) +- SDKs: + - Updated `github.com/vmware/vsphere-automation-sdk-go/services/vmc/draas` to 0.7.0. [#220](https://github.com/vmware/terraform-provider-vmc/pull/220) + - Updated `github.com/vmware/vsphere-automation-sdk-go/services/nsxt-vmc-aws-integration` to 0.8.0. [#228](https://github.com/vmware/terraform-provider-vmc/pull/228) + +- Linting: + - Fixed grammar. [#286](https://github.com/vmware/terraform-provider-vmc/pull/286) + - Fixed variable naming. [#268](https://github.com/vmware/terraform-provider-vmc/pull/268) + - Fixed non-constant format strings. [#267](https://github.com/vmware/terraform-provider-vmc/pull/267) + - Fixed staticcheck ST1005. [#273](https://github.com/vmware/terraform-provider-vmc/pull/273) + - Fixed nosec g101. [#270](https://github.com/vmware/terraform-provider-vmc/pull/270) + - Fixed indent-error-flow. [#269](https://github.com/vmware/terraform-provider-vmc/pull/269) + +## 1.15.1 + +> Release Date: 2024-04-05 + +CHORE: + +- Updated `google.golang.org/protobuf` to 1.33.0. [#217](https://github.com/vmware/terraform-provider-vmc/pull/217) + +## 1.15.0 + +> Release Date: 2024-01-25 ENHANCEMENT: -* bumping vsphere-automation-sdk-go/services/vmc to v0.14.0 -* Added support for disk less instances c6i/m7i [\#214](https://github.com/vmware/terraform-provider-vmc/pull/214) + +- Updated `vsphere-automation-sdk-go/services/vmc` to v0.14.0. +- Added support for disk less instances c6i/m7i. [\#214](https://github.com/vmware/terraform-provider-vmc/pull/214) ## 1.14 -Breaking changes: -* Removing support for r5.metal instances [\#205](https://github.com/vmware/terraform-provider-vmc/pull/205) -* removing `storage_capacity` field from sddc and cluster resources schema [\#205](https://github.com/vmware/terraform-provider-vmc/pull/205) +> Release Date: 2023-11-24 + +BREAKING CHANGES: + +- Removed support for r5.metal instances. [\#205](https://github.com/vmware/terraform-provider-vmc/pull/205) +- Removed `storage_capacity` field from sddc and cluster resources schema. [\#205](https://github.com/vmware/terraform-provider-vmc/pull/205) BUG FIXES: -* Failure during SDDC group creation [\#208](https://github.com/vmware/terraform-provider-vmc/pull/210) +- Fixed failure during SDDC group creation. [\#208](https://github.com/vmware/terraform-provider-vmc/pull/210) + +## 1.13.3 -## 1.13.3 (Aug 21, 2023) +> Release Date: 2023-08-21 BUG FIXES: -* Fixing errors when creating and deleting multiple srm nodes [\#175](https://github.com/vmware/terraform-provider-vmc/pull/195) +- Fixed errors when creating and deleting multiple srm nodes. [\#175](https://github.com/vmware/terraform-provider-vmc/pull/195) + +## 1.13.2 -## 1.13.2 (Aug 8, 2023) +> Release Date: 2023-08-08 BUG FIXES: -* Fixing errors when reading Customer Subnets [\#191](https://github.com/vmware/terraform-provider-vmc/pull/191) +- Fixing errors when reading customer subnets. [\#191](https://github.com/vmware/terraform-provider-vmc/pull/191) +## 1.13.1 -## 1.13.1 (Aug 4, 2023) +> Release Date: 2023-08-04 BUG FIXES: -* Allowing usage of microsoft_license_config upon SDDC creation. Reading microsoft_license_config.academic_license field [\#190](https://github.com/vmware/terraform-provider-vmc/pull/190) +- Fixed allowing usage of `microsoft_license_config` upon SDDC creation. Reading `microsoft_license_config.academic_license` field. [\#190](https://github.com/vmware/terraform-provider-vmc/pull/190) -ENHANCEMENT: -* Bump google.golang.org/grpc from 1.51.0 to 1.53.0 [\#184](https://github.com/vmware/terraform-provider-vmc/pull/184) -* Updates to documentation [\#186](https://github.com/vmware/terraform-provider-vmc/pull/186) +DOCUMENTATION: + +- Updated documentation. [\#186](https://github.com/vmware/terraform-provider-vmc/pull/186) -## 1.13 (Feb 23, 2023) +CHORE: + +- Updated `google.golang.org/grpc`1.53.0. [\#184](https://github.com/vmware/terraform-provider-vmc/pull/184) + +## 1.13.0 + +> Release Date: 2023-02-23 FEATURES: -* Added support for OAuth2.0 app authentication [\#173](https://github.com/vmware/terraform-provider-vmc/pull/173) +- Added support for OAuth2.0 app authentication. [\#173](https://github.com/vmware/terraform-provider-vmc/pull/173) + +CHORE: -Fixes for security vulnerabilities. +- Fixes for security vulnerabilities. -## 1.12.1 (Feb 3, 2023) +## 1.12.1 + +> Release Date: 2023-02-20 BUG FIXES: -* Destroying sddc_group times out and then fails on subsequent attempts [\#172](https://github.com/vmware/terraform-provider-vmc/pull/172) -* Remove restrictions on 6 hosts minimum in MultiAZ SDDCs [\#171](https://github.com/vmware/terraform-provider-vmc/pull/171) +- Fixed destroying `sddc_group `times out and then fails on subsequent attempts. [\#172](https://github.com/vmware/terraform-provider-vmc/pull/172) +- Removeed restrictions on 6 hosts minimum in Multi-AZ SDDCs. [\#171](https://github.com/vmware/terraform-provider-vmc/pull/171) + +## 1.12.0 -## 1.12.0 (Nov 9, 2022) +> Release Date: 2022-11-09 FEATURES: -* Added support for SDDC Groups +- Added support for SDDC Groups. [\#163](https://github.com/vmware/terraform-provider-vmc/pull/163) + +## 1.11.0 -## 1.11.0 (Oct 17, 2022) +> Release Date: 2022-11-17 FEATURES: -* `num_hosts` property on SDDC now shows and controls the number of hosts in the primary cluster (created by default with an SDDC). Previously there was no way to scale up/down the number of hosts in the primary cluster -* Cluster operations like Create/Update/Destroy on more than one cluster can now be initiated simultaneously, without the need for depends_on=[] -* Error reporting improvements +- `num_hosts` property on SDDC now shows and controls the number of hosts in the primary cluster (created by default with an SDDC). Previously there was no way to scale up/down the number of hosts in the primary cluster +- Cluster operations like Create/Update/Destroy on more than one cluster can now be initiated simultaneously, without the need for depends_on=[] +- Error reporting improvements BUG FIXES: -* EDRS settings are not truly "Optional" [\#151](https://github.com/vmware/terraform-provider-vmc/pull/151) -* Lack of multi-cluster SDDC support in "resourceSddcUpdate" function [\#155](https://github.com/vmware/terraform-provider-vmc/pull/155) -* vmc_cluster resource tries to create new clusters simultaneously and fails [\#160](https://github.com/vmware/terraform-provider-vmc/pull/160) +- EDRS settings are not truly "Optional" [\#151](https://github.com/vmware/terraform-provider-vmc/pull/151) +- Lack of multi-cluster SDDC support in "resourceSddcUpdate" function [\#155](https://github.com/vmware/terraform-provider-vmc/pull/155) +- `vmc_cluster` resource tries to create new clusters simultaneously and fails [\#160](https://github.com/vmware/terraform-provider-vmc/pull/160) -## 1.10.1 (Sep 20, 2022) +## 1.10.1 + +> Release Date: 2022-09-20 BUG FIXES: -Defaults for enable_edrs, edrs_policy_type, max_hosts, min_hosts should not be set to null https://github.com/vmware/terraform-provider-vmc/issues/94 -## 1.10.0 (Jul 12, 2022) +- Fixed defaults for `enable_edrs`, `edrs_policy_type`, `max_hosts`, and `min_hosts` should not be set to null. [\#94](https://github.com/vmware/terraform-provider-vmc/issues/94) + +## 1.10.0 + +> Release Date: 2022-07-12 FEATURES: -* `vmc_sddc` Added I4I_METAL host instance type support. +- `vmc_sddc` Added I4I_METAL host instance type support. BUG FIXES: -* Allow min_hosts as low as 2 as per VMC service backend default value [\#147](https://github.com/vmware/terraform-provider-vmc/pull/147) -* Removed references to R5 host instance type in examples as new deployments are unavailable [\#146](https://github.com/vmware/terraform-provider-vmc/pull/146) +- Allow `min_hosts` as low as 2 as per VMC service backend default value. [\#147](https://github.com/vmware/terraform-provider-vmc/pull/147) +- Removed references to R5 host instance type in examples as new deployments are unavailable. [\#146](https://github.com/vmware/terraform-provider-vmc/pull/146) + +## 1.9.3 -## 1.9.3 (Jun 7, 2022) +> Release Date: 2022-06-07 BUG FIXES: -* nil derreference when doing "terraform plan" in some environments (https://github.com/vmware/terraform-provider-vmc/pull/142) -## 1.9.2 (Jun 7, 2022) +- Fixed nil dereference when doing "terraform plan" in some environments. (https://github.com/vmware/terraform-provider-vmc/pull/142) + +## 1.9.2 + +> Release Date: 2022-06-07 BUG FIXES: -* nil derreference when doing "terraform plan" in some environments (https://github.com/vmware/terraform-provider-vmc/pull/141) -ENHANCEMENT: +- Fixed nil dereference when doing "terraform plan" in some environments (https://github.com/vmware/terraform-provider-vmc/pull/141) + +CHORE: + +- Updated `hashicorp/terraform-plugin-sdk` to v2.11.0. (https://github.com/vmware/terraform-provider-vmc/pull/140) -* Upgrade to TF plugin SDK v2.11.0 due to CVE-2022-30323 (https://github.com/vmware/terraform-provider-vmc/pull/140) +## 1.9.1 -## 1.9.1 (Mar 28, 2022) +> Release Date: 2022-03-28 BUG FIXES: -* Example files in /examples/.. dir now have a required_providers declaration, fixing "terraform init" -## 1.9.0 (Mar 16, 2022) +- Example files in `/examples/..` now have a `required_providers` declaration, fixing "terraform init". -ENHANCEMENT: -* Upgrade Provider to use VMC SDK 0.8.0 [\#130](https://github.com/vmware/terraform-provider-vmc/pull/130) +## 1.9.0 -## 1.8.0 (Nov 10, 2021) +> Release Date: 2022-03-16 -ENHANCEMENT: - * Upgrade Provider to use VMC SDK 0.6.0 [\#116](https://github.com/vmware/terraform-provider-vmc/pull/116), [\#118](https://github.com/vmware/terraform-provider-vmc/pull/118) - * Direct access to NSX Manager[\#116](https://github.com/vmware/terraform-provider-vmc/pull/116) +CHORE: -BUG FIXES: - * Property "esx_hosts" in SddcResourceConfig is deprecated. [\#119](https://github.com/vmware/terraform-provider-vmc/pull/119) +- Updated `github.com/vmware/vsphere-automation-sdk-go/services/vmc` to 0.8.0. [\#130](https://github.com/vmware/terraform-provider-vmc/pull/130) + +## 1.8.0 -## 1.7.0 (Aug 5, 2021) +> Release Date: 2021-11-21 ENHANCEMENT: - * Upgrade to TF plugin SDK v2 [\#108](https://github.com/vmware/terraform-provider-vmc/pull/108) + - Added firect access to NSX Manager. [\#116](https://github.com/vmware/terraform-provider-vmc/pull/116) BUG FIXES: - * Fix for static check failures caused by references to deprecated functions [\#109](https://github.com/vmware/terraform-provider-vmc/pull/109) + - Deprecated `esx_hosts` property in `SddcResourceConfig`. [\#119](https://github.com/vmware/terraform-provider-vmc/pull/119) -## 1.6.0 (May 17, 2021) +CHORE: -FEATURES: +- Updated `github.com/vmware/vsphere-automation-sdk-go/services/vmc` to 0.6.0. [\#130](https://github.com/vmware/terraform-provider-vmc/pull/130) + [\#116](https://github.com/vmware/terraform-provider-vmc/pull/116), [\#118](https://github.com/vmware/terraform-provider-vmc/pull/118) + +## 1.7.0 - * Support for SDDC data source [\#105](https://github.com/vmware/terraform-provider-vmc/pull/105) - * Support for M1 mac [\#107](https://github.com/vmware/terraform-provider-vmc/pull/107) +> Release Date: 2021-08-05 - BUG FIXES: +BUG FIXES: + +- Fixed static check failures caused by references to deprecated functions. [\#109](https://github.com/vmware/terraform-provider-vmc/pull/109) - * Fix for updating multiple params in SDDC resource [\#101](https://github.com/vmware/terraform-provider-vmc/pull/101) +ENHANCEMENT: -## 1.5.1 (January 21, 2021) +- Upgraded `hashicorp/terraform-plugin-sdk` to v2. [\#108](https://github.com/vmware/terraform-provider-vmc/pull/108) - BUG FIXES: +## 1.6.0 - * Moved subnet validation from customized diff to create SDDC block [\#96](https://github.com/vmware/terraform-provider-vmc/pull/96) - * Added zerocloud check for setting intranet MTU uplink [\#98](https://github.com/vmware/terraform-provider-vmc/pull/98) - * Updated help documentation to specify current limitations in import SDDC functionality [\#97](https://github.com/vmware/terraform-provider-vmc/pull/97) +> Release Date: 2021-05-17 + +BUG FIXES: -## 1.5.0 (January 5, 2021) +- Fix for updating multiple params in SDDC resource. [\#101](https://github.com/vmware/terraform-provider-vmc/pull/101) FEATURES: - * `vmc_sddc`, `vmc_cluster` Added microsoft licensing configuration to SDDC and cluster resource [\#71](https://github.com/vmware/terraform-provider-vmc/pull/71) - * Added intranet_uplink_mtu field in `vmc_sddc` resource [\#88](https://github.com/vmware/terraform-provider-vmc/pull/88) +- Added support for SDDC data source. [\#105](https://github.com/vmware/terraform-provider-vmc/pull/105) +- Added support for M1 Mac. [\#107](https://github.com/vmware/terraform-provider-vmc/pull/107) + +## 1.5.1 + +> Release Date: 2021-01-21 + +BUG FIXES: - BUG FIXES: +- Moved subnet validation from customized diff to create SDDC block. [\#96](https://github.com/vmware/terraform-provider-vmc/pull/96) +- Added zerocloud check for setting intranet MTU uplink. [\#98](https://github.com/vmware/terraform-provider-vmc/pull/98) - * Removed validation on sddc_type field in order to allow empty value. [\#72](https://github.com/vmware/terraform-provider-vmc/pull/72) - * Removed default values to fix EDRS configuration error for 1NODE SDDC [\#83](https://github.com/vmware/terraform-provider-vmc/pull/83) - * Added check to store vxlan_subnet information in terraform state file only when skip_creating_vxlan = false [\#86](https://github.com/vmware/terraform-provider-vmc/pull/86) +DOCUMENTATION: -## 1.4.0 (October 12, 2020) +- Updated help documentation to specify current limitations in import SDDC functionality. [\#97](https://github.com/vmware/terraform-provider-vmc/pull/97) + +## 1.5.0 + +> Release Date: 2021-01-05 + +BUG FIXES: + +- Removed validation on `sddc_type` field in order to allow empty value. [\#72](https://github.com/vmware/terraform-provider-vmc/pull/72) +- Removed default values to fix EDRS configuration error for 1NODE SDDC. [\#83](https://github.com/vmware/terraform-provider-vmc/pull/83) +- Added check to store `vxlan_subnet` information in terraform state file only when `skip_creating_vxlan = false`. [\#86](https://github.com/vmware/terraform-provider-vmc/pull/86) FEATURES: -* `vmc_sddc` Added I3EN_METAL host instance type support. [\#42](https://github.com/vmware/terraform-provider-vmc/pull/42) -* `vmc_sddc` Modified code to enable EDRS policy configuration. [\#43](https://github.com/vmware/terraform-provider-vmc/pull/43) -* `vmc_sddc` Added size parameter in resource schema to enable users to deploy large SDDC. [\#59](https://github.com/vmware/terraform-provider-vmc/pull/59) +- `vmc_sddc`, `vmc_cluster` Added Microsoft licensing configuration to SDDC and cluster resource. [\#71](https://github.com/vmware/terraform-provider-vmc/pull/71) +- Added intranet_uplink_mtu field in `vmc_sddc` resource. [\#88](https://github.com/vmware/terraform-provider-vmc/pull/88) + +## 1.4.0 + +> Release Date: 2020-10-12 BUG FIXES: -* Added check in resourceClusterRead to see if cluster exists and remove cluster information from terraform state file. [\#48](https://github.com/vmware/terraform-provider-vmc/pull/48) -* Added validation check for customer subnet IDs based on the deployment type. [\#54](https://github.com/vmware/terraform-provider-vmc/pull/54) +- Added check in resourceClusterRead to see if cluster exists and remove cluster information from terraform state file. [\#48](https://github.com/vmware/terraform-provider-vmc/pull/48) +- Added validation check for customer subnet IDs based on the deployment type. [\#54](https://github.com/vmware/terraform-provider-vmc/pull/54) ENHANCEMENTS: -* Modified Importer State in `vmc_cluster` and `vmc_public_ip` resources for terraform import command. [\#49](https://github.com/vmware/terraform-provider-vmc/pull/49) - -## 1.3.0 (June 18, 2020) +- Modified Importer State in `vmc_cluster` and `vmc_public_ip` resources for terraform import command. [\#49](https://github.com/vmware/terraform-provider-vmc/pull/49) FEATURES: -* **New Resource:** `vmc_cluster` Added resource for cluster management. [\#25](https://github.com/vmware/terraform-provider-vmc/pull/25) +- `vmc_sddc` Added I3EN_METAL host instance type support. [\#42](https://github.com/vmware/terraform-provider-vmc/pull/42) +- `vmc_sddc` Modified code to enable EDRS policy configuration. [\#43](https://github.com/vmware/terraform-provider-vmc/pull/43) +- `vmc_sddc` Added size parameter in resource schema to enable users to deploy large SDDC. [\#59](https://github.com/vmware/terraform-provider-vmc/pull/59) + +## 1.3.0 + +> Release Date: 2020-06-18 BUG FIXES: -* Modified code to store num_host in resourceSddcRead method [\#39](https://github.com/vmware/terraform-provider-vmc/pull/39) +- Modified code to store num_host in resourceSddcRead method. [\#39](https://github.com/vmware/terraform-provider-vmc/pull/39) + +FEATURES: + +- - **New Resource:** - `vmc_cluster` Added resource for cluster management. [\#25](https://github.com/vmware/terraform-provider-vmc/pull/25) ENHANCEMENTS: -* Validation check added for MultiAZ SDDC [\#35](https://github.com/vmware/terraform-provider-vmc/pull/29) -* Added detailed error handler functions for CRUD operations on resources and data sources [\#35](https://github.com/vmware/terraform-provider-vmc/pull/29) -* Added documentation for vmc_cluster resource [\#26](https://github.com/vmware/terraform-provider-vmc/pull/26) +- Validation check added for Multi-AZ SDDC. [\#35](https://github.com/vmware/terraform-provider-vmc/pull/29) +- Added detailed error handler functions for CRUD operations on resources and data sources. [\#35](https://github.com/vmware/terraform-provider-vmc/pull/29) +- Added documentation for vmc_cluster resource. [\#26](https://github.com/vmware/terraform-provider-vmc/pull/26) -## 1.2.1 (May 04, 2020) +## 1.2.1 + +> Release Date: 2020-05-04 BUG FIXES: -* Added instructions for delay needed after SDDC creation for site recovery [\#21](https://github.com/vmware/terraform-provider-vmc/pull/21) -* Removed capitalized error messages from code [\#23](https://github.com/vmware/terraform-provider-vmc/pull/23) -* Updated module name in `go.mod`. [\#24](https://github.com/vmware/terraform-provider-vmc/pull/24) +- Added instructions for delay needed after SDDC creation for site recovery. [\#21](https://github.com/vmware/terraform-provider-vmc/pull/21) +- Removed capitalized error messages from code. [\#23](https://github.com/vmware/terraform-provider-vmc/pull/23) +- Updated module name in `go.mod`. [\#24](https://github.com/vmware/terraform-provider-vmc/pull/24) ENHANCEMENTS: -* Updated dependencies version to latest in go.mod [\#20](https://github.com/vmware/terraform-provider-vmc/pull/20) -* Added sample .tf file for each resource in examples folder [\#22](https://github.com/vmware/terraform-provider-vmc/pull/22) +- Updated dependencies version to latest in `go.mod`. [\#20](https://github.com/vmware/terraform-provider-vmc/pull/20) +- Added sample `.tf` file for each resource in examples folder. [\#22](https://github.com/vmware/terraform-provider-vmc/pull/22) + +## 1.2.0 -## 1.2.0 (April 03, 2020) +> Release Date: 2020-04-03 FEATURES: -* **New Resource:** `vmc_site_recovery` Added resource for site recovery management. [\#14](https://github.com/vmware/terraform-provider-vmc/pull/14) -* **New Resource:** `vmc_srm_node` Added resource to add SRM instance after site recovery has been activated. [\#14](https://github.com/vmware/terraform-provider-vmc/pull/14) +- - **New Resource:** - `vmc_site_recovery` Added resource for site recovery management. [\#14](https://github.com/vmware/terraform-provider-vmc/pull/14) +- - **New Resource:** - `vmc_srm_node` Added resource to add SRM instance after site recovery has been activated. [\#14](https://github.com/vmware/terraform-provider-vmc/pull/14) +## 1.1.1 -## 1.1.1 (March 24, 2020) +> Release Date: 2020-03-24 BUG FIXES: -* Set ForceNew for host_instance_type to true in order to enforce SDDC redeploy when host_instance_type is changed [\#5](https://github.com/vmware/terraform-provider-vmc/pull/5) -* Fix for re-creating public IP if it is accidentally delete via console. [\#11](https://github.com/vmware/terraform-provider-vmc/pull/11) -* Updated variables.tf for description of fields. [\#10](https://github.com/vmware/terraform-provider-vmc/pull/10) +- Set ForceNew for `host_instance_type` to `true` in order to enforce SDDC redeploy when `host_instance_type` is changed. [\#5](https://github.com/vmware/terraform-provider-vmc/pull/5) +- Fix for re-creating public IP if it is accidentally delete via console. [\#11](https://github.com/vmware/terraform-provider-vmc/pull/11) +- Updated `variables.tf` for description of fields. [\#10](https://github.com/vmware/terraform-provider-vmc/pull/10) +## 1.1.0 -## 1.1.0 (March 10, 2020) +> Release Date: 2020-03-10 FEATURES: -* **New Resource:** `vmc_sddc` -* **New Resource:** `vmc_public_ip` [\#43](https://github.com/vmware/terraform-provider-vmc/pull/43) -* **New Data Source:** `vmc_org` -* **New Data Source:** `vmc_connected_accounts` -* **New Data Source:** `vmc_customer_subnets` - +- **New Resource:** - `vmc_sddc` +- **New Resource:** - `vmc_public_ip` [\#43](https://github.com/vmware/terraform-provider-vmc/pull/43) +- **New Data Source:** - `vmc_org` +- **New Data Source:** - `vmc_connected_accounts` +- **New Data Source:** - `vmc_customer_subnets` ENHANCEMENTS: -* vmc_sddc: Added nsxt_reverse_proxy_url to SDDC resource data. [\#23](https://github.com/vmware/terraform-provider-vmc/pull/23) -* vmc_connected_accounts: Added filtering to return AWS account ID associated with the account number provided in configuration. [\#30](https://github.com/vmware/terraform-provider-vmc/pull/30) -* provider.go: Added org_id as a required parameter in terraform schema. [\#38](https://github.com/vmware/terraform-provider-vmc/pull/38) -* data_source_vmc_customer_subnets.go : Added validateFunctions for sddc and customer subnet resources. [\#41](https://github.com/vmware/terraform-provider-vmc/pull/41) -* examples/main.tf : Added expression to convert AWS specific region to VMC region. [\#46](https://github.com/vmware/terraform-provider-vmc/pull/46) - +- `vmc_sddc`: Added nsxt_reverse_proxy_url to SDDC resource data. [\#23](https://github.com/vmware/terraform-provider-vmc/pull/23) +- `vmc_connected_accounts`: Added filtering to return AWS account ID associated with the account number provided in configuration. [\#30](https://github.com/vmware/terraform-provider-vmc/pull/30) +- `provider.go`: Added `org_id` as a required parameter in terraform schema. [\#38](https://github.com/vmware/terraform-provider-vmc/pull/38) +- `data_source_vmc_customer_subnets.go`: Added `validateFunctions` for sddc and customer subnet resources. [\#41](https://github.com/vmware/terraform-provider-vmc/pull/41) +- `examples/main.tf`: Added expression to convert AWS specific region to VMC region. [\#46](https://github.com/vmware/terraform-provider-vmc/pull/46) BUG FIXES: -* Moved main.tf to examples folder. [\#17](https://github.com/vmware/terraform-provider-vmc/pull/17) -* License statement fixed. [\#8](https://github.com/vmware/terraform-provider-vmc/pull/8) -* Implemented connected account data source to return a single account ID associated with the account number. [\#40](https://github.com/vmware/terraform-provider-vmc/pull/40) -* Set ForceNew for host_instance_type to true in order to enforce SDDC redeploy when host_instance_type is changed. [\#5](https://github.com/vmware/terraform-provider-vmc/pull/5) +- Moved `main.tf` to `examples` folder. [\#17](https://github.com/vmware/terraform-provider-vmc/pull/17) +- License statement fixed. [\#8](https://github.com/vmware/terraform-provider-vmc/pull/8) +- Implemented connected account data source to return a single account ID associated with the account number. [\#40](https://github.com/vmware/terraform-provider-vmc/pull/40) +- Set ForceNew for `host_instance_type` to true in order to enforce SDDC redeploy when `host_instance_type` is changed. [\#5](https://github.com/vmware/terraform-provider-vmc/pull/5) diff --git a/website/docs/index.html.markdown b/website/docs/index.html.markdown index ac30dd5..5fb490e 100644 --- a/website/docs/index.html.markdown +++ b/website/docs/index.html.markdown @@ -1,55 +1,33 @@ --- layout: "vmc" -page_title: "Provider: VMC" +page_title: "Terraform Provider for VMware Cloud on AWS" sidebar_current: "docs-vmc-index" description: |- - The Terraform Provider for VMware Cloud + Terraform Provider for VMware Cloud on AWS --- -# VMware Cloud on AWS Provider +VMware Cloud on AWS -The VMware Cloud on AWS provider can be used to configure hybrid cloud infrastructure using the resources supported by VMware Cloud on AWS. +# Terraform Provider for VMware Cloud on AWS +The Terraform Provider for [VMware Cloud on AWS][product-documentation] is a plugin for Terraform that allows you to +interact with VMware Cloud on AWS. -More information on VMC can be found on the [VMC Product Page](https://cloud.vmware.com/vmc-aws) +## Example Usage -Please use the navigation to the left to read about available data sources and -resources. - -## Basic Configuration of the VMware Cloud on AWS Provider - -In order to use the provider you need to obtain the authentication -token from the Cloud Service Provider by providing the org scoped API token. -The provider client uses Cloud Service Provider (CSP) API -to exchange this org scoped API token/OAuth App ID and Secret for user access token. - -Note that in all the examples you will need to update the `client_id` and `client_secret` or `api_token` -and `org_id` settings in the variables.tf file to match those configured in your VMC environment. - - -## Argument Reference - -The following arguments are used to configure the VMware Cloud on AWS Provider: - -* `api_token` - (Required, in conflict with "client_id" and "client_secret") API token is used to authenticate when calling VMware Cloud Services APIs. - This token is scoped within the organization. -* `client_id` - (Required in pair with "client_secret", in conflict with "api_token") ID of OAuth App associated with the organization. The combination with - "client_secret" is used to authenticate when calling VMware Cloud Services APIs. -* `client_secret` - (Required in pair with "client_id", in conflict with "api_token") Secret of OAuth App associated with the organization. The combination with - "client_id" is used to authenticate when calling VMware Cloud Services APIs. -* `org_id` - (Required) Organization Identifier. -* `vmc_url` - (Optional) VMware Cloud on AWS URL. Default : https://vmc.vmware.com -* `csp_url` - (Optional) Cloud Service Provider URL. Default : https://console.cloud.vmware.com - -#### Example main.tf file - -This file will define the logical topology that Terraform will -create in VMC. +In order to use the provider you need to obtain the authentication token from the Cloud Service Provider by providing +the org scoped API token. The provider client uses Cloud Service Provider (CSP) API to exchange this org scoped API +token/OAuth App ID and Secret for user access token. ```hcl -# -# The first step is to configure the provider to connect to Cloud Service -# Provider. +terraform { + required_providers { + vcf = { + source = "vmware/vmc" + version = "x.y.z" + } + } +} provider "vmc" { refresh_token = var.api_token @@ -82,6 +60,7 @@ resource "vmc_sddc" "sddc_1" { customer_subnet_ids = [data.vmc_customer_subnets.my_subnets.ids[0]] connected_account_id = data.vmc_connected_accounts.my_accounts.id } + timeouts { create = "300m" update = "300m" @@ -93,5 +72,28 @@ resource "vmc_public_ip" "public_ip_1" { nsxt_reverse_proxy_url = vmc_sddc.sddc_1.nsxt_reverse_proxy_url display_name = var.public_ip_displayname } - ``` + +Refer to the provider documentation for information on all of the resources +and data sources supported by this provider. Each includes a detailed +description of the purpose and how to use it. + +## Argument Reference + +The following arguments are used to configure the provider: + +* `api_token` - (Required, in conflict with `client_id` and `client_secret`) + API token is used to authenticate when calling VMware Cloud Services APIs. + This token is scoped within the organization. +* `client_id` - (Required in pair with `client_secret`, in conflict with `api_token`) + ID of OAuth App associated with the organization. The combination with + "client_secret" is used to authenticate when calling VMware Cloud Services + APIs. +* `client_secret` - (Required in pair with `client_id`, in conflict with `api_token`) + Secret of OAuth App associated with the organization. The combination with + "client_id" is used to authenticate when calling VMware Cloud Services APIs. +* `org_id` - (Required) Organization Identifier. +* `vmc_url` - (Optional) VMware Cloud on AWS URL. Default: https://vmc.vmware.com +* `csp_url` - (Optional) Cloud Service Provider URL. Default: https://console.cloud.vmware.com + +[product-documentation]: https://docs.vmware.com/en/VMware-Cloud-on-AWS/index.html \ No newline at end of file