Oracle Cloud Infrastructure - Dokumentation

Planjob erstellen

Erstellen Sie einen Planjob in Resource Manager.

Beim Erstellen (Ausführen) eines Planjobs wird die Terraform-Konfiguration geparst und in einen Ausführungsplan für den zugehörigen Stack konvertiert. Im Ausführungsplan ist die Abfolge bestimmter Aktionen aufgeführt, die für das Provisioning Ihrer Oracle Cloud Infrastructure-Ressourcen geplant sind, einschließlich Aktionen, die nach der Ausführung eines "Anwenden"-Jobs erwartet werden. Es wird empfohlen, einen Planjob (Generieren eines Ausführungsplans) auszuführen, bevor Sie einen Apply-Job ausführen. Der Ausführungsplan wird an den Job "Anwenden" übergeben, der dann die Anweisungen ausführt.

Bei Konfigurationen, die in einem Quellcode-Control-System wie GitHub oder GitLab gespeichert sind, verwendet der Job den zuletzt festgeschriebenen Wert.

    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 Planen aus.
    3. (Optional) Bearbeiten Sie im Bereich Plan den Standardnamen für den Job. Geben Sie dabei keine vertraulichen Informationen ein.
    4. 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.
    5. 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.
    6. 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.
    7. 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.
    8. (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.
    9. Wählen Sie Plan aus.

    Der Planjob wurde erstellt. Der neue Job wird unter Jobs aufgeführt.

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

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

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

  • Verwenden Sie den Vorgang CreateJob, um einen Planjob zu erstellen.

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

Weitere Schritte

Ü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.