Vorhandene Ressourcen importieren

Manchmal verfügen Sie über Cloud-Ressourcen, die manuell oder mit anderen Tools erstellt wurden. Mit Terraform import können Sie diese vorhandenen Ressourcen in die Verwaltung durch Terraform übernehmen.

Das bedeutet, dass Terraform anschließend ihren State nachverfolgt und zukünftige Änderungen über Ihre Konfigurationsdateien angewendet werden können. Dies ist ein wichtiger Schritt bei der Einführung von Infrastructure as Code (IaC) in einer „Brownfield“-Umgebung.

Ein Import ist in mehreren Situationen sinnvoll:

• Vorhandene Infrastruktur migrieren: Ressourcen, die außerhalb von Terraform erstellt wurden, in Ihren IaC-Workflow übernehmen.
• Terraform schrittweise einführen: Mit vorhandenen Ressourcen beginnen, statt alles neu zu erstellen.
• Nach einem State-Verlust wiederherstellen: Terraform wieder mit Ressourcen verknüpfen, wenn Ihre State-Datei verloren gegangen ist (bei einem Remote-State ist dies allerdings selten).

Die grundlegende Struktur des Befehls terraform import ist unkompliziert. Er weist Terraform an, eine vorhandene Ressource bei Ihrem Cloud-Anbieter zu finden und sie in Ihre State-Datei aufzunehmen, wobei sie einem Ressourcenblock in Ihrer Konfiguration zugeordnet wird.

Dafür sind zwei wesentliche Informationen erforderlich: die Terraform-Adresse der Ressource und die ID dieser Ressource beim Cloud-Anbieter.

Die Ressourcenadresse bezeichnet die Art und Weise, wie Terraform eine bestimmte Ressource innerhalb Ihrer Konfiguration identifiziert. Sie folgt dem Muster resource_type.resource_name.

• resource_type: Der Ressourcentyp (z. B. aws_s3_bucket, azurerm_resource_group).
• resource_name: Der lokale Name, den Sie der Ressource in Ihrer Terraform-Konfiguration geben (z. B. my_bucket, web_app).

Diese Adresse muss bereits in Ihren .tf-Dateien vorhanden sein.

Jede Ressource bei einem Cloud-Anbieter (z. B. AWS, Azure oder GCP) besitzt eine eindeutige Kennung, die häufig als ID bezeichnet wird. Sie benötigen diese ID, um Terraform mitzuteilen, *welche* vorhandene Ressource importiert werden soll.

Sie finden diese ID in der Konsole des Cloud-Anbieters, über dessen CLI oder über dessen API. Die ID eines AWS-S3-Buckets ist beispielsweise sein Name, während eine EC2-Instanz eine Instanz-ID wie i-0abcdef1234567890 besitzt.

Wichtiger Schritt: Bevor Sie terraform import ausführen, müssen Sie in Ihren Terraform-Konfigurationsdateien (.tf-Dateien) einen entsprechenden Ressourcenblock definiert haben.

Dieser Block teilt Terraform mit, welchen Ressourcentyp es erwarten soll und über welche Attribute dieser verfügen sollte. Terraform verwendet diese Definition, um das Schema der Ressource während des Imports zu verstehen.

Angenommen, Sie haben einen vorhandenen AWS-S3-Bucket mit dem Namen my-existing-coddykit-bucket-123. Definieren Sie zunächst in Ihrer main.tf einen Ressourcenblock dafür:

Nachdem Sie die HCL-Definition erstellt haben, können Sie den Befehl terraform import ausführen. Ersetzen Sie my-existing-coddykit-bucket-123 durch den tatsächlichen Namen bzw. die tatsächliche ID Ihres vorhandenen Buckets.

Stellen Sie sicher, dass Sie zuvor bereits terraform init in Ihrem Verzeichnis ausgeführt haben!

Nach einem erfolgreichen Import hat Terraform die Ressource zu Ihrer State-Datei hinzugefügt. Sie können dies mit terraform state show überprüfen. Der Befehl zeigt die Attribute der importierten Ressource so an, wie Terraform sie erkennt.

Anschließend müssen Sie unbedingt terraform plan ausführen, um sicherzustellen, dass keine unerwarteten Unterschiede zwischen Ihrer HCL und dem tatsächlichen State der importierten Ressource bestehen.

Sie möchten eine vorhandene AWS-EC2-Instanz in Terraform importieren. Welcher der folgenden Schritte MUSS *vor* der Ausführung des Befehls terraform import abgeschlossen sein?

Sie haben gelernt, wie Sie vorhandene Cloud-Ressourcen mithilfe von terraform import in die Verwaltung durch Terraform übernehmen.

• Definieren Sie zunächst den Ressourcenblock in Ihrer HCL.
• Ermitteln Sie anschließend die Ressourcen-ID des Cloud-Anbieters.
• Führen Sie abschließend terraform import ADDRESS ID aus.
• Führen Sie anschließend immer terraform plan aus, um etwaige Unterschiede abzugleichen.

Dieser leistungsstarke Befehl hilft dabei, die Lücke zwischen manuell verwalteter Infrastruktur und einer vollständig IaC-gesteuerten Umgebung zu schließen.