Note :

Installer et configurer Pulumi Infrastructure en tant qu'outil de code sur Oracle Cloud Infrastructure

Présentation

Simplifions la gestion de votre infrastructure Oracle Cloud (OCI) avec l'outil Pulumi Infrastructure as Code (IaC). Ce tutoriel explique comment installer et configurer Pulumi, en s'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 étape par étape. Préparez-vous à mettre à niveau votre gestion d'infrastructure avec Pulumi sur OCI.

Une fois que Pulumi s'exécute 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 l'infrastructure OCI.

Objectif

Préalables

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

Téléchargez et installez Pulumi sur votre système ou machine virtuelle (VM). Pour plus d'informations, voir Télécharger et installer Pulumi.

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

brew install pulumi/tap/pulumi

Tâche 2 : Installer l'ensemble de fournisseurs OCI pour Pulumi

Les fournisseurs OCI agissent comme la connexion entre le code Pulumi et les services OCI que vous souhaitez superviser. Les fournisseurs OCI permettent à Pulumi de créer, de gérer et de configurer des ressources dans votre environnement OCI au moyen de code.

Pour installer les fournisseurs OCI pour Pulumi, allez à l'interface de ligne de commande et exécutez la commande d'installation. Pour ce tutoriel, nous utiliserons 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, voir 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 votre location, l'OCID de l'utilisateur, l'empreinte numérique, la région et le chemin d'accès à votre 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 la pile Python.

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

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack

  2. Initialisez le projet Pulumi avec un modèle Python OCI : 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, développement, stockage temporaire, production). 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. C'est là que vous trouverez l'exemple de code et tous 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 allons vous montrer comment extraire les domaines de disponibilité de 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 montre 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 leurs noms en tant que sortie. Cela vous permet de vous assurer que votre code extrait correctement les informations nécessaires à partir d'OCI.

Tâche 6 : Déployer le code Pulumi dans 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écutera le programme Pulumi et extraira les domaines de disponibilité dans votre location OCI, tels que définis dans le code.

Pulumi_OCI_Output

Remerciements

Autres ressources d'apprentissage

Explorez d'autres laboratoires sur docs.oracle.com/learn ou accédez à plus de contenu d'apprentissage gratuit sur le canal YouTube d'Oracle Learning. De plus, visitez education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

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