Terraform Terraform Terraform Terraform Terraform Terraform Terraform Terraform Création d’un fichier de configuration du fournisseur Terraform Megaport

Créer un Fichier de Configuration Megaport Terraform Provider

Ce sujet fournit des instructions étape par étape pour préparer un fichier de configuration Megaport Terraform Provider, basé sur des méthodes courantes et efficaces identifiées par les architectes solutions Megaport lors d’engagements avec des clients.

Avant de commencer, effectuez les prérequis décrits dans Commencer avec le Megaport Terraform Provider.

Création d’un fichier de configuration

Lorsque vous êtes prêt avec votre conception réseau, vous pouvez créer des fichiers de configuration Terraform exécutables pour déployer la conception à l’aide de ces étapes.

Pour créer un fichier de configuration

Concevez votre réseau avec les services Megaport.

Des exemples de fichiers de configuration Megaport Terraform Provider sont disponibles dans le répertoire GitHub de Megaport Terraform Provider.

Megaport fournit également des explications sur les scénarios de connectivité multicloud courants. Des exemples de fichiers de configuration Megaport Terraform Provider pour des scénarios de connectivité multicloud courants se trouvent sur la page des exemples GitHub de Megaport Terraform Provider.
Identifiez l’ID de localisation activée Megaport.

Les noms de localisation des centres de données et les codes de site peuvent parfois changer dans l’API. Pour des configurations Megaport Terraform Provider fiables et stables, utilisez l’ID de localisation au lieu des noms ou des codes. La liste la plus à jour des localisations des centres de données Megaport est accessible via l’API GET /v3/locations Megaport.
Définissez l’environnement Megaport Terraform Provider.

Il y a plusieurs façons de gérer les répertoires et fichiers de configuration (.tf) de Terraform. Vous devez établir la manière la plus efficace de gérer vos ressources Terraform pour répondre à vos besoins.

L’exemple suivant montre comment vous pourriez organiser les fichiers de configuration Terraform de manière organisée.
- Créez un répertoire pour conserver un ensemble de fichiers de configuration Terraform afin de gérer un certain ensemble de services Megaport, tels que Port, MCR, VXC.
- Créez un fichier provider.tf qui déclare l’environnement Megaport Terraform Provider.
  
  Remarque
  
  Vous pouvez définir les paramètres d’autres providers, comme AWS, Azure et GCP dans le fichier provider.tf. Pour plus d’informations, voir Créer une Infrastructure (HashiCorp).
- Conservez le fichier provider.tf dans le même répertoire que les autres fichiers de configuration Terraform. L’exemple suivant montre le fichier provider.tf contenant les configurations liées à Megaport Terraform Provider:
```
terraform {
       required_providers {
       megaport = {
       source  = "megaport/megaport"
       version = "1.3.6"
           }
       }
   }
       provider "megaport" {
       environment           = "staging"
       access_key            = "access_key"
       secret_key            = "secret_Key"
       accept_purchase_terms = true
       }
```
Remarque

Il y a des champs et des informations importants que vous devez définir pour configurer le fichier de configuration Megaport Terraform Provider.
- Version – Megaport teste contre les deux dernières versions majeures de Terraform. Vous pouvez trouver la dernière version de Megaport Terraform Provider dans la documentation du registre Megaport Terraform Provider. Nous vous recommandons fortement de garder le fichier provider.tf à jour avec le dernier numéro de version.
- Environnement – Cela définit l’environnement dans lequel vous déploierez des services en utilisant Terraform. Par exemple, si cela est défini sur staging, alors les services seront créés dans l’environnement https://portal-staging.megaport.com/. Lorsque vous avez terminé de tester dans l’environnement de staging et que vous voulez commencer à déployer des services dans l’environnement de production, définissez cette valeur sur production. Pour plus d’informations, voir Environnements.
- Clé API - Vous devez Création d’une clé API avant de pouvoir utiliser le Megaport Terraform Provider. La clé API se compose des valeurs access_key et secret_key.
  
  Les clés API ne sont valides que dans l’environnement dans lequel elles ont été créées. Si vous avez besoin d’une clé API pour accéder à un environnement différent, connectez-vous au Megaport Portal dans cet environnement et créez-y la clé API. Pour plus d’informations, voir Création d’une clé API.
- Accepter les termes d’achat – Pour commander des services Megaport en utilisant Terraform, vous devez accepter les termes d’achat. Cela permettra à un événement facturable de se produire dans l’environnement de production, c’est-à-dire créer et déployer des services Megaport dans l’environnement de production qui entraîneront des coûts.
Créez le fichier main.tf, qui déclare votre infrastructure. Ensuite, copiez la configuration d’exemple qui implémente une conception réseau la plus proche de la vôtre et modifiez-la selon vos besoins dans le fichier main.tf.

Vous pouvez trouver des configurations d’exemple dans le répertoire GitHub de Megaport Terraform Provider.

L’exemple suivant montre une configuration Megaport Terraform Provider pour commander un seul Port.
```
data "megaport_location" "bne_nxt1" {
   name = "NextDC B1"
}

resource "megaport_port" "port" {
   product_name           = "Megaport Port Example"
   port_speed             = 1000
   location_id            = data.megaport_location.bne_nxt1.id
   contract_term_months   = 1
   marketplace_visibility = false
   cost_centre            = "Megaport Single Port Example"
}
```
Lorsque vous déployez Terraform, provider.tf est exécuté en premier. Ensuite, main.tf sera exécuté automatiquement avec tout autre fichier de configuration Terraform enregistré dans le même répertoire.
Si c’est la première fois que vous utilisez Terraform, exécutez la commande terraform init dans votre répertoire pour préparer le répertoire de travail contenant les fichiers de configuration Terraform.

Cette commande effectue plusieurs tâches d’installation telles que le téléchargement de Megaport Terraform Provider et d’autres plugins backend pour préparer votre répertoire de travail à l’utilisation avec Terraform.

Pour exécuter cette commande, le répertoire doit d’abord contenir des fichiers de configuration Terraform. Il est sûr d’exécuter cette commande plusieurs fois pour mettre à jour le répertoire de travail avec les changements de configuration.

L’image suivante montre un exemple de sortie de la commande terraform init.

Pour plus d’informations, voir commande terraform init (HashiCorp).

Étapes suivantes

Après avoir préparé les fichiers de configuration Terraform, vous pouvez les déployer dans l’environnement de staging pour des tests initiaux avant de les appliquer à l’environnement de production.

Pour plus d’informations, voir Créer et Gérer des Services en utilisant le Megaport Terraform Provider.

Créer un Fichier de Configuration Megaport Terraform Provider

Création d’un fichier de configuration

Étapes suivantes

Références utiles