Nota

Installa e configura l'infrastruttura Pulumi come strumento di codice su Oracle Cloud Infrastructure

Introduzione

Semplifichiamo la gestione della tua infrastruttura Oracle Cloud (OCI) con lo strumento Pulumi Infrastructure as Code (IaC). Questo tutorial discuterà come installare e configurare Pulumi, assicurandosi che si adatti perfettamente al tuo flusso di lavoro. Che tu abbia esperienza o abbia iniziato a usare IaC, questo tutorial contiene istruzioni dettagliate. Preparati ad aggiornare la gestione dell'infrastruttura con Pulumi su OCI.

Una volta che Pulumi è in esecuzione nella configurazione OCI, vedrai un notevole miglioramento dell'efficienza. L'interfaccia semplice semplifica l'implementazione e la gestione delle risorse e semplifica la gestione dell'infrastruttura OCI.

Obiettivo

Prerequisiti

Task 1: Scaricare e installare Pulumi

Scarica e installa Pulumi sul tuo sistema o macchina virtuale (VM). Per ulteriori informazioni, vedere Scarica e installa Pulumi.

Ad esempio, gli utenti di macOS possono installare Pulumi eseguendo il seguente comando.

brew install pulumi/tap/pulumi

Task 2: Installare il pacchetto del provider OCI per Pulumi

I provider OCI fungono da connessione tra il codice Pulumi e i servizi OCI che si intende supervisionare. I provider OCI consentono a Pulumi di creare, gestire e configurare le risorse all'interno del tuo ambiente OCI tramite il codice.

Per installare i provider OCI per Pulumi, accedere all'interfaccia CLI (Command Line Interface) ed eseguire il comando di installazione. Per questo tutorial, useremo Python come linguaggio Pulumi per distribuire i servizi OCI.

python3 -m pip install pulumi_oci

Per installare i provider OCI utilizzando altre lingue, vedere Provider OCI per Pulumi.

Task 3: configurare le variabili d'ambiente

Imposta le variabili di ambiente necessarie per connettere Pulumi al tuo ambiente OCI. Queste variabili includono l'OCID (Oracle Cloud Identifier) della tenancy, l'OCID utente, l'impronta digitale, l'area e il percorso della chiave API OCI.

Modificare i valori secondo il file di configurazione della tenancy ed eseguire i comandi seguenti.

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"

Task 4: Creare uno stack Pulumi

Organizza il tuo progetto creando una directory per il tuo stack Pulumi. Inizializzalo con il tuo linguaggio di programmazione preferito. Per questo tutorial, stiamo utilizzando lo stack Python.

  1. Creare una directory di stack Pulumi. Per creare una nuova directory per il tuo stack Pulumi, esegui il seguente comando.

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack

  2. Inizializza il progetto Pulumi con un modello Python OCI: pulumi new oci-python.

  3. Immettere i dettagli del progetto, ad esempio il nome del progetto, la descrizione e il nome dello stack, ad esempio dev, staging, prod. Questo passo avvia il processo di impostazione, inclusa l'aggiunta delle dipendenze necessarie e il caricamento del codice di esempio nel file main.py.

  4. Verificare l'impostazione del codice controllando il contenuto della directory OCI_Pulumi_Stack. Qui troverai il codice di esempio ed eventuali file aggiuntivi creati durante il processo di inizializzazione.

Task 5: Personalizzare uno stack Pulumi

Personalizza uno stack in base alle tue esigenze specifiche. Aprire il file di distribuzione principale main.py e aggiungere il codice necessario per definire le risorse OCI che si desidera distribuire. In questa esercitazione verrà descritto come recuperare i domini di disponibilità all'interno della tenancy 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)

Questo codice mostra come recuperare i domini di disponibilità dalla tenancy OCI ed esportarne i nomi come output. Quando esegui questo codice utilizzando Pulumi, interagirà con OCI per recuperare i domini di disponibilità e visualizzarne i nomi come output. Ciò ti consente di assicurarti che il tuo codice recupera in modo accurato le informazioni necessarie da OCI.

Task 6: Implementa il codice Pulumi su OCI

Eseguire il comando riportato di seguito per distribuire le risorse in OCI.

pulumi up

Task 7: Verificare l'output del comando

Dopo la distribuzione, il comando eseguirà il programma Pulumi e recupererà i domini di disponibilità all'interno della tenancy OCI, come definito nel codice.

Pulumi_OCI_Output

Conferma

Altre risorse di apprendimento

Esplora altri laboratori su docs.oracle.com/learn o accedi a più contenuti gratuiti sulla formazione su Oracle Learning YouTube channel. Inoltre, visita education.oracle.com/learning-explorer per diventare Oracle Learning Explorer.

Per la documentazione del prodotto, visitare Oracle Help Center.