Hinweis:

Pulumi Infrastructure as Code-Tool auf Oracle Cloud Infrastructure installieren und konfigurieren

Einführung

Vereinfachen Sie Ihr Oracle Cloud Infrastructure-(OCI-)Management mit dem Pulumi Infrastructure as Code-(IaC-)Tool. In diesem Tutorial wird beschrieben, wie Pulumi installiert und eingerichtet wird, um sicherzustellen, dass es nahtlos in Ihren Workflow passt. Unabhängig davon, ob Sie Erfahrung haben oder mit IaC beginnen, dieses Tutorial enthält Schritt-für-Schritt-Anweisungen. Machen Sie sich bereit, Ihr Infrastrukturmanagement mit Pulumi auf OCI zu aktualisieren.

Sobald Pulumi auf Ihrem OCI-Setup ausgeführt wird, sehen Sie eine spürbare Verbesserung der Effizienz. Die unkomplizierte Oberfläche erleichtert die Bereitstellung und Verwaltung von Ressourcen und vereinfacht das Management Ihrer OCI-Infrastruktur.

Zielsetzung

Voraussetzungen

Aufgabe 1: Pulumi herunterladen und installieren

Laden Sie Pulumi herunter, und installieren Sie es auf Ihrem System oder Ihrer virtuellen Maschine (VM). Weitere Informationen finden Sie unter Pulumi herunterladen und installieren.

Beispiel: macOS-Benutzer können Pulumi installieren, indem sie den folgenden Befehl ausführen.

brew install pulumi/tap/pulumi

Aufgabe 2: OCI Provider Package für Pulumi installieren

OCI-Provider fungieren als Verbindung zwischen Pulumi-Code und den OCI-Services, die Sie überwachen möchten. Mit OCI-Providern kann Pulumi Ressourcen in Ihrer OCI-Umgebung über Code erstellen, verwalten und konfigurieren.

Um die OCI-Provider für Pulumi zu installieren, gehen Sie zur Befehlszeilenschnittstelle (CLI), und führen Sie den Installationsbefehl aus. In diesem Tutorial verwenden wir Python als Pulumi-Sprache für das Deployment von OCI-Services.

python3 -m pip install pulumi_oci

Informationen zum Installieren von OCI-Providern in anderen Sprachen finden Sie unter OCI-Provider für Pulumi.

Aufgabe 3: Umgebungsvariablen konfigurieren

Richten Sie die erforderlichen Umgebungsvariablen ein, um Pulumi mit Ihrer OCI-Umgebung zu verbinden. Diese Variablen umfassen die Oracle Cloud-ID (OCID) Ihres Mandanten, die Benutzer-OCID, den Fingerprint, die Region und den Pfad zu Ihrem OCI-API-Schlüssel.

Ändern Sie die Werte gemäß der Mandantenkonfigurationsdatei, und führen Sie die folgenden Befehle aus.

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"

Aufgabe 4: Pulumi-Stapel erstellen

Organisieren Sie Ihr Projekt, indem Sie ein Verzeichnis für Ihren Pulumi-Stack erstellen. Initialisieren Sie es mit Ihrer bevorzugten Programmiersprache. Für dieses Tutorial verwenden wir Python-Stack.

  1. Erstellen Sie ein Pulumi-Stackverzeichnis. Um ein neues Verzeichnis für Ihren Pulumi-Stack zu erstellen, führen Sie den folgenden Befehl aus.

    mkdir OCI_Pulumi_Stack && cd OCI_Pulumi_Stack

  2. Initialisieren Sie das Pulumi-Projektprojekt mit einer OCI-Python-Vorlage: pulumi new OCI-python.

  3. Geben Sie die Projektdetails wie Projektname, Beschreibung und Stackname ein (z.B. Entwicklung, Staging, Produkt). In diesem Schritt wird der Setupprozess gestartet, einschließlich Hinzufügen der erforderlichen Abhängigkeiten und Laden von Beispielcode in die Datei main.py.

  4. Prüfen Sie das eingerichtete Codeset, indem Sie den Inhalt des Verzeichnisses OCI_Pulumi_Stack prüfen. Hier finden Sie den Beispielcode und alle zusätzlichen Dateien, die während des Initialisierungsprozesses erstellt wurden.

Aufgabe 5: Pulumi-Stapel anpassen

Passen Sie einen Stack an Ihre spezifischen Anforderungen an. Öffnen Sie die Haupt-Deployment-Datei main.py, und fügen Sie den erforderlichen Code hinzu, um die OCI-Ressourcen zu definieren, die Sie bereitstellen möchten. In diesem Tutorial wird gezeigt, wie Sie die Availability-Domains in Ihrem OCI-Mandanten abrufen.

"""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)

Dieser Code zeigt, wie Sie die Availability-Domains aus Ihrem OCI-Mandanten abrufen und ihre Namen als Ausgabe exportieren. Wenn Sie diesen Code mit Pulumi ausführen, interagiert er mit OCI, um die Availability-Domains abzurufen und ihre Namen als Ausgabe anzuzeigen. Auf diese Weise können Sie sicherstellen, dass Ihr Code die erforderlichen Informationen korrekt aus OCI abruft.

Aufgabe 6: Pulumi-Code in OCI bereitstellen

Führen Sie den folgenden Befehl aus, um Ressourcen in OCI bereitzustellen.

pulumi up

Aufgabe 7: Befehlsausgabe prüfen

Nach dem Deployment führt der Befehl das Pulumi-Programm aus und ruft die Availability-Domains in Ihrem OCI-Mandanten ab, wie im Code definiert.

Pulumi_OCI_Output

Bestätigungen

Weitere Lernressourcen

Lernen Sie andere Übungen auf docs.oracle.com/learn kennen, oder greifen Sie auf weitere kostenlose Lerninhalte im Oracle Learning YouTube Channel zu. Besuchen Sie außerdem education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Produktdokumentation finden Sie im Oracle Help Center.