From d03a2beda9254b51b66ac6e03e59883a9299c67b Mon Sep 17 00:00:00 2001
From: Ryan Johnson <ryan.johnson@broadcom.com>
Date: Tue, 15 Oct 2024 10:22:41 -0400
Subject: [PATCH] docs: add install, build, and test docs

Adds seperate documenation for the installation, buiild, and testing of the provider to be linked to an updated `README.md`.

Signed-off-by: Ryan Johnson <ryan.johnson@broadcom.com>
---
 docs/build.md              |  51 +++++++
 docs/images/icon-color.png | Bin 0 -> 15970 bytes
 docs/install.md            | 272 +++++++++++++++++++++++++++++++++++++
 docs/test.md               |  63 +++++++++
 4 files changed, 386 insertions(+)
 create mode 100644 docs/build.md
 create mode 100644 docs/images/icon-color.png
 create mode 100644 docs/install.md
 create mode 100644 docs/test.md

diff --git a/docs/build.md b/docs/build.md
new file mode 100644
index 0000000..423d07f
--- /dev/null
+++ b/docs/build.md
@@ -0,0 +1,51 @@
+<!--
+© Broadcom. All Rights Reserved.
+The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
+SPDX-License-Identifier: MPL-2.0
+-->
+
+<!-- markdownlint-disable first-line-h1 no-inline-html -->
+
+<img src="images/icon-color.png" alt="VMware Cloud on AWS" width="150">
+
+# Building the Terraform Provider for VMware Cloud on AWS
+
+The instructions outlined below are specific to macOS and Linux only.
+
+If you wish to work on the provider, you'll first need [Go][golang-install] installed on your
+machine. Check the [requirements][requirements] before proceeding.
+
+1. Clone the repository to: `$GOPATH/src/github.com/vmware/terraform-provider-vmc`
+
+   ```sh
+   mkdir -p $GOPATH/src/github.com/vmware
+   cd $GOPATH/src/github.com/vmware
+   git clone git@github.com:vmware/terraform-provider-vmc.git
+   ```
+
+2. Enter the provider directory to build the provider.
+
+   ```sh
+   cd $GOPATH/src/github.com/vmware/terraform-provider-vmc
+   go get
+   go build -o terraform-provider-vmc
+   ```
+
+3. Add the following to your `~/.terraformrc`:
+
+   ```hcl
+   provider_installation {
+     dev_overrides {
+       "vmware/vcf" = "/Users/rainpole/go/bin"
+     }
+
+     direct {}
+   }
+   ```
+
+    Where `/Users/rainpole/go/bin` is your `GOPATH/bin` path.
+
+4. Run `go install` to install the development binary.
+
+[golang-install]: https://golang.org/doc/install
+[requirements]: https://github.com/vmware/terraform-provider-vmc#requirements
diff --git a/docs/images/icon-color.png b/docs/images/icon-color.png
new file mode 100644
index 0000000000000000000000000000000000000000..e45e2762c0b0b03d0638153629fe7d27819f52d5
GIT binary patch
literal 15970
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
N(&7qY6(U9f{|6*-d;<Ug

literal 0
HcmV?d00001

diff --git a/docs/install.md b/docs/install.md
new file mode 100644
index 0000000..3da5d4d
--- /dev/null
+++ b/docs/install.md
@@ -0,0 +1,272 @@
+<!--
+© Broadcom. All Rights Reserved.
+The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
+SPDX-License-Identifier: MPL-2.0
+-->
+
+<!-- markdownlint-disable first-line-h1 no-inline-html -->
+
+<img src="images/icon-color.png" alt="VMware Cloud on AWS" width="150">
+
+# Installing the Terraform Provider for VMware Cloud on AWS
+
+## Automated Installation (Recommended)
+
+The Terraform Provider for VMware Cloud on AWS is a Partner Tier provider.
+
+Partner 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.
+
+### Configure the Terraform Configuration Files
+
+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.
+
+**Example**: A Terraform configuration block.
+
+```hcl
+terraform {
+  required_providers {
+    vmc = {
+      source  = "vmware/vmc"
+    }
+  }
+  required_version = ">= x.y.z"
+}
+```
+
+You can use `version` locking and operators to require specific versions of the provider.
+
+**Example**: A Terraform configuration block with the provider versions.
+
+```hcl
+terraform {
+  required_providers {
+    vmc = {
+      source  = "vmware/vmc"
+      version = ">= x.y.z"
+    }
+  }
+  required_version = ">= x.y.z"
+}
+```
+
+To specify a particular provider version when installing released providers, see the Terraform documentation [on provider versioning][terraform-provider-versioning]
+
+### Verify Terraform Initialization Using the Terraform Registry
+
+To verify the initialization, navigate to the working directory for your Terraform configuration and run `terraform init`. You should see a message indicating that Terraform has been successfully initialized and has installed the provider from the Terraform Registry.
+
+**Example**: Initialize and Download the Provider.
+
+```console
+$ terraform init
+
+Initializing the backend...
+
+Initializing provider plugins...
+- Finding vmware/vmc versions matching ">= x.y.z" ...
+- Installing vmware/vmc x.y.z ...
+- Installed vmware/vmc x.y.z
+...
+
+Terraform has been successfully initialized!
+```
+
+## Manual Installation
+
+The latest release of the provider can be found in the [releases][releases]. You can download the appropriate version of the provider for your operating system using a command line shell or a browser.
+
+This can be useful in environments that do not allow direct access to the Internet.
+
+### Linux
+
+The following examples use Bash on Linux (x64).
+
+1. On a Linux operating system with Internet access, download the plugin from GitHub using the shell.
+
+   ```console
+   RELEASE=x.y.z
+   wget -q https://github.com/vmware/terraform-provider-vmc/releases/download/v${RELEASE}/terraform-provider-vmc_${RELEASE}_linux_amd64.zip
+   ```
+
+2. Extract the plugin.
+
+   ```console
+   unzip terraform-provider-vmc_${RELEASE}_linux_amd64.zip -d terraform-provider-vmc_${RELEASE}
+   ```
+
+3. Create a directory for the provider.
+
+   > **Note**
+   >
+   > The directory hierarchy that Terraform uses to precisely determine the source of each provider it finds locally.
+   >
+   > `$PLUGIN_DIRECTORY/$SOURCEHOSTNAME/$SOURCENAMESPACE/$NAME/$VERSION/$OS_$ARCH/`
+
+   ```console
+   mkdir -p ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/linux_amd64
+   ```
+
+4. Copy the extracted plugin to a target system and move to the Terraform plugins directory.
+
+   ```console
+   mv terraform-provider-vmc_${RELEASE}/terraform-provider-vmc_v${RELEASE} ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/linux_amd64
+   ```
+
+5. Verify the presence of the plugin in the Terraform plugins directory.
+
+   ```console
+   cd ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/linux_amd64
+   ls
+   ```
+
+### macOS
+
+The following example uses Bash (default) on macOS (Intel).
+
+1. On a macOS operating system with Internet access, install wget with [Homebrew](https://brew.sh).
+
+   ```console
+   brew install wget
+   ```
+
+2. Download the plugin from GitHub using the shell.
+
+   ```console
+   RELEASE=x.y.z
+   wget -q https://github.com/vmware/terraform-provider-vmc/releases/download/v${RELEASE}/terraform-provider-vmc_${RELEASE}_darwin_amd64.zip
+   ```
+
+3. Extract the plugin.
+
+   ```console
+   unzip terraform-provider-vmc_${RELEASE}_darwin_amd64.zip -d terraform-provider-vmc_${RELEASE}
+   ```
+
+4. Create a directory for the provider.
+
+   > **Note**
+   >
+   > The directory hierarchy that Terraform uses to precisely determine the source of each provider it finds locally.
+   >
+   > `$PLUGIN_DIRECTORY/$SOURCEHOSTNAME/$SOURCENAMESPACE/$NAME/$VERSION/$OS_$ARCH/`
+
+   ```console
+   mkdir -p ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/darwin_amd64
+   ```
+
+5. Copy the extracted plugin to a target system and move to the Terraform plugins directory.
+
+   ```console
+   mv terraform-provider-vmc_${RELEASE}/terraform-provider-vmc_v${RELEASE} ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/darwin_amd64
+   ```
+
+6. Verify the presence of the plugin in the Terraform plugins directory.
+
+   ```console
+   cd ~/.terraform.d/plugins/local/vmware/vmc/${RELEASE}/darwin_amd64
+   ls
+   ```
+
+### Windows
+
+The following examples use PowerShell on Windows (x64).
+
+1. On a Windows operating system with Internet access, download the plugin using the PowerShell.
+
+   ```powershell
+   $RELEASE="x.y.z"
+   Invoke-WebRequest -Uri "https://github.com/vmware/terraform-provider-vmc/releases/download/v${RELEASE}/terraform-provider-vmc_${RELEASE}_windows_amd64.zip" -OutFile "terraform-provider-vmc_${RELEASE}_windows_amd64.zip"
+   ```
+
+2. Extract the plugin.
+
+   ```powershell
+   Expand-Archive terraform-provider-vmc_${RELEASE}_windows_amd64.zip
+
+   cd terraform-provider-vmc_${RELEASE}_windows_amd64
+   ```
+
+3. Copy the extracted plugin to a target system and move to the Terraform plugins directory.
+
+   > **Note**
+   >
+   > The directory hierarchy that Terraform uses to precisely determine the source of each provider it finds locally.
+   >
+   > `$PLUGIN_DIRECTORY/$SOURCEHOSTNAME/$SOURCENAMESPACE/$NAME/$VERSION/$OS_$ARCH/`
+
+   ```powershell
+   New-Item $ENV:APPDATA\terraform.d\plugins\local\vmware\vmc\${RELEASE}\ -Name "windows_amd64" -ItemType "directory"
+
+   Move-Item terraform-provider-vmc_v${RELEASE}.exe $ENV:APPDATA\terraform.d\plugins\local\vmware\vmc\${RELEASE}\windows_amd64\terraform-provider-vmc_v${RELEASE}.exe
+   ```
+
+4. Verify the presence of the plugin in the Terraform plugins directory.
+
+   ```powershell
+   cd $ENV:APPDATA\terraform.d\plugins\local\vmware\vmc\${RELEASE}\windows_amd64
+   dir
+   ```
+
+### Configure the Terraform Configuration Files
+
+A working directory can be initialized with providers that are installed locally on a system by using `terraform init`. The Terraform configuration block is used to configure some behaviors of Terraform itself, such as the Terraform version and the required providers source and version.
+
+**Example**: A Terraform configuration block.
+
+```hcl
+terraform {
+  required_providers {
+    vmc = {
+      source  = "local/vmware/vmc"
+      version = ">= x.y.z"
+    }
+  }
+  required_version = ">= 0.13"
+}
+```
+
+### Verify the Terraform Initialization of a Manually Installed Provider
+
+To verify the initialization, navigate to the working directory for your Terraform configuration and run `terraform init`. You should see a message indicating that Terraform has been successfully initialized and the installed version of the Terraform Provider for VMware Cloud on AWS.
+
+**Example**: Initialize and Use a Manually Installed Provider
+
+```console
+$ terraform init
+
+Initializing the backend...
+
+Initializing provider plugins...
+- Finding local/vmware/vmc versions matching ">= x.y.x" ...
+- Installing local/vmware/vmc x.y.x ...
+- Installed local/vmware/vmc x.y.x (unauthenticated)
+...
+
+Terraform has been successfully initialized!
+```
+
+## Get the Provider Version
+
+To find the provider version, navigate to the working directory of your Terraform configuration and run `terraform version`. You should see a message indicating the provider version.
+
+**Example**: Terraform Provider Version from the Terraform Registry
+
+```console
+$ terraform version
+Terraform x.y.z
+on linux_amd64
++ provider registry.terraform.io/vmware/vmc x.y.z
+```
+
+**Example**: Terraform Provider Version for a Manually Installed Provider
+
+```console
+$ terraform version
+Terraform x.y.z
+on linux_amd64
++ provider local/vmware/vmc x.y.z
+```
+
+[releases]: https://github.com/vmware/terraform-provider-vmc/releases
+[terraform-provider-versioning]: https://developer.hashicorp.com/terraform/language/providers/configuration#version-provider-versions
+[terraform-registry]: https://registry.terraform.io
diff --git a/docs/test.md b/docs/test.md
new file mode 100644
index 0000000..5fdd7e3
--- /dev/null
+++ b/docs/test.md
@@ -0,0 +1,63 @@
+<!--
+© Broadcom. All Rights Reserved.
+The term “Broadcom” refers to Broadcom Inc. and/or its subsidiaries.
+SPDX-License-Identifier: MPL-2.0
+-->
+
+<!-- markdownlint-disable first-line-h1 no-inline-html -->
+
+<img src="images/icon-color.png" alt="VMware Cloud on AWS" width="150">
+
+# Testing the Terraform Provider for VMware Cloud on AWS
+
+Testing the Terraform Provider for VMware Cloud on AWS requires having an VMware
+Cloud on AWS organization to test against. Generally, the acceptance tests
+create real resources, and often cost money to run.
+
+## Configuring Environment Variables
+
+Set required environment variables based based on your infrastructure settings.
+
+```sh
+$ # clientId and client secret of the test OAuth2.0 app attached to the test organization with at least
+$ # "Organization Member" role and service role  on "VMware Cloud on AWS" service that is allowed to deploy SDDCs.
+$ # Note: it is recommended to use OAuth2.0 app with the least possible roles (the above mentioned) for testing
+$ # purposes.
+$ export CLIENT_ID=xxx
+$ export CLIENT_SECRET=xxx
+$ # Id of a VMC Org in which test SDDC are (to be) placed
+$ export ORG_ID=xxxx
+$ # Id of an existing SDDC used for SDDC data source (import) test
+$ export TEST_SDDC_ID=xxx
+$ # Name of above SDDC
+$ export TEST_SDDC_NAME=xxx
+$ # NSX URL of a non-ZEROCLOUD SDDC, used for real IP testing
+$ export NSXT_REVERSE_PROXY_URL=xxx
+$ # Account number of a connected to the above Org AWS account, required for test SDDC deployment
+$ export AWS_ACCOUNT_NUMBER=xxx
+```
+
+## Running the Acceptance Tests
+
+Acceptance tests create real resources, and often cost money to run.
+
+You can run the acceptance tests by running:
+
+```sh
+$ make testacc
+```
+
+If you want to run against a specific set of tests, run `make testacc` with the
+`TESTARGS` parameter containing the run mask. For example:
+
+```sh
+$ make testacc TESTARGS="-run=TestAccResourceVmcSddc_basic"
+```
+
+Additionally, A limited set of acceptance tests can be ran with the ZEROCLOUD
+cloud provider, which is much faster and cheaper, while providing decent API
+coverage:. For example:
+
+```sh
+$ make testacc TESTARGS="-run=TestAccResourceVmcSddcZerocloud"
+```