Site and Org associations

.changes/v3.13.0/1260-features.md

@@ -0,0 +1,8 @@
+* **New Data Source:** `vcd_multisite_site` to read the state and associations of current site [GH-1260]
+* **New Data Source:** `vcd_multisite_site_data` to produce the association data needed to start a site association [GH-1260]
+* **New Data Source:** `vcd_multisite_site_association` to read the details of a site association [GH-1260]
+* **New Resource:** `vcd_multisite_site_association` to associate the current site with a remote one [GH-1260]
+* **New Data Source:** `vcd_multisite_org_data` to produce the association data needed to start an organization association [GH-1260]
+* **New Data Source:** `vcd_multisite_org_association` to read the details of an organization association [GH-1260]
+* **New Resource:** `vcd_multisite_org_association` to associate a local organization with a remote one [GH-1260]
+* **New Guide** `Site and Org associations` to describe association operations for sites and organizations [GH-1260]

.changes/v3.13.0/1260-improvements.md

@@ -0,0 +1 @@
+* Data source `vcd_resource_list` can now list site and organization associations [GH-1260]

examples/multi-site/org-all-at-once/config.tf

@@ -0,0 +1,61 @@
+provider "vcd" {
+  user                 = var.vcd_admin
+  password             = var.vcd_password
+  token                = ""
+  api_token            = ""
+  auth_type            = "integrated"
+  saml_adfs_rpt_id     = ""
+  url                  = var.vcd_url
+  sysorg               = var.vcd_sysorg
+  org                  = var.vcd_org1
+  allow_unverified_ssl = "true"
+  max_retry_timeout    = 600
+  logging              = true
+  logging_file         = "go-vcloud-director.log"
+}
+
+data "vcd_org" "org1" {
+  name     = var.vcd_org1
+}
+data "vcd_org" "org2" {
+  name     = var.vcd_org2
+}
+
+data "vcd_multisite_org_data" "org1-data" {
+  org_id           = data.vcd_org.org1.id
+}
+
+data "vcd_multisite_org_data" "org2-data" {
+  org_id           = data.vcd_org.org2.id
+}
+
+data "vcd_resource_list" "orgs" {
+  name          = "org_associations"
+  resource_type = "vcd_multisite_org_association"
+  list_mode     = "name_id"
+}
+
+resource "vcd_multisite_org_association" "org1-org2" {
+  org_id                  = data.vcd_org.org1.id
+  association_data        = data.vcd_multisite_org_data.org2-data.association_data
+  connection_timeout_mins = 2
+}
+
+resource "vcd_multisite_org_association" "org2-org1" {
+  org_id                  = data.vcd_org.org2.id
+  association_data        = data.vcd_multisite_org_data.org1-data.association_data
+  connection_timeout_mins = 2
+}
+
+output "org2-org1" {
+  value = vcd_multisite_org_association.org2-org1
+}
+
+
+output "org1-org2" {
+  value = vcd_multisite_org_association.org1-org2
+}
+
+output "org_associations" {
+  value = data.vcd_resource_list.orgs
+}

examples/multi-site/org-all-at-once/terraform.tfvars.example

@@ -0,0 +1,7 @@
+# Rename this file to 'terraform.tfvars' and update the variables to their intended values
+vcd_url       = "https://example1.com/api"
+vcd_admin     = "administrator"
+vcd_password  = "myPassword"
+vcd_sysorg    = "System"
+vcd_org1       = "nameOfMyOrg"
+vcd_org2       = "nameOfMyOtherOrg"

examples/multi-site/org-all-at-once/variables.tf

@@ -0,0 +1,26 @@
+
+variable "vcd_url" {
+   type = string
+}
+
+variable "vcd_admin" {
+  type = string
+  default = "administrator"
+}
+
+variable "vcd_sysorg" {
+  type = string
+  default = "System"
+}
+
+variable "vcd_password" {
+  type = string
+}
+
+variable "vcd_org1" {
+  type = string
+}
+
+variable "vcd_org2" {
+  type = string
+}

examples/multi-site/org-all-at-once/versions.tf

@@ -0,0 +1,9 @@
+terraform {
+  required_providers {
+    vcd = {
+      source  = "vmware/vcd"
+      version = ">=3.13.0"
+    }
+  }
+}
+

examples/multi-site/site-all-at-once/config1.tf

