Skip to content

Terraform module to set up a single or redundant Metal shared connection from an Equinix Fabric port / Network Edge device

License

Notifications You must be signed in to change notification settings

equinix-labs/terraform-equinix-fabric-connection-metal

Repository files navigation

Equinix Fabric L2 Connection To Equinix Metal Connection Terraform module

Experimental terraform

terraform-equinix-fabric-connection-metal is a minimal Terraform module that utilizes Terraform providers for Equinix to set up an Equinix Metal shared connection.

A part of Platform Equinix, your Equinix Metal™ 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 interconnections

Setting Up a Fabric Billed Fabric Virtual Connections requires requesting the connection on the Equinix Metal side, retrieving a token and using that token to request a connection on the Equinix Fabric side. This module is intended to abstract you from this process and handle the connection as a single resource.

  Origin                                            Destination
  (A-side)                                           (Z-side)

┌────────────────┐                               ┌───────────────┐
│ Equinix Fabric │       Equinix Metal           │ Equinix Metal │
│ Port / Network ├─────  Fabric Billed   ───────►│     Port      │
│ Edge Device /  │     Virtual Connection        └───────────────┘
│ Service Token  │     (50 Mbps - 10 Gbps)
└────────────────┘

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 https://learn.hashicorp.com/tutorials/terraform/install-cli.

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.

To use this module in a new project, create a file such as:

provider "equinix" {}

variable "metal_project_name" {}
variable "edge_device_id" {}

module "equinix-fabric-connection-metal" {
  source = "equinix-labs/fabric-connection-metal/equinix"

  # required variables
  fabric_notification_users     = ["example@equinix.com"]
  fabric_destination_metro_code = "SV"

  metal_project_name = var.metal_project_name

  # optional variables
  network_edge_device_id = var.edge_device_id
}

Run terraform init -upgrade and terraform apply.

Resources

Name Type
equinix_metal_project.this data source
equinix_metal_connection.this resource
equinix-fabric-connection module

Variables

See https://registry.terraform.io/modules/equinix-labs/fabric-connection-metal/equinix/latest?tab=inputs for a description of all variables.

Outputs

See https://registry.terraform.io/modules/equinix-labs/fabric-connection-metal/equinix/latest?tab=outputs for a description of all outputs.

Examples

About

Terraform module to set up a single or redundant Metal shared connection from an Equinix Fabric port / Network Edge device

Topics

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages