Configurer les modules Terraform

Toutes les ressources de calcul, de mise en réseau et d'infrastructure de stockage nécessaires à cette solution sont définies dans les modules Terraform.

Avant de commencer

Avant de configurer les modules Terraform, procédez comme suit :

  1. Découvrez les bases de Terraform.

    Lisez au minimum l'introduction dans la documentation Terrraform.

  2. Préparez les informations suivantes :
    • OCID de votre location.

      L'OCID de votre location est disponible dans la console Web Oracle Cloud Infrastructure. Sélectionnez Administration dans le menu Services, puis cliquez sur Détails de location.

    • OCID de l'utilisateur que Terraform doit utiliser pour l'authentification auprès d'Oracle Cloud Infrastructure.

      Pour trouver l'OCID de l'utilisateur, sélectionnez Identité dans le menu Services, puis Utilisateurs. Localisez votre nom utilisateur dans la liste et copiez son OCID.

    • OCID du compartiment dans lequel créer les ressources.

      Pour trouver l'OCID d'un compartiment, sélectionnez Identité dans le menu Services, puis Catégories. Localisez le compartiment dont vous avez besoin dans la liste et copiez son OCID.

    • ID de la région dans laquelle vous souhaitez créer les ressources.

      Par exemple, l'ID de la région Est des Etats-Unis (Ashburn) est us-ashburn-1.

      Reportez-vous à Régions et domaines de disponibilité.

  3. Décidez des éléments suivants :
  4. Vérifiez que les limites de service de votre location peuvent prendre en charge toutes les ressources que vous voulez créer.

Télécharger le code Terraform

Le code Terraform de cette solution est disponible sur GitHub.

  1. Dans le volet de navigation de gauche, cliquez sur Télécharger le code.
  2. Cliquez sur Référentiel Git.
  3. Clonez ou téléchargez le référentiel sur votre ordinateur local.

A propos du code Terraform

Le code Terraform que vous avez téléchargé a la structure suivante :

├── oci-hyperion-master
│   ├── _docs
│   ├── *.tf
│   ├── env-vars
│   ├── LICENSE.md
│   ├── modules
│   │   ├── bastion
│   │   ├── compute
│   │   ├── dbsystem
│   │   ├── filesystem
│   │   ├── loadbalancer
│   │   └── network
│   ├── orm
│   ├── README.md
│   ├── schema.yaml
│   ├── terraform.tfvars
│   ├── userdata
  • Répertoire _docs : contient les diagrammes d'architecture.
  • *.tf : fichiers de configuration Terraform que la solution utilise. Ne modifiez pas ces fichiers.
  • env-vars : script permettant de définir les variables d'environnement pour Terraform.
  • LICENSE.md : conditions de licence pour le code.
  • modules : répertoires contenant les configurations Terraform de base pour les ressources que vous créez à l'aide de cette solution. Ne les modifiez pas.
  • orm : contient un fichier ZIP que vous pouvez utiliser pour créer une pile dans Oracle Cloud Infrastructure Resource Manager, au lieu d'utiliser Terraform pour déployer la solution.
  • README.md : documentation rapide du code.
  • schema.yaml : contraintes et validations des variables utilisées dans le code Terraform. Ce fichier est utilisé lorsque vous déployez les ressources à l'aide d'Oracle Resource Manager. Ne modifiez pas ce fichier.
  • terraform.tfvars : variables Terraform. Vous définirez les valeurs des variables dans ce fichier ultérieurement.
  • userdata : contient un script qui si exécute sur les instances de calcul après leur création. Ne modifiez pas les fichiers dans ce répertoire.

Définir les variables d'environnement de Terraform

Le code Terraform comprend un fichier de script que vous pouvez utiliser pour stocker des valeurs pour certains paramètres Terraform en tant que variables d'environnement.

  1. Assurez-vous d'avoir rempli les prérequis décrits précédemment.
    Reportez-vous à la section Before You Begin.
  2. Sur votre ordinateur local, accédez au répertoire dans lequel vous avez téléchargé le code Terraform.
  3. Dans le répertoire de niveau supérieur du code, localisez et ouvrez le fichier env-vars dans un éditeur de texte brut.
  4. Indiquez des valeurs appropriées pour les variables dans le fichier.

    Remarque :

    Lorsque vous indiquez la valeur de chaque variable, n'oubliez pas de supprimer la marque de commentaire de la ligne ; il enlève le caractère # (hachage) au début de la ligne.
  5. Vérifiez les valeurs que vous avez spécifiées.
    Si vous omettez des valeurs, vous serez invité à le faire lors de l'exécution de Terraform. Si vous fournissez des valeurs incorrectes, Terraform se solde par une erreur.
  6. Lorsque toutes les valeurs sont correctes, enregistrez et fermez le fichier.
  7. Définissez les variables d'environnement en exécutant la commande suivante à partir du répertoire contenant le fichier de variables d'environnement, en exécutant la commande suivante :
    source ./env-vars
  8. Vérifiez que vous avez défini toutes les variables d'environnement en exécutant la commande suivante :
    env | grep TF
    Les variables d'environnement que vous définissez sont affichées.

Définir les paramètres de déploiement

Indiquez les ressources de calcul, de mise en réseau, de base de données et de stockage à créer, ainsi que leurs propriétés.

  1. Assurez-vous d'avoir rempli les prérequis décrits précédemment.
    Reportez-vous à la section Before You Begin.
  2. Dans le répertoire de niveau supérieur du code que vous avez téléchargé ou cloné, localisez le fichier terraform.tfvars et ouvrez-le dans un éditeur de texte brut.
  3. Définissez les valeurs des variables répertoriées dans le fichier terraform.tfvars.
    Le fichier README dans le code que vous avez téléchargé contient les descriptions des variables et inclut un échantillon d'un fichier terraform.tfvars terminé.
  4. Enregistrez et fermez le fichier terraform.tfvars.