Oracle Cloud Infrastructure - Dokumentation

"Anwenden"-Job erstellen

Erstellen Sie einen "Anwenden"-Job in Resource Manager.

Wenn Sie einen Apply-Job für einen Stack erstellen (ausführen), stellt Terraform die Ressourcen bereit und führt die in Ihrer Terraform-Konfiguration definierten Aktionen aus. Dabei wird der Ausführungsplan auf den zugehörigen Stack angewendet, um Ihre Oracle Cloud Infrastructure-Ressourcen zu erstellen (oder zu ändern). Es wird empfohlen, einen Planjob auszuführen (einen Ausführungsplan zu generieren), bevor Sie einen Apply-Job ausführen.

Einen Ablauf zur Verwendung der CLI für das Cloud-Provisioning in einer CI/CD-Pipeline finden Sie unter IaC in der Cloud: Terraform und Resource Manager in Ihre CI/CD-Pipeline integrieren - Mit der OCI-CLI erstellen.

Bei Konfigurationen, die in einem Quellcode-Control-System wie GitHub oder GitLab gespeichert sind, verwendet der Job den zuletzt festgeschriebenen Wert. Die Zeit für den Abschluss eines "Anwenden"-Jobs hängt von der Anzahl und dem Typ der zu erstellenden Cloud-Ressourcen ab.

    1. Wählen Sie auf der Listenseite Stacks den Stack aus, mit dem Sie arbeiten möchten. Wenn Sie Hilfe bei der Suche nach der Listenseite oder dem Stack benötigen, finden Sie weitere Informationen unter Stacks auflisten.
    2. Wählen Sie auf der Detailseite des Stacks die Option Anwenden.
    3. (Optional) Bearbeiten Sie im Bereich Anwenden den Standardnamen für den Job. Geben Sie dabei keine vertraulichen Informationen ein.
    4. (Optional) Wählen Sie unter Jobplanlösung anwenden den Namen des zuletzt generierten Planjobs aus. Nur der zuletzt generierte Planjob ist verfügbar. Wenn kein Planjob für diesen Stack generiert wurde, ist nur der Standardwert verfügbar (Automatisch genehmigen). Weitere Informationen zur Automatischen Genehmigung finden Sie unter Option "Automatisch genehmigen" für den Terraform Apply-Befehl.
    5. Um die neuesten Versionen abzurufen, die aus der konfigurierten Quelle von Terraform-Providern verfügbar sind, wählen Sie Erweiterte Optionen anzeigen aus, und wählen Sie Providerversionen upgraden aus.
      Der Stack muss Terraform 0.14 oder höher sein. Wenn der Stack älter ist, muss er auf Terraform Registry verwenden upgegradet werden. Dieser Schritt ist erforderlich, wenn Providerversionen in der Terraform-Konfiguration seit der letzten Ausführung eines Jobs im Stack geändert wurden. Abhängigkeitssperrdateien werden automatisch für neue und aktualisierte Stacks verwaltet. Provider werden innerhalb der Versions-Constraints der Terraform-Konfiguration aktualisiert.
    6. Um detaillierten Loginhalt für das Debugging zu generieren, wählen Sie Erweiterte Optionen anzeigen aus, und wählen Sie unter Detaillierte Logebene die gewünschte Logebene aus.
      Weitere Informationen finden Sie unter Terraform debuggen.
    7. Um die maximale Anzahl nebenläufiger Vorgänge anzupassen, während Terraform das Diagramm durchläuft, wählen Sie Erweiterte Optionen anzeigen aus, und bearbeiten Sie den Wert für Maximale Anzahl paralleler Vorgänge. (Standardwert: 10.) Mit dieser Option können Sie den Job beschleunigen.
      Hinweis

      Ein hoher Wert kann zu einer Drosselung der Ressourcen führen. Beispiel: Eine Terraform-Konfiguration, die Hunderte von Compute-Instanzen definiert. Ein Apply-Job versucht, so viele Instanzen wie möglich gleichzeitig zu erstellen. In diesem Beispiel kann ein Wert von 100 zu Throttling durch den Compute-Service führen.
    8. Um den letzten Status vor Ausführung des Jobs abzurufen, wählen Sie Erweiterte Optionen anzeigen aus, und wählen Sie Ressourcenstatus aktualisieren, bevor Sie auf Unterschiede prüfen aus.

      Mit dieser Option können Sie den Status zuerst aktualisieren. Beispiel: Sie verwenden diese Option mit einem Apply-Job, den Sie auf einer manuell aktualisierten (vorhandenen) Infrastruktur ausführen möchten.

      Hinweis

      Das Aktualisieren des Status kann sich auf die Performance auswirken. Wenn die Konfiguration mehrere Ressourcen umfasst, sollten Sie diese Option nicht verwenden.
    9. (Optional) Fügen Sie dem Job mindestens ein Tag hinzu: Wählen Sie Erweiterte Optionen anzeigen aus, um Taggingoptionen anzuzeigen.
      Wenn Sie über Berechtigungen zum Erstellen einer Ressource verfügen, sind Sie auch berechtigt, Freiform-Tags auf diese Ressource anzuwenden. Um ein definiertes Tag anzuwenden, müssen Sie über die Berechtigungen verfügen, den Tag-Namespace zu verwenden. Weitere Informationen zum Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Sie Tags anwenden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
    10. Wählen Sie Anwenden aus.

    Der Apply-Job wird erstellt. Der neue Job wird unter Jobs aufgeführt.

  • Verwenden Sie den Befehl oci resource-manager job create-apply-job und die erforderlichen Parameter, um einen Apply-Job auszuführen.

    oci resource-manager job create-apply-job [OPTIONS]

    Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der Command Line Reference for Resource Manager.

    Beispiele

    Beispiel 1: Einen Planjob referenzieren

    oci resource-manager job create-apply-job --execution-plan-strategy <plan_job_ocid> --stack-id <stack_ocid>

    Beispiel 2: Automatisch genehmigen (keinen Planjob referenzieren).

    oci resource-manager job create-apply-job --execution-plan-strategy AUTO_APPROVED --stack-id <stack_ocid>

  • Verwenden Sie den Vorgang CreateJob, um einen Apply-Job zu erstellen.

    Ein Beispiel für den Teil operation der Anforderung finden Sie unter CreateApplyJobOperationDetails.