@@ -0,0 +1,45 @@
+provider "vcd" {
+  alias                = "vcd1"
+  user                 = var.vcd_admin1
+  password             = var.vcd_password1
+  token                = ""
+  api_token            = ""
+  auth_type            = "integrated"
+  saml_adfs_rpt_id     = ""
+  url                  = var.vcd_url1
+  sysorg               = var.vcd_sysorg1
+  org                  = var.vcd_org1
+  allow_unverified_ssl = "true"
+  max_retry_timeout    = 600
+  logging              = true
+  logging_file         = "go-vcloud-director-1.log"
+}
+
+data "vcd_org" "org1" {
+  provider = vcd.vcd1
+  name     = var.vcd_org1
+}
+
+data "vcd_multisite_org_data" "org1-data" {
+  provider         = vcd.vcd1
+  org_id           = data.vcd_org.org1.id
+  download_to_file = "${var.vcd_org1}.xml"
+}
+
+data "vcd_multisite_site_data" "site1-data" {
+  provider         = vcd.vcd1
+  download_to_file = "${var.site_name1}-site.xml"
+}
+
+# The data files are needed because the data will be read by resources handled by a different user, which can't read
+# directly the data source that is the origin of these files
+
+data "local_file" "site1" {
+  filename   = "${var.site_name1}-site.xml"
+  depends_on = [data.vcd_multisite_site_data.site1-data]
+}
+
+data "local_file" "org1" {
+  filename   = "${var.vcd_org1}.xml"
+  depends_on = [data.vcd_multisite_org_data.org1-data]
+}

examples/multi-site/site-all-at-once/config1a.tf

@@ -0,0 +1,43 @@
+
+data "vcd_resource_list" "sites" {
+  provider      = vcd.vcd1
+  name          = "site_associations"
+  resource_type = "vcd_multisite_site_association"
+  list_mode     = "name_id"
+}
+
+data "vcd_resource_list" "orgs" {
+  provider      = vcd.vcd1
+  name          = "org_associations"
+  resource_type = "vcd_multisite_org_association"
+  list_mode     = "name_id"
+}
+
+resource "vcd_multisite_site_association" "site1-site2" {
+  provider                = vcd.vcd1
+  association_data        = data.local_file.site2.content
+  connection_timeout_mins = 2
+}
+
+resource "vcd_multisite_org_association" "org1-org2" {
+  provider                = vcd.vcd1
+  org_id                  = data.vcd_org.org1.id
+  association_data        = data.local_file.org2.content
+  connection_timeout_mins = 2
+  depends_on              = [vcd_multisite_site_association.site1-site2]
+}
+
+output "site1-site2" {
+  value = vcd_multisite_site_association.site1-site2
+}
+
+output "org1-org2" {
+  value = vcd_multisite_org_association.org1-org2
+}
+
+output "site_associations" {
+  value = data.vcd_resource_list.sites
+}
+output "org_associations" {
+  value = data.vcd_resource_list.orgs
+}

examples/multi-site/site-all-at-once/config2.tf

@@ -0,0 +1,45 @@
+provider "vcd" {
+  alias                = "vcd2"
+  user                 = var.vcd_admin2
+  password             = var.vcd_password2
+  token                = ""
+  api_token            = ""
+  auth_type            = "integrated"
+  saml_adfs_rpt_id     = ""
+  url                  = var.vcd_url2
+  sysorg               = var.vcd_sysorg2
+  org                  = var.vcd_org2
+  allow_unverified_ssl = "true"
+  max_retry_timeout    = 600
+  logging              = true
+  logging_file         = "go-vcloud-director-2.log"
+}
+
+data "vcd_org" "org2" {
+  provider = vcd.vcd2
+  name     = var.vcd_org2
+}
+
+data "vcd_multisite_org_data" "org2-data" {
+  provider         = vcd.vcd2
+  org_id           = data.vcd_org.org2.id
+  download_to_file = "${var.vcd_org2}.xml"
+}
+
+data "vcd_multisite_site_data" "site2-data" {
+  provider         = vcd.vcd2
+  download_to_file = "${var.site_name2}-site.xml"
+}
+
+# The data files are needed because the data will be read by resources handled by a different user, which can't read
+# directly the data source that is the origin of these files
+
+data "local_file" "site2" {
+  filename   = "${var.site_name2}-site.xml"
+  depends_on = [data.vcd_multisite_site_data.site2-data]
+}
+
+data "local_file" "org2" {
+  filename   = "${var.vcd_org2}.xml"
+  depends_on = [data.vcd_multisite_org_data.org2-data]
+}

examples/multi-site/site-all-at-once/config2a.tf

@@ -0,0 +1,22 @@
+
+resource "vcd_multisite_site_association" "site2-site1" {
+  provider                = vcd.vcd2
+  association_data        = data.local_file.site1.content
+  connection_timeout_mins = 2
+}
+
+resource "vcd_multisite_org_association" "org2-org1" {
+  provider                = vcd.vcd2
+  org_id                  = data.vcd_org.org2.id
+  association_data        = data.local_file.org1.content
+  connection_timeout_mins = 2
+  depends_on              = [vcd_multisite_site_association.site2-site1]
+}
+
+output "site2-site1" {
+  value = vcd_multisite_site_association.site2-site1
+}
+
+output "org2-org1" {
+  value = vcd_multisite_org_association.org2-org1
+}

examples/multi-site/site-all-at-once/terraform.tfvars.example

