Oracle Cloud Infrastructure - Dokumentation

Planjob erstellen

Erstellen Sie einen Planjob in Resource Manager.

Beim Erstellen (Ausführen) eines Planjobs wird Ihre 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 die Bereitstellung Ihrer Oracle Cloud Infrastructure-Ressourcen geplant sind, einschließlich Aktionen, die nach der Ausführung eines Apply-Jobs erwartet werden. Es wird empfohlen, einen Planjob auszuführen (einen Ausführungsplan zu generieren), bevor ein Apply-Job ausgeführt wird. 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 beim Suchen der Listenseite oder des Stacks benötigen, lesen Sie 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 von Ressourcen führen. Beispiel: Eine Terraform-Konfiguration, die Hunderte von Compute-Instanzen definiert. Ein Job Anwenden 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.

      Verwenden Sie diese Option, um zuerst den Status zu aktualisieren. Beispiel: Sie können diese Option mit einem Job Anwenden verwenden, 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 Jobs kann der Vorgang einige Zeit in Anspruch nehmen. Während der Ausführung des Jobs oder nach dessen Abschluss können Sie den Inhalt der Joblogs abrufen.