Création d'un fichier de configuration Terraform
Voyez comment créer un fichier de configuration terraform avec le langage propre au domaine Terraform ou le format JSON si les fichiers doivent être lisibles par machine.
Terraform utilise une syntaxe déclarative pour décrire l'infrastructure Oracle Cloud Infrastructure (OCI) et la projette dans des fichiers de configuration avec contrôle de version qui peuvent être partagés, révisés, modifiés, conservés et réutilisés. Voir Syntaxe de configuration. Les fichiers de configuration Terraform peuvent utiliser l'un des deux formats suivants : Langage propre à un domaine Terraform (format HCL), qui est l'approche recommandée, ou le format JSON si les fichiers doivent être lisibles par machine. Les fichiers de configuration qui utilisent le format HCL se terminent par l'extension de fichier .tf; 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 machine.
Utilisez les configurations Terraform pour définir les ressources dont votre solution ou application a besoin au moment du déploiement. Les ressources peuvent créer des objets Oracle Cloud Infrastructure, tels que des réseaux en nuage virtuels ou des instances de calcul. Votre première application de la configuration crée les objets, et les applications ultérieures peuvent les mettre à jour ou les supprimer. Terraform convertit ensuite vos configurations Oracle Cloud Infrastructure en jeu d'appels d'API aux points d'extrémité d'API Oracle Cloud Infrastructure. La clé permettant d'écrire la configuration Terraform comprend comment convertir l'infrastructure souhaitée, sur le plan conceptuel, en syntaxe de configuration Terraform.
Selon votre niveau d'expérience dans le développement de configurations Terraform, vous pouvez lancer le démarrage avec un modèle de pile de marché des applications ou créer vos propres sections Configurations Terraform.
Introduction à un modèle de pile du marché des applications
Une collection d'exemples qui permettent aux éditeurs d'Oracle Cloud Infrastructure Marketplace de commencer rapidement à déployer des applications dans Oracle Cloud Infrastructure est disponible dans 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 de piles qui s'exécutent à partir de l'interface de ligne de commande Terraform locale, du gestionnaire de ressources OCI et de Cloud Shell.
Nous vous recommandons de commencer en créant 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) ont des exigences spécifiques, selon les composants définis dans le fichier. Par exemple, votre fournisseur Terraform pourrait être défini dans un fichier (provider.tf), vos variables dans un autre fichier (variables.tf) et vos sources de données dans un autre fichier. Le modèle de pile de démarrage rapide du marché des applications 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éployer une instance avec une image personnalisée
Pour créer une instance à partir d'une image personnalisée, procédez comme suit :
-
Localisez la ressource oci_core_instance dans le fichier compute.tf et réglez source_details à local.compute_image_id dans le modèle oci-quickstart-template que vous venez de cloner. La variable locale local.compute_image_id peut être réglée à un ocid d'image personnalisé ou à un ocid d'image du marché des applications. Basé sur l'indicateur mp_subscription_enable.
-
Modifiez variables.tf en réglant la valeur d'attribut par défaut de la variable compute_image_id à 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 à vos configurations Terraform, mais ne vous limite pas à créer votre propre infrastructure en tant que code. Pour plus d'exemples, voir Fournisseur Terraform pour Oracle Cloud Infrastructure pour OCI : terraform-provider-OCI/docs/examples. Assurez-vous que vos fichiers Terraform sont conformes aux Directives pour les piles du service de marché d'applications.