Wat is Terraform Import?

Terraform import is een cruciaal commando in de Terraform toolkit. Het stelt gebruikers in staat om bestaande infrastructuur onder Terraform-beheer te brengen, wat essentieel is voor de integratie van Terraform in bestaande omgevingen zonder dat de infrastructuur vanaf nul opnieuw hoeft te worden opgebouwd.

In dit artikel bekijken we de import van Terraform, het belang ervan en hoe u het effectief kunt gebruiken om uw infrastructuurbeheer te automatiseren en de consistentie ervan te verbeteren.

Inzicht in Terraform Import

Met Terraform import kunt u resources die buiten Terraform zijn gecreëerd meenemen en onder beheer brengen. Dit proces omvat het in kaart brengen van de bestaande infrastructuurresources aan corresponderende Terraform-configuraties. Door dit te doen, kan Terraform de staat van deze middelen volgen, inclusief hun attributen en relaties, en ze beheren naast middelen die expliciet zijn gedefinieerd in uw Terraform-code.

Dit proces biedt verschillende voordelen, waaronder:

• Naadloze integratie: Met Terraform import kunt u bestaande infrastructuur integreren in uw Terraform-workflow zonder dat u alles vanaf nul opnieuw hoeft op te bouwen. Dit is vooral nuttig bij het overnemen van bestaande omgevingen of het migreren van workloads naar een nieuw platform. U kunt middelen geleidelijk importeren, waardoor de lopende activiteiten zo min mogelijk worden verstoord.
• Unified management: Eenmaal geïmporteerd, kunnen alle infrastructuurresources worden beheerd via de configuratiebestanden van Terraform. Dit elimineert de noodzaak om te schakelen tussen afzonderlijke tools of handmatige processen voor het beheer van verschillende delen van uw infrastructuur.
• Consistentie: Terraform handhaaft een declaratieve benadering van infrastructuurbeheer. Door bestaande resources te importeren, kunt u ervoor zorgen dat ze allemaal op een consistente manier worden gedefinieerd en beheerd met behulp van Terraform-configuraties. Dit verbetert de onderhoudbaarheid, vermindert fouten en vereenvoudigt wijzigingen in de infrastructuur. Stel u bijvoorbeeld voor dat u een mix van handmatig ingerichte virtuele machines (VM's) en VM's beheert die met Terraform zijn gemaakt. Het importeren van de bestaande VM's zorgt ervoor dat alle VM's consistent worden gedefinieerd, zodat u gebruik kunt maken van Terraform-functies zoals versiebeheer en geautomatiseerde provisioning voor al uw VM's.

Aan de slag met Terraform Import

Met Terraform import kunt u bestaande infrastructuur onder Terraform management brengen zonder dat u resources opnieuw hoeft te creëren. Deze korte tutorial leidt u door het proces van het gebruik van Terraform-import om een bestaande AWS EC2-instantie te beheren. Aan het einde van de handleiding zult u begrijpen hoe u resources in Terraform kunt importeren en deze effectief kunt beheren.

Voorwaarden

Voordat u begint, moet u het volgende hebben:

1. Terraform geïnstalleerd: Download en installeer Terraform vanaf de officiële Terraform-website .
2. AWS CLI geïnstalleerd: Installeer en configureer de AWS CLI met de juiste referenties.
3. Bestaand AWS EC2-exemplaar: Zorg voor een bestaande EC2-instantie die u wilt importeren in Terraform Management.

 

Stap 1: Stel uw Terraform-configuratie in

Maak eerst een map voor uw Terraform-project en navigeer ernaartoe. Maak vervolgens een nieuw bestand aan met de naam main.tf:

$ mkdir terraform-import-tutorial
 $ cd terraform-import-tutorial
 $ touch main.tf

Stap 2: Schrijf de Terraform-configuratie

Definieer in het main.tf-bestand de provider en de resource die u wilt importeren. Voor deze tutorial gebruiken we een AWS EC2-instantie.

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 # The configuration will be filled in after importing the instance.
 }

Stap 3: Terraform initialiseren

Voordat u Terraform gebruikt, moet u uw werkmap initialiseren met de nodige plug-ins:

$ terraform init

Stap 4: De EC2-instance identificeren om te importeren

Zoek de EC2-instantie-ID die u wilt importeren. U kunt dit vinden in de AWS-managementconsole of door de AWS CLI te gebruiken. Laten we bijvoorbeeld aannemen dat de instantie-ID i-1234567890abcdef0 is.

Stap 5: Importeer de EC2-instantie

Gebruik de opdracht terraform import om de bestaande EC2-instantie in Terraform te importeren. Voer de volgende opdracht uit op uw terminal:

$ terraform import aws_instance.example i-1234567890abcdef0

Deze opdracht vertelt Terraform om de resource aws_instance.voorbeeld in uw configuratie te koppelen aan de bestaande EC2-instantie i-1234567890abcdef0.

Stap 6: Controleer de import

