Importowanie istniejących zasobów

Czasami masz zasoby chmurowe utworzone ręcznie lub przez inne narzędzia. Funkcja import Terraform pozwala objąć te istniejące zasoby zarządzaniem przez Terraform.

Oznacza to, że Terraform będzie śledzić ich stan, a przyszłe zmiany będzie można stosować za pomocą plików konfiguracyjnych. To kluczowy krok w procesie wdrażania Infrastructure as Code (IaC) w środowisku typu „brownfield”.

Importowanie jest przydatne w kilku sytuacjach:

• Migracja istniejącej infrastruktury: Wprowadzanie do procesu IaC zasobów utworzonych poza Terraform.
• Stopniowe wdrażanie Terraform: Rozpoczęcie pracy z istniejącymi zasobami zamiast odtwarzania wszystkiego od podstaw.
• Odzyskiwanie po utracie stanu: Ponowne powiązanie Terraform z zasobami w przypadku utraty pliku stanu (choć przy zdalnym stanie zdarza się to rzadko).

Podstawowa składnia polecenia terraform import jest prosta. Polecenie nakazuje Terraform odnaleźć istniejący zasób u dostawcy chmury i dodać go do pliku stanu, przypisując go do bloku zasobu w konfiguracji.

Wymaga dwóch głównych informacji: Terraform adresu zasobu oraz identyfikatora tego zasobu u dostawcy chmury.

Adres zasobu to sposób, w jaki Terraform identyfikuje konkretny zasób w konfiguracji. Ma on postać resource_type.resource_name.

• resource_type: Typ zasobu (np. aws_s3_bucket, azurerm_resource_group).
• resource_name: Lokalna nazwa nadana zasobowi w konfiguracji Terraform (np. my_bucket, web_app).

Ten adres musi już istnieć w plikach .tf.

Każdy zasób u dostawcy chmury, takiego jak AWS, Azure czy GCP, ma unikalny identyfikator, często nazywany ID. Będziesz potrzebować tego identyfikatora, aby wskazać Terraform, który konkretnie istniejący zasób ma zaimportować.

Identyfikator znajdziesz w konsoli dostawcy chmury, za pomocą jego interfejsu CLI lub przez jego API. Na przykład identyfikatorem zasobnika AWS S3 jest jego nazwa, natomiast instancja EC2 ma identyfikator instancji, taki jak i-0abcdef1234567890.

Kluczowy krok: Przed uruchomieniem terraform import musisz mieć odpowiedni blok zasobu zdefiniowany w plikach konfiguracyjnych Terraform (plikach .tf).

Ten blok informuje Terraform, jakiego typu zasobu należy oczekiwać i jakie powinien mieć atrybuty. Terraform używa tej definicji, aby podczas importu rozpoznać schemat zasobu.

Załóżmy, że masz istniejący zasobnik AWS S3 o nazwie my-existing-coddykit-bucket-123. Najpierw zdefiniuj dla niego blok zasobu w pliku main.tf:

Po zdefiniowaniu HCL możesz uruchomić polecenie terraform import. Zastąp my-existing-coddykit-bucket-123 rzeczywistą nazwą lub identyfikatorem istniejącego zasobnika.

Upewnij się, że w swoim katalogu zostało już uruchomione terraform init!

Po pomyślnym imporcie Terraform doda zasób do pliku stanu. Możesz to zweryfikować za pomocą terraform state show, które wyświetla atrybuty zaimportowanego zasobu widziane przez Terraform.

Następnie koniecznie uruchom terraform plan, aby upewnić się, że między HCL a rzeczywistym stanem zaimportowanego zasobu nie ma nieoczekiwanych różnic.

Chcesz zaimportować istniejącą instancję AWS EC2 do Terraform. Który z poniższych kroków MUSI zostać wykonany przed uruchomieniem polecenia terraform import?

Dowiedziałeś się, jak objąć istniejące zasoby chmurowe zarządzaniem przez Terraform za pomocą terraform import.

• Najpierw zdefiniuj blok zasobu w HCL.
• Następnie określ identyfikator zasobu u dostawcy chmury.
• Na koniec uruchom terraform import ADDRESS ID.
• Zawsze wykonuj potem terraform plan, aby uzgodnić ewentualne różnice.

To potężne polecenie pomaga połączyć ręcznie zarządzaną infrastrukturę z w pełni opartym na IaC środowiskiem.