Skip to content

Terraform module to create a Fabric L2 Connection to Oracle Cloud Infrastructure FastConnect

License

Notifications You must be signed in to change notification settings

equinix-labs/terraform-equinix-fabric-connection-oci

Repository files navigation

Equinix Fabric L2 Connection To Oracle Cloud Infrastructure FastConnect Terraform module

Experimental terraform

terraform-equinix-fabric-connection-oci is a Terraform module that utilizes Terraform provider for Equinix and Terraform provider for OCI to set up an Equinix Fabric L2 connection to OCI Fast Connect.

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.

This module creates a Dynamic Routing Gateway (DRG) or uses an existing one, a private Virtual Circuit in OCI, and the l2 connection in Equinix Fabric using the Virtual Circuit OCID as authentication key. BGP in Equinix side can be optionally configured if Network Edge device is used. Optionally you can attach multiple VCNs to the DRG.

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

┌────────────────┐
│ Equinix Fabric │         Equinix Fabric          ┌────────────────────┐       ┌──────────────────────────┐
│ Port / Network ├─────    l2 connection   ───────►│        OCI         │──────►│     Private VC ─► DRG    │
│ Edge Device /  │         (1 - 10 Gbps)           │    FastConnect     │       │    ─► DRG/VCNs attach    │
│ Service Token  │                                 └────────────────────┘       │       (OCI 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 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:

# main.tf
provider "equinix" {}

provider "oci" {}

variable "tenancy_ocid" {}
variable "device_id" {}

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

  # required variables
  fabric_notification_users = ["[email protected]"]
  oci_tenancy_id            = var.tenancy_ocid

  # optional variables
  network_edge_device_id     = var.device_id
  network_edge_configure_bgp = true

  fabric_destination_metro_code = "FR" //Frankfurt
  fabric_speed                  = 2 //Speed in Gbps
}

Run terraform init -upgrade and terraform apply.

Resources

Name Type
random_string.this resource
equinix-fabric-connection module
equinix_network_bgp.this resource
oci_identity_compartment.this data source
oci_identity_compartment.this resource
oci_core_virtual_circuit.this resource
oci_core_drg.this resource
oci_core_drg_attachment.this resource
oci_core_drgs.this data source
oci_core_fast_connect_provider_services.this data source
oci_core_drg_route_tables.this data source

Variables

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

Outputs

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

Examples