Terraform Terraform Terraform Terraform Terraform Terraform Terraform Terraform Crear un archivo de configuración del proveedor de Terraform de Megaport

Creación de un archivo de configuración de Megaport Terraform Provider

Este tema proporciona instrucciones paso a paso para preparar un archivo de configuración de Megaport Terraform Provider, basadas en métodos comunes y eficaces identificados por los Arquitectos de Soluciones de Megaport a través de interacciones con clientes.

Antes de comenzar, realice los requisitos previos descritos en Introducción a Megaport Terraform Provider.

Creación de un archivo de configuración

Cuando su diseño de red esté listo, puede crear archivos de configuración ejecutables de Terraform para implementar el diseño utilizando estos pasos.

Para crear un archivo de configuración

Diseñe su red con los servicios de Megaport.

Ejemplos de archivos de configuración de Megaport Terraform Provider están disponibles en el Megaport Terraform Provider GitHub repository.

Megaport también proporciona explicaciones sobre escenarios comunes de conectividad multicloud. Ejemplos de archivos de configuración de Megaport Terraform Provider de escenarios comunes de conectividad multicloud se pueden encontrar en la Megaport Terraform Provider GitHub examples page.
Identifique el ID de ubicación habilitada de Megaport.

Los nombres de ubicaciones de centros de datos y los códigos de sitio a veces pueden cambiar en la API. Para obtener configuraciones de Megaport Terraform Provider confiables y estables, use el ID de ubicación en lugar de nombres o códigos. Para la lista más actualizada de ubicaciones de centros de datos de Megaport, consulte ID de ubicaciones de Megaport.

Los ID de ubicación también están disponibles a través de la GET /v3/locations Megaport API.
Defina el entorno de Megaport Terraform Provider.

Hay varias formas de administrar directorios y archivos de configuración de Terraform (archivos .tf). Debe establecer la forma más eficaz de administrar sus recursos de Terraform para satisfacer sus necesidades.

El siguiente ejemplo muestra cómo podría mantener los archivos de configuración de Terraform de forma organizada.
- Cree un directorio para guardar un conjunto de archivos de configuración de Terraform con el fin de administrar un determinado conjunto de servicios de Megaport, como Port, MCR, VXC.
- Cree un archivo provider.tf que declare el entorno de Megaport Terraform Provider.
  
  Nota
  
  Puede definir la configuración de otros providers, como AWS, Azure y GCP, en el archivo provider.tf. Para obtener más información, consulte Build Infrastructure (HashiCorp).
- Mantenga elprovider.tf en el mismo directorio donde se almacenan otros archivos de configuración de Terraform. El siguiente ejemplo muestra el archivo provider.tf que contiene las configuraciones relacionadas con 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
  
  Hay algunos campos e información importantes que debe definir para configurar el archivo de configuración de Megaport Terraform Provider.
  - Versión – Megaport realiza pruebas con las dos últimas versiones principales de Terraform. Puede encontrar la versión más reciente de Megaport Terraform Provider en la Megaport Terraform Provider Registry documentation. Recomendamos encarecidamente mantener el archivo provider.tf actualizado con el número de versión más reciente.
  - Entorno – Define el entorno en el que implementará servicios usando Terraform. Por ejemplo, si se establece en staging, entonces los servicios se crearán en el entorno https://portal-staging.megaport.com/. Cuando termine de realizar pruebas en el entorno de staging y quiera empezar a implementar servicios en el entorno de producción, cambie este valor a production. Para obtener más información, consulte Entornos.
  - Clave de API – Debe crear una clave de API antes de poder usar Megaport Terraform Provider. La clave de API consta de los valores access_key y secret_key. Las claves de API solo son válidas en el entorno en el que se crearon. Si necesita una clave de API para acceder a un entorno diferente, inicie sesión en Megaport Portal de ese entorno y cree allí la clave de API. Para obtener más información, consulte Creación de una clave de API.
  - Aceptar condiciones de compra – Para solicitar servicios de Megaport usando Terraform, debe aceptar las condiciones de compra. Esto permitirá que ocurra un evento facturable en el entorno de producción; es decir, crear e implementar servicios de Megaport en el entorno de producción que generarán costos.
Cree el archivo main.tf, que declara su infraestructura. Luego copie la configuración de ejemplo que implementa un diseño de red más cercano al suyo y modifíquela según sea necesario en el archivo main.tf.

Puede encontrar configuraciones de ejemplo en el Megaport Terraform Provider GitHub repository.

El siguiente ejemplo muestra una configuración de Megaport Terraform Provider para solicitar un Port único.
```
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
}
```
Cuando implemente Terraform, primero se ejecutará provider.tf. Luego main.tf se ejecutará automáticamente junto con cualquier otro archivo de configuración de Terraform guardado en el mismo directorio.
Si es la primera vez que usa Terraform, ejecute el comando terraform init en su directorio para preparar el directorio de trabajo que contiene archivos de configuración de Terraform.

Este comando realiza varias tareas de configuración, como descargar Megaport Terraform Provider y otros plugins de backend para preparar su directorio de trabajo para su uso con Terraform.

Para ejecutar este comando, el directorio debe tener primero archivos de configuración de Terraform. Es seguro ejecutar este comando varias veces para poner al día el directorio de trabajo con los cambios en la configuración.

La siguiente imagen muestra un ejemplo de la salida del comando terraform init.

Para obtener más información, consulte terraform init command (HashiCorp).

Pasos siguientes

Después de preparar los archivos de configuración de Terraform, puede implementarlos en el entorno de staging para realizar pruebas iniciales antes de aplicarlos en el entorno de producción.

Para obtener más información, consulte Creación y administración de servicios con Megaport Terraform Provider.

Creación de un archivo de configuración de Megaport Terraform Provider

Creación de un archivo de configuración

Pasos siguientes

Referencias útiles