Terraform Terraform Terraform Terraform Terraform Terraform Terraform Terraform Criando um arquivo de configuração do provedor Terraform Megaport

Criando um arquivo de configuração do Megaport Terraform Provider

Este tópico fornece instruções passo a passo para preparar um arquivo de configuração do Megaport Terraform Provider, com base em métodos comuns e eficazes identificados pelos Arquitetos de Soluções da Megaport por meio de interações com clientes.

Antes de começar, execute os pré-requisitos descritos em Introdução ao Megaport Terraform Provider.

Criando um arquivo de configuração

Quando o design da sua rede estiver pronto, você poderá criar arquivos de configuração executáveis do Terraform para implementar o design usando estas etapas.

Para criar um arquivo de configuração

Projete sua rede com os serviços da Megaport.

Exemplos de arquivos de configuração do Megaport Terraform Provider estão disponíveis no Megaport Terraform Provider GitHub repository.

A Megaport também fornece explicações sobre cenários comuns de conectividade multicloud. Exemplos de arquivos de configuração do Megaport Terraform Provider para cenários comuns de conectividade multicloud podem ser encontrados na Megaport Terraform Provider GitHub examples page.
Identifique o ID do local habilitado da Megaport.

Os nomes dos locais de data center e os códigos de site às vezes podem mudar na API. Para configurações do Megaport Terraform Provider confiáveis e estáveis, use o ID do local em vez de nomes ou códigos. Para a lista mais atualizada de locais de data center da Megaport, consulte IDs de local da Megaport.

Os IDs de local também estão disponíveis por meio da GET /v3/locations Megaport API.
Defina o ambiente do Megaport Terraform Provider.

Existem algumas formas de gerenciar diretórios e arquivos de configuração do Terraform (arquivos .tf). Você precisa estabelecer a maneira mais eficaz de gerenciar seus recursos do Terraform para atender às suas necessidades.

O exemplo a seguir mostra como você pode manter arquivos de configuração do Terraform de forma organizada.
- Crie um diretório para manter um conjunto de arquivos de configuração do Terraform para gerenciar um determinado conjunto de serviços da Megaport, como Port, MCR, VXC.
- Crie um arquivo provider.tf que declara o ambiente do Megaport Terraform Provider.
  
  Nota
  
  Você pode definir configurações de outros providers, como AWS, Azure e GCP, no arquivo provider.tf. Para mais informações, consulte Build Infrastructure (HashiCorp).
- Mantenha oprovider.tf no mesmo diretório em que os outros arquivos de configuração do Terraform estão armazenados. O exemplo a seguir mostra o arquivo provider.tf contendo as configurações relacionadas ao Megaport Terraform Provider:
```
terraform {
  required_providers {
    megaport = {
      source = "megaport/megaport"
        version = ">= 1.4.1"
    }
  }
}
provider "megaport" {
  environment           = "staging"
  access_key            = "access_key"
  secret_key            = "secret_Key"
  accept_purchase_terms = true
}
```
  Nota
  
  Há alguns campos e informações importantes que você precisa definir para configurar o arquivo de configuração do Megaport Terraform Provider.
  - Version (Versão) – Megaport testa contra as duas versões principais mais recentes do Terraform. Você pode encontrar a versão mais recente do Megaport Terraform Provider na Megaport Terraform Provider Registry documentation. Recomendamos fortemente manter o arquivo provider.tf atualizado com o número da versão mais recente.
  - Environment (Ambiente) – Define o ambiente no qual você implantará serviços usando o Terraform. Por exemplo, se definido como staging, os serviços serão criados no ambiente https://portal-staging.megaport.com/. Quando terminar os testes no ambiente de staging e quiser começar a implantar serviços no ambiente de produção, defina esse valor como production. Para mais informações, consulte Ambientes.
  - API key (Chave de API) – Você precisa criar uma chave de API antes de poder usar o Megaport Terraform Provider. A chave de API consiste nos valores access_key e secret_key. As chaves de API são válidas somente no ambiente em que foram criadas. Se você precisar de uma chave de API para acessar um ambiente diferente, faça login no Megaport Portal desse ambiente e crie a chave de API lá. Para mais informações, consulte Criando uma chave de API.
  - Accept purchase terms (Aceitar termos de compra) – Para solicitar serviços da Megaport usando o Terraform, você deve aceitar os termos de compra. Isso permitirá que um evento faturável ocorra no ambiente de produção, ou seja, criar e implantar serviços da Megaport no ambiente de produção que gerarão custos.
Crie o arquivo main.tf, que declara sua infraestrutura. Em seguida, copie a configuração de exemplo que implementa um design de rede mais próximo do seu e modifique-a conforme necessário no arquivo main.tf.

Você pode encontrar configurações de exemplo no Megaport Terraform Provider GitHub repository.

O exemplo a seguir mostra uma configuração do Megaport Terraform Provider para solicitar um único Port.
```
data "megaport_location" "location_1" {
  name = "NextDC B1"
}

resource "megaport_port" "port" {
  product_name           = "Megaport Port Example"
  port_speed             = 10000
  location_id            = 5
  contract_term_months   = 1
  marketplace_visibility = false
}
```
Ao implantar o Terraform, o provider.tf é executado primeiro. Em seguida, o main.tf será executado automaticamente junto com quaisquer outros arquivos de configuração do Terraform salvos no mesmo diretório.
Se esta for a sua primeira vez usando o Terraform, execute o comando terraform init no seu diretório para preparar o diretório de trabalho que contém os arquivos de configuração do Terraform.

Esse comando executa várias tarefas de preparação, como baixar o Megaport Terraform Provider e outros plugins de backend para preparar seu diretório de trabalho para uso com o Terraform.

Para executar esse comando, o diretório deve primeiro conter arquivos de configuração do Terraform. É seguro executar esse comando várias vezes para atualizar o diretório de trabalho com as alterações na configuração.

A imagem abaixo mostra um exemplo da saída do comando terraform init.

Para mais informações, consulte terraform init command (HashiCorp).

Próximas etapas

Depois de preparar os arquivos de configuração do Terraform, você pode implantá-los no ambiente de staging para testes iniciais, antes de aplicá-los no ambiente de produção.

Para mais informações, consulte Criando e gerenciando serviços usando o Megaport Terraform Provider.

Criando um arquivo de configuração do Megaport Terraform Provider

Criando um arquivo de configuração

Próximas etapas

Referências úteis