Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/equinix-labs/terraform-equinix-fabric-connection-aws
Terraform module to create a Fabric L2 Connection to AWS Direct Connect
https://github.com/equinix-labs/terraform-equinix-fabric-connection-aws
aws direct-connect equinix equinix-fabric terraform terraform-module
Last synced: 7 days ago
JSON representation
Terraform module to create a Fabric L2 Connection to AWS Direct Connect
- Host: GitHub
- URL: https://github.com/equinix-labs/terraform-equinix-fabric-connection-aws
- Owner: equinix-labs
- License: apache-2.0
- Created: 2022-02-28T22:50:33.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-09T21:47:47.000Z (7 months ago)
- Last Synced: 2024-04-23T13:57:06.373Z (7 months ago)
- Topics: aws, direct-connect, equinix, equinix-fabric, terraform, terraform-module
- Language: HCL
- Homepage:
- Size: 42 KB
- Stars: 5
- Watchers: 6
- Forks: 3
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
- Codeowners: CODEOWNERS
Awesome Lists containing this project
README
## Equinix Fabric L2 Connection To AWS Direct Connect 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-aws` is a Terraform module that utilizes [Terraform provider for Equinix](https://registry.terraform.io/providers/equinix/equinix/latest) and [Terraform provider for AWS](https://registry.terraform.io/providers/hashicorp/aws/latest/docs) to set up an Equinix Fabric L2 connection to AWS Direct 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](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 AWS platform, and optionally creates a AWS Direct Connect private virtual interface (VIF) and a virtual private gateway (VGW). BGP in Equinix side can be optionally configured if Network Edge device is used.
```html
Origin Destination
(A-side) (Z-side)
┌────────────────┐
│ Equinix Fabric │ Equinix Fabric ┌────────────────────┐ ┌──────────────────────┐
│ Port / Network ├───── l2 connection ───────►│ AWS │──────►│ Private VIF ─► VGW │
│ Edge Device / │ (50 Mbps - 10 Gbps) │ Direct Connect │ │ (AWS Region) │
│ Service Token │ └────────────────────┘ └──────────────────────┘
└────────────────┘ │
│ │
└ - - - - - - - - - - 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 "aws" { region = "eu-central-1" }
data "aws_region" "this" {}
module "equinix-fabric-connection-aws" {
source = "equinix-labs/fabric-connection-aws/equinix"
# required variables
fabric_notification_users = ["[email protected]"]
aws_account_id = var.aws_account_id
# optional variables
fabric_destination_metro_code = "FR"
network_edge_device_id = "DeviceID"
}
```
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 |
| [aws_dx_connection_confirmation.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/dx_connection_confirmation) | resource |
| [aws_dx_private_virtual_interface.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/dx_private_virtual_interface) | resource |
| [aws_vpn_gateway.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/resources/vpn_gateway) | resource |
| [aws_vpc.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/vpc) | data source |
| [aws_region.this](https://registry.terraform.io/providers/hashicorp/aws/latest/docs/data-sources/region) | data source |
### Examples
- [Fabric Port connection](https://registry.terraform.io/modules/equinix-labs/fabric-connection-aws/equinix/latest/examples/fabric-port-connection/)
- [Network Edge device connection](https://registry.terraform.io/modules/equinix-labs/fabric-connection-aws/equinix/latest/examples/network-edge-device-connection/)
- [Service Token (a-side) Equinix Metal to AWS redundant connection End-to-End Solution](https://registry.terraform.io/modules/equinix-labs/fabric-connection-aws/equinix/latest/examples/service-token-metal-to-aws-connection/)