Remarques :

Installer et configurer l'outil Pulumi Infrastructure as Code sur Oracle Cloud Infrastructure

Introduction

Simplifiez la gestion de votre infrastructure Oracle Cloud (OCI) avec l'outil Pulumi Infrastructure as Code (IaC). Ce tutoriel vous expliquera comment installer et configurer Pulumi, en vous assurant qu'il s'intègre parfaitement dans votre flux de travail. Que vous soyez expérimenté ou que vous commenciez à utiliser IaC, ce tutoriel contient des instructions détaillées. Préparez-vous à mettre à niveau votre gestion d'infrastructure avec Pulumi sur OCI.

Une fois Pulumi exécuté sur votre configuration OCI, vous constaterez une amélioration notable de l'efficacité. L'interface simple facilite le déploiement et la gestion des ressources et simplifie la gestion de votre infrastructure OCI.

Objectif

Prérequis

Tâche 1 : télécharger et installer Pulumi

Téléchargez et installez Pulumi sur votre système ou votre machine virtuelle. Pour plus d'informations, reportez-vous à Téléchargement et installation de Pulumi.

Par exemple, les utilisateurs macOS peuvent installer Pulumi en exécutant la commande suivante.

brew install pulumi/tap/pulumi

Tâche 2 : installation du package de fournisseur OCI pour Pulumi

Les fournisseurs OCI servent de connexion entre le code Pulumi et les services OCI que vous souhaitez superviser. Les fournisseurs OCI permettent à Pulumi de créer, gérer et configurer des ressources dans votre environnement OCI via du code.

Pour installer les fournisseurs OCI pour Pulumi, accédez à l'interface de ligne de commande et exécutez la commande d'installation. Pour ce tutoriel, nous allons utiliser Python comme langage Pulumi pour déployer des services OCI.

python3 -m pip install pulumi_oci

Pour installer des fournisseurs OCI à l'aide d'autres langues, reportez-vous à Fournisseur OCI pour Pulumi.

Tâche 3 : configurer les variables d'environnement

Configurez les variables d'environnement nécessaires pour connecter Pulumi à votre environnement OCI. Ces variables incluent l'identificateur Oracle Cloud (OCID) de la location, l'OCID utilisateur, l'empreinte, la région et le chemin d'accès à la clé d'API OCI.

Modifiez les valeurs conformément au fichier de configuration de votre location et exécutez les commandes suivantes.

export TF_VAR_tenancy_ocid="ocid1.tenancy.oc1..<unique_ID>"

export TF_VAR_user_ocid="ocid1.user.oc1..<unique_ID>"

export TF_VAR_fingerprint="<key_fingerprint>"

export TF_VAR_region="us-ashburn-1"

export TF_VAR_private_key_path="/path/to/oci_api_key.pem"

Tâche 4 : créer une pile Pulumi

Organisez votre projet en créant un répertoire pour votre pile Pulumi. Initialisez-le avec votre langage de programmation préféré. Pour ce tutoriel, nous utilisons une pile Python.

  1. Créez un répertoire de pile Pulumi. Pour créer un répertoire pour votre pile Pulumi, exécutez la commande suivante.

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack

  2. Initialisez le projet de projet Pulumi avec un modèle OCI Python : pulumi new oci-python.

  3. Entrez les détails du projet, tels que le nom du projet, sa description et le nom de la pile (par exemple, dev, staging, prod). Cette étape démarre le processus de configuration, notamment en ajoutant les dépendances nécessaires et en chargeant un exemple de code dans le fichier main.py.

  4. Vérifiez la configuration du code en vérifiant le contenu du répertoire OCI_Pulumi_Stack. Vous y trouverez l'exemple de code et les fichiers supplémentaires créés au cours du processus d'initialisation.

Tâche 5 : personnaliser une pile Pulumi

Personnalisez une pile en fonction de vos besoins spécifiques. Ouvrez le fichier de déploiement principal main.py et ajoutez le code nécessaire pour définir les ressources OCI à déployer. Dans ce tutoriel, nous vous montrerons comment extraire les domaines de disponibilité dans votre location OCI.

"""A OCI Python Pulumi program"""

import pulumi

import pulumi_oci as oci

test_availability_domains = oci.identity.get_availability_domains(compartment_id="ocid1.tenancy.oc1..xxxxx")

# Output availability domains

pulumi.export("availability_domain_1", test_availability_domains.availability_domains[0].name)

pulumi.export("availability_domain_2", test_availability_domains.availability_domains[1].name)

pulumi.export("availability_domains_3", test_availability_domains.availability_domains[2].name)

Ce code explique comment extraire les domaines de disponibilité de votre location OCI et exporter leurs noms en tant que sortie. Lorsque vous exécutez ce code à l'aide de Pulumi, il interagit avec OCI pour extraire les domaines de disponibilité et afficher leur nom en tant que sortie. Cela vous permet de vous assurer que votre code extrait avec précision les informations nécessaires à partir d'OCI.

Tâche 6 : déploiement du code Pulumi vers OCI

Exécutez la commande suivante pour déployer des ressources vers OCI.

pulumi up

Tâche 7 : vérifier la sortie de la commande

Après le déploiement, la commande exécute le programme Pulumi et extrait les domaines de disponibilité dans votre location OCI, comme défini dans le code.

Pulumi_OCI_Output

Remerciements

Ressources de formation supplémentaires

Parcourez d'autres ateliers sur docs.oracle.com/learn ou accédez à davantage de contenus de formation gratuits sur le canal Oracle Learning YouTube. De plus, rendez-vous sur education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour obtenir de la documentation sur le produit, visitez Oracle Help Center.