# Conectando-se à nuvem com o Equinix Fabric via Terraform -> **NOTA:** Consulte a documentação[do Equinix Fabric](https://docs.equinix.com/fabric/) para obter mais detalhes. O Equinix Fabric(TM) é um serviço de interconexão definida por software que permite que qualquer empresa conete sua própria infraestrutura distribuída à infraestrutura ou provedor de serviços de qualquer outra empresa na Platform Equinix através de uma rede globalmente conetada. Este guia se concentra principalmente no estabelecimento de uma interconexão com um provedor de serviços de cloud e em como aproveitar os [módulos terraform de conexão Equinix Fabric](https://registry.terraform.io/modules/equinix/fabric/equinix/latest) , para obter mais detalhes e outras opções, consulte a seção[Referências](#references) abaixo. ## Primeiros passos - Habilitando uma interconexão[​](#primeiros-passos---habilitando-uma-interconexão "Link direto para Primeiros passos - Habilitando uma interconexão") Se você estiver configurando uma arquitetura multicloud ou cloud híbrida, o principal recurso que você precisará definir é um [Equinix\_Fabric\_connection](https://docs.equinix.com/pt-BR/terraform/resources/fabric_connection.md), que permitirá que a Equinix habilite uma interconexão em seu nome com o provedor de cloud especificado. No entanto, há outros recursos necessários que devem ser configurados na Equinix e no seu provedor de cloud para que a interconexão esteja em funcionamento. Abaixo, descrevemos essas etapas gerais usando o Azure ExpressRoute como exemplo. **1.** Ativação da interconexão no provedor de cloud - geralmente, isso implica a criação de um roteador de cloud e um ativo de interconexão (por exemplo, Google Cloud Router e anexo VLAN, Oracle FastConnect etc.). Para este exemplo, é necessário um recurso [azurerm\_express\_route\_circuit](https://registry.terraform.io/providers/hashicorp/azurerm/latest/docs/resources/express_route_circuit) no qual o provedor de serviços (ou seja, `Equinix`) deve ser especificado para gerar uma chave de emparelhamento válida. ``` provider "azurerm" { features {} } resource "azurerm_express_route_circuit" "example" { name = "my-circuit" resource_group_name = "my-resource-group" location = "Germany West Central" service_provider_name = "Equinix" peering_location = "Frankfurt" bandwidth_in_mbps = 100 sku { tier = "Premium" family = "UnlimitedData" } allow_classic_operations = false } ``` **2.** Solicite uma conexão Equinix Fabric - de uma [porta Equinix Fabric](https://docs.equinix.com/fabric/ports/managing-fabric-ports/)/ [dispositivo Network Edge](https://docs.equinix.com/network-edge/)/ [token de serviço Equinix](https://docs.equinix.com/fabric/service-tokens/create-z-side-token)/ [Equinix Fabric Cloud Router](https://docs.equinix.com/fabric-cloud-router/) para o ativo de interconexão virtual de cloud. Neste exemplo, estabeleceremos uma conexão a partir de um recurso do Cloud Router). Observe que o valor de `authorization_key` deve ser o `azurerm_express_route_circuit.example.service_key` (ou seja, a chave de emparelhamento mencionada acima). ``` provider "equinix" {} data "equinix_fabric_service_profile" "azure" { name = "Azure ExpressRoute" filter { property = "/name" operator = "=" values = ["Azure ExpressRoute"] } } resource "equinix_fabric_connection" "fcr2azure"{ name = "ConnectionName" type = "IP_VC" notifications{ type = "ALL" emails = ["example@equinix.com","test1@equinix.com"] } bandwidth = azurerm_express_route_circuit.example.bandwidth_in_mbps order { purchase_order_number = "1-323292" } a_side { access_point { type = "CLOUD_ROUTER" router { uuid = "" } } } z_side { access_point { type = "SP" authentication_key = azurerm_express_route_circuit.example.service_key peering_type = "PRIVATE" profile { type = "L2_PROFILE" uuid = data.equinix_fabric_service_profile.azure.data.0.id } location { metro_code = "SV" } } } } ``` **3.** Configure o BGP no lado da nuvem - conhecido como peering de circuito ou interface virtual, todos os provedores de cloud oferecem um recurso para adicionar um par BGP. Alguns detalhes comumente necessários que precisam ser fornecidos são: * IP do roteador do cliente (o IP do seu roteador de destino para o qual o provedor de cloud deve enviar) tráfego). * Endereço IP do roteador na nuvem (endereço IP do roteador virtual para enviar tráfego para a nuvem). * ASN BGP do cliente (o Número do Sistema Autônomo do Protocolo de Roteamento de Fronteira do seu peer local). roteador). Para este exemplo, precisamos criar um `azurerm_express_route_circuit_peering` onde os detalhes das conexões primária e secundária devem ser definidos. ``` resource "azurerm_express_route_circuit_peering" "example" { express_route_circuit_name = azurerm_express_route_circuit.example.name resource_group_name = "my-resource-group" peering_type = "AzurePrivatePeering" peer_asn = 100 primary_peer_address_prefix = "123.0.0.0/30" secondary_peer_address_prefix = "123.0.0.4/30" vlan_id = 300 bandwidth_in_mpbs = 50 } ``` **4.** Configurar o BGP no Equinix Side - Finalmente, o lado do cliente deve ser configurado com as mesmas informações. Como neste exemplo a origem da conexão é uma Fabric Cloud Router, você pode aproveitar o `equinix_fabric_routing_protocol`recurso para configurar o peering BGP no roteador de cloud. ``` resource "equinix_fabric_routing_protocol" "direct"{ connection_uuid = equinix_fabric_connection.fcr2azure.id type = "DIRECT" name = "direct_rp" direct_ipv4 { equinix_iface_ip = "190.1.1.1/30" } direct_ipv6{ equinix_iface_ip = "190::1:1/126" } } resource "equinix_fabric_routing_protocol" "bgp" { depends_on = [ equinix_fabric_routing_protocol.direct ] connection_uuid = equinix_fabric_connection.fcr2azure.id type = "BGP" name = "bgp_rp" bgp_ipv4 { customer_peer_ip = "190.1.1.2" enabled = true } bgp_ipv6 { customer_peer_ip = "190::1:2" enabled = true } customer_asn = 4532 } ``` ## Módulos Terraform - O jeito mais fácil[​](#módulos-terraform---o-jeito-mais-fácil "Link direto para Módulos Terraform - O jeito mais fácil") Embora a configuração seja semelhante no lado da Equinix, todos os recursos necessários para concluir a configuração dependerão de cada provedor de cloud. Para isso, você precisa ter conhecimento prévio sobre como configurar a interconexão em cada plataforma. Como alternativa, você pode aproveitar os [Módulos do Terraform Equinix Fabric](https://registry.terraform.io/modules/equinix/fabric/equinix/latest) . Os módulos do terraform contêm vários recursos que são usados juntos em uma configuração. Com o [Módulo de Exemplo de Conexão do Azure do Roteador de Nuvem Terraform 2 Equinix Fabric](https://registry.terraform.io/modules/equinix/fabric/equinix/latest/examples/cloud-router-2-azure-connection) e o [Módulo de Protocolos de Roteamento Terraform Equinix Fabric](https://registry.terraform.io/modules/equinix/fabric/equinix/latest/examples/cloud-router-routing-protocols) , você pode configurar todos os recursos descritos acima apenas definindo três recursos. O código abaixo é tudo o que você precisa para substituir completamente o exemplo acima: ``` # main.tf provider "equinix" {} provider "azurerm" {} module "equinix-fabric-connection-azure" { source = "equinix/fabric/equinix//examples/cloud-router-2-azure-connection" # Connection Details connection_name = "fcr_2_azure" connection_type = "IP_VC" notifications_type = "ALL" notifications_emails = ["example@equinix.com","test1@equinix.com"] purchase_order_number = "1-323292" bandwidth = 50 aside_ap_type = "CLOUD_ROUTER" aside_fcr_uuid = "" zside_ap_type = "SP" zside_ap_profile_type = "L2_PROFILE" zside_location = "SV" zside_peering_type = "PRIVATE" zside_fabric_sp_name = "Azure ExpressRoute" # Azure details azure_client_id = "" azure_client_secret = "" azure_tenant_id = "" azure_subscription_id = "" azure_resource_name = "my-resource-group" azure_location = "West US 2" azure_service_key_name = "Test_Azure_Key" azure_service_provider_name = "" azure_peering_location = "Silicon Valley Test" azure_tier = "Standard" azure_family = "UnlimitedData" azure_environment = "PROD" } resource "azurerm_express_route_circuit_peering" "example" { express_route_circuit_name = module.equinix-fabric-connection-azure.azurerm_express_route_circuit_name resource_group_name = "my-resource-group" peering_type = "AzurePrivatePeering" peer_asn = 100 primary_peer_address_prefix = "123.0.0.0/30" secondary_peer_address_prefix = "123.0.0.4/30" vlan_id = 300 bandwidth_in_mpbs = 50 } module "routing_protocols" { source = "equinix/fabric/equinix//modules/routing-protocols" connection_uuid = module.equinix-fabric-connection-azure.module_output # Direct RP Details direct_rp_name = "direct_rp" direct_equinix_ipv4_ip = "190.1.1.1/30" direct_equinix_ipv6_ip = "190::1:1/126" # BGP RP Details bgp_rp_name = "bgp_rp" bgp_customer_asn = 4532 bgp_customer_peer_ipv4 = "190.1.1.2" bgp_enabled_ipv4 = true bgp_customer_peer_ipv6 = var.bgp_customer_peer_ipv6 bgp_enabled_ipv6 = "190::1:2" } ``` * Consulte [Exemplos de conectividade Equinix na página Módulos Fabric](https://registry.terraform.io/modules/equinix/fabric/equinix/latest) Para obter informações sobre mais casos de uso do Fabric que são suportados pelos módulos Terraform do Fabric, Se você não encontrar um para o seu provedor de cloud, você pode abrir um ticket no [repositório do github](https://github.com/equinix/terraform-provider-equinix/issues) com o seu pedido. ## Referências[​](#referências "Link direto para Referências") * Para mais informações, consulte os [guias de instruções do API](https://docs.equinix.com/fabric/) Detalhes sobre os requisitos de cada provedor de serviço de nuvem . * Verifique os [provedores disponíveis](https://www.equinix.com/interconnection-services/equinix-fabric/provider-availability) Na Platform Equinix, encontre o provedor de serviços que você precisa.