Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/equinix-labs/terraform-equinix-fabric-connection-ibm
Terraform module to create a Fabric L2 Connection to IBM Cloud Direct Link
https://github.com/equinix-labs/terraform-equinix-fabric-connection-ibm
direct-link equinix equinix-fabric ibm-cloud terraform terraform-module
Last synced: 7 days ago
JSON representation
Terraform module to create a Fabric L2 Connection to IBM Cloud Direct Link
- Host: GitHub
- URL: https://github.com/equinix-labs/terraform-equinix-fabric-connection-ibm
- Owner: equinix-labs
- License: apache-2.0
- Created: 2022-02-28T23:23:58.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-12-15T05:32:17.000Z (11 months ago)
- Last Synced: 2024-04-23T13:57:06.490Z (7 months ago)
- Topics: direct-link, equinix, equinix-fabric, ibm-cloud, terraform, terraform-module
- Language: HCL
- Homepage:
- Size: 14.9 MB
- Stars: 1
- Watchers: 6
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
## Equinix Fabric L2 Connection To IBM Direct Link 2.0 Terraform module
[](https://github.com/equinix-labs/standards#about-uniform-standards)
[](https://github.com/equinix-labs/terraform-equinix-template/actions/workflows/integration.yaml)
`terraform-equinix-fabric-connection-ibm` is a Terraform module that utilizes [Terraform provider for Equinix](https://registry.terraform.io/providers/equinix/equinix/latest) and [Terraform provider for IBM](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs) to set up an Equinix Fabric L2 connection to IBM Direct Link 2.0.
As part of Platform Equinix, your infrastructure can connect with other parties, such as public cloud providers, network service providers, or your own colocation cages in Equinix by defining an [Equinix Fabric - software-defined interconnection](https://docs.equinix.com/en-us/Content/Interconnection/Fabric/Fabric-landing-main.htm).
This module creates the l2 connection in Equinix Fabric, approves the request in your account on the IBM Cloud platform, and optionally creates a IBM Direct Link virtual connection. BGP in Equinix side can also be configured if Network Edge device is used.
```html
Origin Destination
(A-side) (Z-side)
┌────────────────┐
│ Equinix Fabric │ Equinix Fabric ┌────────────────────┐ ┌───────────────────────┐
│ Port / Network ├───── l2 connection ───────►│ IBM │──────►│ DL Gateway ─► │
│ Edge Device / │ (50 Mbps - 10 Gbps) │ Direc Link 2.0 │ │ DL Virtual Connection │
│ Service Token │ └────────────────────┘ │ (IBM Cloud Region) │
└────────────────┘ └───────────────────────┘
│ │
└ - - - - - - - - - - Network Edge Device - - - - - - - - - - - - - - - - - ┘
BGP peering
```
### Usage
This project is experimental and supported by the user community. Equinix does not provide support for this project.
Install Terraform using the official guides at .
This project may be forked, cloned, or downloaded and modified as needed as the base in your integrations and deployments.
This project may also be used as a [Terraform module](https://learn.hashicorp.com/collections/terraform/modules).
To use this module in a new project, create a file such as:
```hcl
# main.tf
provider "equinix" {
}
provider "ibm" {
region = "eu-de"
}
module "equinix-fabric-connection-ibm" {
source = "equinix-labs/fabric-connection-ibm/equinix"
# required variables
fabric_notification_users = ["[email protected]"]
ibm_account_id = var.ibm_account_id
# optional variables
fabric_port_name = var.port_name
fabric_vlan_stag = 1010
fabric_destination_metro_code = "FR"
}
```
Run `terraform init -upgrade` and `terraform apply`.
### Variables
See for a description of all variables.
### Outputs
See for a description of all outputs.
### Resources
| Name | Type |
|------|------|
| [random_string.this](https://registry.terraform.io/providers/hashicorp/random/latest/docs/resources/string) | resource |
| [equinix-fabric-connection](https://registry.terraform.io/modules/equinix-labs/fabric-connection/equinix/latest) | module |
| [equinix_network_bgp.this](https://registry.terraform.io/providers/equinix/equinix/latest/docs/resources/equinix_network_bgp) | resource |
| [ibm_resource_group.this](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/resource_group) | data source |
| [ibm_resource_group.this](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/resource_group) | resource |
| [ibm_dl_gateways.this](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/data-sources/dl_gateways) | data source |
| [ibm_dl_virtual_connection.this](https://registry.terraform.io/providers/IBM-Cloud/ibm/latest/docs/resources/dl_virtual_connection) | data source |
| [null_resource.confirm_direct_link_gateway_creation](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) | resource |
| [null_resource.confirm_direct_link_gateway_deletion](https://registry.terraform.io/providers/hashicorp/null/latest/docs/resources/resource) | resource |
| [external.os](https://registry.terraform.io/providers/hashicorp/external/latest/docs/data-sources/data_source) | data source |
### Examples
- [Fabric Port connection](https://registry.terraform.io/modules/equinix-labs/fabric-connection-ibm/equinix/latest/examples/fabric-port-connection/)
- [Network Edge device connection](https://registry.terraform.io/modules/equinix-labs/fabric-connection-ibm/equinix/latest/examples/network-edge-device-connection/)
- [Service Token (a-side) Equinix Metal to IBM redundant connection End-to-End Solution](https://registry.terraform.io/modules/equinix-labs/fabric-connection-ibm/equinix/latest/examples/service-token-metal-to-ibm-connection/)