@@ -0,0 +1,14 @@
+# Rename this file to 'terraform.tfvars' and update the variables to their intended values
+vcd_site_name1 = "SITE1"
+vcd_url1       = "https://example1.com/api"
+vcd_admin1     = "administrator"
+vcd_password1  = "myPassword"
+vcd_sysorg1    = "System"
+vcd_org1       = "nameOfMyOrg"
+
+vcd_site_name2 = "SITE2"
+vcd_url2       = "https://example2.com/api"
+vcd_admin2     = "administrator"
+vcd_password2  = "anotherPassword"
+vcd_sysorg2    = "System"
+vcd_org2       = "nameOfMyOtherOrg"

examples/multi-site/site-all-at-once/variables.tf

@@ -0,0 +1,62 @@
+
+# -----------------------
+# site 1
+# -----------------------
+
+variable "site_name1" {
+  type = string
+  default = "site1"
+}
+
+variable "vcd_url1" {
+   type = string
+}
+
+variable "vcd_admin1" {
+  type = string
+  default = "administrator"
+}
+
+variable "vcd_sysorg1" {
+  type = string
+  default = "System"
+}
+
+variable "vcd_password1" {
+  type = string
+}
+
+variable "vcd_org1" {
+  type = string
+}
+
+# -----------------------
+# site 2
+# -----------------------
+
+variable "site_name2" {
+  type = string
+  default = "site2"
+}
+
+variable "vcd_url2" {
+  type = string
+}
+
+variable "vcd_admin2" {
+  type = string
+  default = "administrator"
+}
+
+variable "vcd_sysorg2" {
+  type = string
+  default = "System"
+}
+
+variable "vcd_password2" {
+  type = string
+}
+
+variable "vcd_org2" {
+  type = string
+}

examples/multi-site/site-all-at-once/versions.tf

@@ -0,0 +1,9 @@
+terraform {
+  required_providers {
+    vcd = {
+      source  = "vmware/vcd"
+      version = ">=3.13.0"
+    }
+  }
+}
+

go.mod

@@ -70,3 +70,7 @@ require (
 	google.golang.org/grpc v1.63.2 // indirect
 	google.golang.org/protobuf v1.34.0 // indirect
 )
+
+replace github.com/vmware/go-vcloud-director/v2 => github.com/dataclouder/go-vcloud-director/v2 v2.17.0-alpha.3.0.20240617070637-7f67778da98f
+
+// replace github.com/vmware/go-vcloud-director/v2 => ../go-vcloud-director

go.sum

@@ -18,6 +18,8 @@ github.com/cloudflare/circl v1.3.7/go.mod h1:sRTcRWXGLrKw6yIGJ+l7amYJFfAXbZG0kBS
 github.com/creack/pty v1.1.9/go.mod h1:oKZEueFk5CKHvIhNR5MUki03XCEU+Q6VDXinZuGJ33E=
 github.com/cyphar/filepath-securejoin v0.2.4 h1:Ugdm7cg7i6ZK6x3xDF1oEu1nfkyfH53EtKeQYTC3kyg=
 github.com/cyphar/filepath-securejoin v0.2.4/go.mod h1:aPGpWjXOXUn2NCNjFvBE6aRxGGx79pTxQpKOJNYHHl4=
+github.com/dataclouder/go-vcloud-director/v2 v2.17.0-alpha.3.0.20240617070637-7f67778da98f h1:qqS7RHF5dHrARPfn1ayw8zgC+dRVqn2uUu3CFiKKsKM=
+github.com/dataclouder/go-vcloud-director/v2 v2.17.0-alpha.3.0.20240617070637-7f67778da98f/go.mod h1:vbuNYzuADDBFhi9i2dIKWeNxMK1VFF0dACq01amYBIM=
 github.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
 github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
 github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
@@ -148,8 +150,6 @@ github.com/vmihailenco/msgpack/v5 v5.4.1 h1:cQriyiUvjTwOHg8QZaPihLWeRAAVoCpE00IU
 github.com/vmihailenco/msgpack/v5 v5.4.1/go.mod h1:GaZTsDaehaPpQVyxrf5mtQlH+pc21PIudVV/E3rRQok=
 github.com/vmihailenco/tagparser/v2 v2.0.0 h1:y09buUbR+b5aycVFQs/g70pqKVZNBmxwAhO7/IwNM9g=
 github.com/vmihailenco/tagparser/v2 v2.0.0/go.mod h1:Wri+At7QHww0WTrCBeu4J6bNtoV6mEfg5OIWRZA9qds=
-github.com/vmware/go-vcloud-director/v2 v2.25.0-alpha.8 h1:I0ZSGT0kFe4HF1s9JTS6Z2GyeuipVOpwuSczwj72sEk=
-github.com/vmware/go-vcloud-director/v2 v2.25.0-alpha.8/go.mod h1:vbuNYzuADDBFhi9i2dIKWeNxMK1VFF0dACq01amYBIM=
 github.com/xanzy/ssh-agent v0.3.3 h1:+/15pJfg/RsTxqYcX6fHqOXZwwMP+2VyYWJeWM2qQFM=
 github.com/xanzy/ssh-agent v0.3.3/go.mod h1:6dzNDKs0J9rVPHPhaGCukekBHKqfl+L3KghI1Bc68Uw=
 github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=