Skip to content

Commit

Permalink
feat: Add Terraform Provider Docs for Alibaba Integration (#821)
Browse files Browse the repository at this point in the history
d-bhola authored Nov 23, 2024

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
1 parent 242d3bf commit f59e5d5
Showing 3 changed files with 111 additions and 0 deletions.
56 changes: 56 additions & 0 deletions docs/resources/fabric_connection.md
Original file line number Diff line number Diff line change
@@ -731,6 +731,62 @@ resource "equinix_fabric_connection" "fcr2metal" {
}
```

Port to Alibaba Connection EVPL_VC Connection:

### Step by Step Instructions for the Fabric Port to Fabric Alibaba Profile Connection Example Given Below

#### 1. Create and Accept the Connection
* Create the connection using the Equinix Terraform provider
* Then manually accept the connection request in the Alibaba Portal for the created physical connection

#### 2. Delete Resources
* Run `terraform destroy` to delete the Alibaba VBR
* Directly deleting the Equinix Fabric connection, will result in the following error: `ERR-UAA-003-00: Deletion for a provisioned connection needs to be initiated from Alibaba Portal`
* Go to the Alibaba Portal to manually **terminate** and then **delete** the physical connection
* This action will automatically delete the connection on the Equinix side, updating its status to Deprovisioned on both Equinix and Provider side

```terraform
resource "equinix_fabric_connection" "port2alibaba" {
name = "ConnectionName"
type = "EVPL_VC"
notifications {
type = "ALL"
emails = ["example@equinix.com", "test1@equinix.com"]
}
bandwidth = 50
redundancy { priority = "PRIMARY" }
order {
purchase_order_number = "1-323929"
}
a_side {
access_point {
type = "COLO"
port {
uuid = "<aside_port_uuid>"
}
link_protocol {
type = "DOT1Q"
vlan_tag = "2019"
}
}
}
z_side {
access_point {
type = "SP"
authentication_key = "<alibaba_account_id>"
seller_region = "us-west-1"
profile {
type = "L2_PROFILE"
uuid = "<service_profile_uuid>"
}
location {
metro_code = "SV"
}
}
}
}
```

### Notes:

Port to IBM Connections could be modified from IBM Service Provider Side by using parameters passed to additional_info field:
39 changes: 39 additions & 0 deletions examples/resources/equinix_fabric_connection/port_to_alibaba.tf
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
resource "equinix_fabric_connection" "port2alibaba" {
name = "ConnectionName"
type = "EVPL_VC"
notifications {
type = "ALL"
emails = ["example@equinix.com", "test1@equinix.com"]
}
bandwidth = 50
redundancy { priority = "PRIMARY" }
order {
purchase_order_number = "1-323929"
}
a_side {
access_point {
type = "COLO"
port {
uuid = "<aside_port_uuid>"
}
link_protocol {
type = "DOT1Q"
vlan_tag = "2019"
}
}
}
z_side {
access_point {
type = "SP"
authentication_key = "<alibaba_account_id>"
seller_region = "us-west-1"
profile {
type = "L2_PROFILE"
uuid = "<service_profile_uuid>"
}
location {
metro_code = "SV"
}
}
}
}
16 changes: 16 additions & 0 deletions templates/resources/fabric_connection.md.tmpl
Original file line number Diff line number Diff line change
@@ -94,6 +94,22 @@ EVPLAN Port to Network Connection:

{{tffile "examples/resources/equinix_fabric_connection/fcr_to_metal.tf"}}

Port to Alibaba Connection EVPL_VC Connection:

### Step by Step Instructions for the Fabric Port to Fabric Alibaba Profile Connection Example Given Below

#### 1. Create and Accept the Connection
* Create the connection using the Equinix Terraform provider
* Then manually accept the connection request in the Alibaba Portal for the created physical connection

#### 2. Delete Resources
* Run `terraform destroy` to delete the Alibaba VBR
* Directly deleting the Equinix Fabric connection, will result in the following error: `ERR-UAA-003-00: Deletion for a provisioned connection needs to be initiated from Alibaba Portal`
* Go to the Alibaba Portal to manually **terminate** and then **delete** the physical connection
* This action will automatically delete the connection on the Equinix side, updating its status to Deprovisioned on both Equinix and Provider side

{{tffile "examples/resources/equinix_fabric_connection/port_to_alibaba.tf"}}

### Notes:

Port to IBM Connections could be modified from IBM Service Provider Side by using parameters passed to additional_info field:

0 comments on commit f59e5d5

Please sign in to comment.