Na de import zal Terraform het statusbestand bijwerken met de informatie over de geïmporteerde bron. Uw main.tf-bestand zal echter nog steeds onvolledig zijn. Om de configuratie in te vullen, gebruikt u de opdracht terraform show om de geïmporteerde resource te inspecteren en werkt u main.tf dienovereenkomstig bij:

$ terraform show

U ziet de details van de geïmporteerde resource. Werk main.tf bij zodat het overeenkomt met de werkelijke configuratie van de resource. Hier is een voorbeeld van hoe het eruit zou kunnen zien:

provider "aws" {
 region = "us-west-2"
 }
 resource "aws_instance" "example" {
 ami           = "ami-0c55b159cbfafe1f0"  # Replace with your instance's AMI ID
 instance_type = "t2.micro"                # Replace with your instance type
 key_name      = "my-key-pair"             # Replace with your key pair name
 # Additional attributes as per the `terraform show` output
 }

Stap 7: Configuratiewijzigingen toepassen

Nu uw configuratiebestand de geïmporteerde bron nauwkeurig weergeeft, kunt u het beheren met Terraform. Voer een terraform plan uit om de geplande acties te zien:

$ terraform plan

Als alles er goed uitziet, pas dan de wijzigingen toe:

$ terraform apply

Stap 8: Beheer uw infrastructuur

U kunt uw geïmporteerde resource nu beheren met Terraform. U kunt bijvoorbeeld het instantietype of andere attributen bijwerken op main.tf en de wijzigingen toepassen met terraform zijn van toepassing .

Overwegingen bij het werken met geïmporteerde resources

Hoewel Terraform import een krachtige manier biedt om bestaande infrastructuur te beheren, zijn er enkele belangrijke overwegingen om in gedachten te houden:

• Configuratie-matching: Terraform vertrouwt op zijn configuratie om resources te beheren. Zorg er bij het importeren van een resource voor dat de Terraform-configuratie de kenmerken van de bestaande resource nauwkeurig weergeeft. Elke discrepantie tussen de configuratie en de werkelijke bron kan leiden tot onverwacht gedrag of fouten tijdens het importeren of het daaropvolgende beheer.
• Staatsmanagement: Terraform slaat de staat van uw infrastructuur, inclusief geïmporteerde resources, op in een staatsbestand. Dit bestand is essentieel voor Terraform om resources te volgen en hun levenscyclus te beheren. Zo zorgt u voor een goed staatsbeheer:
  • Beveilig het statusbestand: Het staatsbestand bevat gevoelige informatie over uw infrastructuurbronnen. Implementeer passende beveiligingsmaatregelen om het te beschermen tegen onbevoegde toegang. Overweeg het staatsbestand op een veilige locatie op te slaan, zoals een speciale backend zoals Terraform Cloud of Terraform Enterprise.
  • Regelmatige back-ups: Maak regelmatig een back-up van uw staatsbestand om dataverlies te voorkomen in geval van onbedoelde verwijdering of corruptie. Met een back-up kunt u de status herstellen indien nodig.

Best practices voor het beheer van geïmporteerde resources

Het volgen van deze best practices zorgt ervoor dat u uw geïmporteerde middelen effectief beheert naast de middelen die zijn gedefinieerd in Terraform-code:

1. Verificatie na import: Controleer na een succesvolle import of de attributen van de geïmporteerde resource binnen de Terraform-status overeenkomen met de configuratie van de werkelijke resource. Gebruik de opdracht terraform show om de geïmporteerde resource te inspecteren en te vergelijken met de resourcedetails die zijn verkregen van de console of API van uw cloudprovider.
2. Configuratie-updates: Bronnen kunnen buiten Terraform worden gewijzigd nadat ze zijn geïmporteerd. Het is belangrijk om de Terraform-configuratie bij te werken om eventuele wijzigingen in de attributen van de resource weer te geven. Dit zorgt ervoor dat Terraform een nauwkeurige weergave van uw infrastructuur heeft en stelt u in staat om de resource effectief te beheren met behulp van Terraform.
3. Importdocumentatie: Houd duidelijke documentatie bij voor geïmporteerde resources. Deze documentatie moet het volgende beschrijven:
   • Het type geïmporteerde resource (bijv. AWS EC2-instantie)
   • De identificatiecode van de geïmporteerde bron (bijv. instantie-ID)
   • De stappen die tijdens het importproces worden genomen
   • Alle specifieke overwegingen of opmerkingen met betrekking tot de import    

Conclusie

Terraform import overbrugt de kloof tussen bestaande infrastructuur en de managementkracht van Terraform. Het stelt u in staat om uw gehele infrastructuurstack naadloos te integreren, ongeacht de creatiemethode. Deze uniforme aanpak vermindert de complexiteit, verbetert de zichtbaarheid en stroomlijnt het infrastructuurbeheer.

Naarmate uw infrastructuur evolueert, wordt opslag een cruciale overweging. Ontdek Pure Storage-oplossingen, zoals Portworx® voor gecontaineriseerde workloads en Pure Cloud Block Store™ voor cloudimplementaties, om opslagbeheer naast Terraform te optimaliseren. Deze combinatie zorgt voor een efficiënte, schaalbare infrastructuur voor uw moderne applicaties.