Documentation Oracle Cloud Infrastructure

Création d'un fichier de configuration Terraform

Découvrez comment créer un fichier de configuration terraform avec un langage propre à un domaine Terraform ou un format JSON si les fichiers doivent être lisibles par machine.

Terraform emploie la syntaxe déclarative pour décrire l'infrastructure Oracle Cloud Infrastructure (OCI), puis la rendre persistante dans des fichiers de configuration pouvant être partagés, révisés, modifiés, gérés avec des numéros de version, conservés et réutilisés. Reportez-vous à la section Configuration Syntax. Les fichiers de configuration Terraform peuvent utiliser l'un des deux formats suivants : le langage propre au domaine Terraform (format HCL, HashiCorp Configuration Language), qui est l'approche recommandée, ou le format JSON si les fichiers doivent être lisibles par la machine. Les fichiers de configuration qui utilisent le format HCL se terminent par l'extension de fichier .tf, alors que ceux qui utilisent le format JSON se terminent par l'extension de fichier .tf.json. Le format Terraform est lisible par l'utilisateur, alors que le format JSON est lisible par la machine.

Utilisez les configurations Terraform pour définir les ressources requises par votre solution ou application au moment du déploiement. Les ressources peuvent créer des objets Oracle Cloud Infrastructure, tels que des réseaux cloud virtuels ou des instances de calcul. Votre première application de la configuration crée les objets, et les applications suivantes peuvent les mettre à jour ou les supprimer. Terraform convertit ensuite vos configurations Oracle Cloud Infrastructure en un ensemble d'appels d'API vers les adresses d'API Oracle Cloud Infrastructure. Pour écrire une configuration Terraform, il est important de comprendre comment extraire l'infrastructure souhaitée de manière conceptuelle dans la syntaxe de configuration Terraform.

Selon votre niveau d'expérience dans le développement de configurations Terraform, vous pouvez commencer avec un modèle de pile Marketplace ou créer vos propres sections Configurations Terraform.

Introduction à un modèle de pile Marketplace

Un ensemble d'exemples permettant aux éditeurs Oracle Cloud Infrastructure Marketplace de commencer rapidement à déployer des applications dans Oracle Cloud Infrastructure est disponible sur le modèle de démarrage rapide OCI. Ce référentiel contient le modèle qui peut être utilisé pour accélérer la construction des piles exécutées à partir de l'interface de ligne de commande Terraform locale, d'OCI Resource Manager et de Cloud Shell.

Nous vous recommandons de commencer par créer un clone du référentiel oci-quickstart-template :

$> git clone https://github.com/oracle-quickstart/oci-quickstart-template.git
$> cd oci-quickstart-template

Les fichiers de configuration Terraform (.tf) présentent des exigences spécifiques, en fonction des composants qui y sont définis. Par exemple, votre fournisseur Terraform peut être défini dans un fichier (provider.tf), vos variables peuvent être définies dans un autre fichier (variables.tf) et vos sources de données dans un autre fichier encore. Le modèle de pile de démarrage rapide Marketplace regroupe des ressources similaires dans des fichiers individuels, mais notez que la disposition du système de fichiers n'est qu'un exemple de référence.

Déploiement d'une instance avec une image personnalisée

Pour créer une instance à partir d'une image personnalisée, procédez comme suit :

  1. Localisez la ressource oci_core_instance dans le fichier compute.tf et définissez source_details sur local.compute_image_id dans le modèle oci-quickstart que vous venez de cloner. La variable locale local.compute_image_id peut être définie sur un ocid d'image personnalisée ou sur un ocid d'image Marketplace. basé sur l'indicateur mp_subscription_enable.

  2. Modifiez variables.tf en définissant la valeur d'attribut par défaut de la variable compute_image_id sur l'OCID de l'image personnalisée que vous avez créée après la tâche 2 dans Création d'une liste de piles OCI dans le portail des partenaires.

Création de votre propre pile Marketplace

Le référentiel oci-quickstart-template sert de point de départ pour vos configurations Terraform, mais ne vous limite pas à créer votre propre infrastructure en tant que code. Pour plus d'exemples, reportez-vous à Fournisseur Terraform Oracle Cloud Infrastructure pour OCI : terraform-provider-OCI/docs/examples. Assurez-vous que vos fichiers Terraform sont conformes aux directives pour les piles Marketplace.