Oracle Cloud Infrastructure - Dokumentation

Importjob erstellen

Erstellen Sie einen Importjob in Resource Manager, um Statusdateien für vorhandene Ressourcen zu importieren, die bereits von Terraform verwaltet werden. Der Importjob legt die angegebene Terraform-Statusdatei als aktuellen Status des Stacks fest.

Beispiel: Verwenden Sie einen Importjob, um eine lokale Terraform-Umgebung in Resource Manager zu migrieren.

    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. Gehen Sie zu Weitere Aktionen, und wählen Sie Status importieren aus.
    3. (Optional) Bearbeiten Sie im Bereich Importieren den Standardnamen für den Job. Geben Sie dabei keine vertraulichen Informationen ein.
    4. Fügen Sie unter Zu ladende Terraform-Statusdatei auswählen die Terraform-Statusdatei hinzu, die Sie in den Stack importieren möchten.
      Sie können die Datei in das Steuerelement ziehen oder Durchsuchen auswählen und zum Dateispeicherort navigieren.
    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. (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.
    7. Wählen Sie Importieren aus.

    Der Importjob wird erstellt. Der neue Job wird unter Jobs aufgeführt.

  • Verwenden Sie den Befehl oci resource-manager job create-import-tf-state-job und die erforderlichen Parameter, um einen Importjob auszuführen.

    oci resource-manager job create-import-tf-state-job --stack-id <stack_OCID> --tf-state-file <job_details>

    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 Importjob zu erstellen.

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

Weitere Schritte

Rufen Sie nach der Ausführung eines Importjobs die Details des Jobs ab, um dessen Status zu prüfen. Sie können optional die Terraform-Statusdatei anzeigen und die Logs anzeigen.

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