Added pair site documentation and refactor README

Author: psvetlinov

README.md

@@ -12,7 +12,10 @@ appliance roles:
 The initial configuration includes changing the initial password of the **root** user of the appliance, adding external
 Replicator Service instances and configuring the Tunnel Service.
 
-* For information about the Terraform provider, see the [provider documentation](https://registry.terraform.io/providers/hashicorp/vcda/latest/docs).
+Since VCDA Terraform Provider v2.0.0, the provider supports one-step pairing of either a Cloud Director Replication Management Appliance to an already configured
+Cloud Director Replication Management Appliance, or vCenter Replication Management Appliance to an already configured vCenter Replication Management Appliance.
+
+* For information about the Terraform provider, see the [provider documentation](https://registry.terraform.io/providers/vmware/vcda/latest/docs).
 * For information about VMware Cloud Director Availability,
   see the [ Product Page](https://www.vmware.com/products/cloud-director-availability.html).
 * For more information,
@@ -78,7 +81,7 @@ instructions above, follow the instructions
 to [install it as a plugin](https://www.terraform.io/docs/plugins/basics.html#installing-plugins). After placing the
 custom-built provider into your plugins directory, to initialize it run `terraform init`.
 
-For information about either installation method and for documentation about the provider-specific configuration options, see the [VMware Cloud Director Availability provider's website](https://www.terraform.io/docs/providers/vmware-cloud-director-availability/index.html).
+For information about either installation method and for documentation about the provider-specific configuration options, see the [VMware Cloud Director Availability provider's website](https://registry.terraform.io/providers/vmware/vcda/latest/docs).
 
 # Automated Installation (Recommended)
 
@@ -142,9 +145,9 @@ work is being duplicated, before you start working on a feature, check the
 [Issue Tracker][gh-issues] and the existing [Pull Requests][gh-prs]. For further clarification, you can also ask in a
 new issue.
 
-[gh-issues]: https://github.com/vmware/terraform-provider-for-vmware-cloud-director-availability/issues
+[gh-issues]: https://github.com/vmware/terraform-provider-vcda/issues
 
-[gh-prs]: https://github.com/vmware/terraform-provider-for-vmware-cloud-director-availability/pulls
+[gh-prs]: https://github.com/vmware/terraform-provider-vcda/pulls
 
 For more information, see the [Building the Provider](#building-the-provider) section and for instructions
 about manually loading the provider for development, see the [Manual Installation](#manual-installation) section.
@@ -189,6 +192,12 @@ Manager tests
 make testacc TESTS=/manager
 ```
 
+Pairing tests
+
+```sh
+make testacc TESTS=/pair
+```
+
 Data sources tests
 
 ```sh

docs/index.md

@@ -17,6 +17,9 @@ appliance roles:
 The initial configuration includes changing the initial password of the **root** user of the appliance, adding external
 Replicator Service instances and configuring the Tunnel Service.
 
+Since VCDA Terraform Provider v2.0.0, the provider supports one-step pairing of either a Cloud Director Replication Management Appliance to an already configured
+Cloud Director Replication Management Appliance, or vCenter Replication Management Appliance to an already configured vCenter Replication Management Appliance.
+
 Note: The provider must be configured with the correct credentials and inputs before it can be used.
 
 * For more information,
@@ -26,11 +29,14 @@ Note: The provider must be configured with the correct credentials and inputs be
 
 ## Supported Versions
 
-This provider supports the following versions of VMware Cloud Director Availability:
+The VCDA Terraform provider v1.0.0 supports the following versions of VMware Cloud Director Availability:
 
 * [Version 4.5](https://docs.vmware.com/en/VMware-Cloud-Director-Availability/4.5/rn/vmware-cloud-director-availability-45-release-notes/index.html)
 * [Version 4.5.0.1](https://docs.vmware.com/en/VMware-Cloud-Director-Availability/4.5.0.1/rn/vmware-cloud-director-availability-4501-release-notes/index.html)
 
+The VCDA Terraform provider v2.0.0 supports the following versions of VMware Cloud Director Availability:
+* [Version 4.6](https://docs.vmware.com/en/VMware-Cloud-Director-Availability/4.6/rn/vmware-cloud-director-availability-46-release-notes/index.html)
+
 ## Example Usage
 
 ```terraform

docs/resources/vcda_pair_site.md

@@ -0,0 +1,80 @@
+---
+# generated by https://github.com/hashicorp/terraform-plugin-docs
+page_title: "vcda_pair_site Resource - terraform-provider-for-vmware-cloud-director-availability"
+subcategory: ""
+description: |-
+  VMware Cloud Director Availability Pair Site resource.
+---
+
+# vcda_pair_site (Resource)
+
+The Pair Site resource performs one-step pairing of either:
+
+- a Cloud Director Replication Management Appliance to an already configured
+  Cloud Director Replication Management Appliance, or
+
+- a vCenter Replication Management Appliance to an already configured vCenter Replication Management Appliance.
+
+## Example Usage
+
+### Pair Cloud Director Replication Management Appliance to an already configured Cloud Director Replication Management Appliance
+
+```terraform
+resource "vcda_pair_site" "pair_cloud_site" {
+  api_url             = var.cloud_site_endpoint
+  pairing_description = "pair cloud site"
+  site                = var.cloud_site_name
+  
+  service_cert        = data.vcda_service_cert.cloud_service_cert.id
+  api_thumbprint      = data.vcda_remote_services_thumbprint.cloud_site_thumbprint.id
+}
+```
+
+### Pair vCenter Replication Management Appliance to an already configured vCenter Replication Management Appliance
+
+```terraform
+resource "vcda_pair_site" "pair_manager_site" {
+  api_url             = var.manager_site_endpoint
+  pairing_description = "pair manager site"
+  
+  service_cert        = data.vcda_service_cert.manager_service_cert.id
+  api_thumbprint      = data.vcda_remote_services_thumbprint.manager_site_thumbprint.id
+}
+```
+
+<!-- schema generated by tfplugindocs -->
+
+## Schema
+
+### Required
+
+- `api_thumbprint` (String) The thumbprint of the to-be paired Cloud Director/vCenter Replication Management Appliance.
+  It can either be computed from
+  the `vcda_remote_services_thumbprint` data source or provided directly as a SHA-256 fingerprint.
+- `api_url` (String) The API URL address/endpoint of the to-be paired Cloud Director/vCenter Replication Management
+  Appliance.
+- `service_cert` (String) The certificate of the Cloud Director/vCenter Replication Management Appliance.
+
+### Optional
+
+- `pairing_description` (String) The description of the pairing.
+- `site` (String) The site name of the to-be paired Cloud Director Replication Management Appliance.
+  Only required for pairing a Cloud Director Replication Management Appliance to another Cloud Director Replication
+  Management Appliance.
+
+### Read-Only
+
+- `site_id` (String) The site ID of the paired vCenter Replication Management Appliance. Computed only for pairing a
+  vCenter Replication Management Appliance to another vCenter Replication Management Appliance.
+- `site_name` (String) The site name of the paired Cloud Director/vCenter Replication Management Appliance.
+- `site_description` (String) The site description of the paired Cloud Director/vCenter Replication Management
+  Appliance.
+- `api_public_url` (Boolean) The public API URL address of the paired Cloud Director/vCenter Replication Management
+  Appliance.
+- `api_version` (String) The API version of the paired Cloud Director/vCenter Replication Management Appliance.
+- `build_version` (String) The build version of the paired Cloud Director Replication Management Appliance. Computed
+  only for pairing a Cloud Director Replication Management Appliance to another Cloud Director Replication Management
+  Appliance.
+- `is_provider_deployment` (String) A flag that indicates whether the paired vCenter Replication Management Appliance is
+  of type provider. Computed only for pairing a vCenter Replication Management Appliance to another vCenter Replication
+  Management Appliance.

scripts/env_variables.sh

@@ -16,6 +16,7 @@ export DC_ID=''
 # Appliances VM names
 export CLOUD_VM_NAME=''
 export MANAGER_VM_NAME=''
+export REMOTE_MANAGER_VM_NAME=''
 export REPLICATOR_VM_NAME=''
 export TUNNEL_VM_NAME=''
 
@@ -37,5 +38,6 @@ export SSO_PASSWORD=''
 
 # Services endpoints
 export MANAGER_ADDRESS=''
+export REMOTE_MANAGER_ADDRESS=''
 export REPLICATOR_ADDRESS=''
 export TUNNEL_ADDRESS=''