Weitere Schritte

Je nach Anzahl und Typ der angegebenen Ressourcen kann ein bestimmter "Anwenden"-Job einige Zeit in Anspruch nehmen.

Rufen Sie nach der Ausführung eines Apply Jobs die Details des Jobs ab, um dessen Status zu prüfen. Sie können optional die Terraform-Statusdatei anzeigen, die Logs anzeigen und das Vorhandensein bereitgestellter Ressourcen bestätigen.

Überwachen Sie den Jobstatus (Lebenszyklusstatus), indem Sie die Jobdetails abrufen. Erfolgreich (SUCCEEDED) gibt an, dass der Job abgeschlossen wurde. Je nach Komplexität des Auftrags kann der Vorgang einige Zeit in Anspruch nehmen. Während der Job ausgeführt wird oder nachdem er abgeschlossen ist, können Sie den Inhalt der Joblogs abrufen.

Um die Terraform-Statusdatei anzuzeigen (zeigt den Status Ihrer Ressourcen an, nachdem der Job ausgeführt wurde), wählen Sie den Namen des Jobs aus, um die Seite Jobdetails anzuzeigen. Wählen Sie dann unter Ressourcen die Option Status anzeigen aus. Wählen Sie optional Änderungen in dieser Version anzeigen aus.

Um die Logs für den Job anzuzeigen, wählen Sie den Job aus, um die Detailseite zu öffnen, und wählen Sie dann unter Ressourcen die Option Logs aus.

Um zu bestätigen, dass die neu bereitgestellten Ressourcen vorhanden sind, prüfen Sie die Ressourcen im Compartment.