{"canonical_url":"https://engineer.company/nb/glossary/terraform/","content_markdown":"# Terraform\n\n## Hva det er\n\nTerraform er HashiCorps verktøy for infrastruktur som kode. Du beskriver ressurser i skyen og i eget\ndatasenter i vanlige tekstfiler, holder filene under versjonskontroll, og Terraform regner selv ut\nhvilke ekte objekter som må opprettes, endres eller slettes for at det som kjører, skal stemme med\nfilene. Selve programmet kalles som `terraform`, med små bokstaver, og det er slik navnet står i\nhver kommando og hvert skript.\n\nSpråket er deklarativt. HashiCorps dokumentasjon beskriver det som et språk som angir et mål, og\nikke stegene som fører dit. En konfigurasjon sier at det finnes en maskin av en viss størrelse i et\nvisst nettverk; den lister ikke opp API-kallene som skal til for å lage den. Filene har endelsen\n`.tf`, og det finnes også en JSON-basert variant med endelsen `.tf.json`. Den opprinnelige syntaksen\ner definert ut fra en syntaks som heter HCL, og har to hovedbyggesteiner: en blokk, som er en\nbeholder for annet innhold, og et argument, som gir et navn en verdi.\n\nTre ideer bærer resten av verktøyet.\n\nProvidere er programtillegg. Konfigurasjonen forteller Terraform hvilke programtillegg som skal\ninstalleres, og `terraform init` finner, laster ned og installerer dem. HashiCorp skriver at\nprovidere lar Terraform arbeide med praktisk talt enhver plattform eller tjeneste som har et\ntilgjengelig API, og de offentlig tilgjengelige står i Terraform Registry. En provider definerer\nressurstypene for sin plattform, slik at det samme kjerneprogrammet kan styre en DNS-sone, en\nvirtuell maskin og en overvåkingsregel hos tre ulike leverandører.\n\nModuler er kataloger. En modul er en samling `.tf`- og `.tf.json`-filer som ligger sammen i én\nkatalog, og rotmodulen er arbeidskatalogen der Terraform startes.\n\nTilstand er hukommelse. Terraform holder rede på den ekte infrastrukturen i en tilstandsfil, som\ninnføringen i dokumentasjonen kaller sannhetskilden for miljøet. Filen kobler hver ressurs i\nkonfigurasjonen til det ekte objektet den styrer, sammen med metadata. Som standard er den en lokal\nfil som heter `terraform.tfstate`, og den forrige versjonen ligger ved siden av som\n`terraform.tfstate.backup`.\n\nLisensen er endret. Den 10. august 2023 kunngjorde HashiCorp at kildekoden gikk over fra Mozilla\nPublic License 2.0 til Business Source License 1.1 for alle framtidige utgivelser av produktene,\nmens API-er, SDK-er og nesten alle andre biblioteker blir værende på MPL 2.0. OpenTofu omtaler seg\nselv som en fork av Terraform, startet av Gruntwork, Spacelift, Harness, Env0, Scalr og andre, og\nutviklet under forvaltning av Linux Foundation. Prosjektets repo er publisert under MPL 2.0, og\nnettstedet presenterer OpenTofu som en erstatning for Terraform som beholder eksisterende\narbeidsflyter og konfigurasjoner.\n\n## Hvorfor det er viktig\n\nHashiCorp beskriver kjernearbeidsflyten i tre steg. Write: du definerer ressurser, som kan spenne\nover flere providere og tjenester. Plan: Terraform lager en kjøreplan som beskriver hva det vil\nopprette, oppdatere eller slette. Apply: etter godkjenning utfører Terraform de planlagte\noperasjonene i riktig rekkefølge og tar hensyn til avhengighetene mellom ressursene, som det finner\nved å bygge en ressursgraf.\n\nDet meste av verdien ligger i det midterste steget. En plan er en forhåndsvisning som en person som\nikke skrev endringen, kan lese før noe skjer. Den som går gjennom endringen, ser mer enn forskjellen\nmellom filene, nemlig konsekvensene: to ressurser opprettet, én oppdatert og av og til én slettet\nsom ingen hadde tenkt å røre. Den siste linjen er billig å oppdage i en pull request og svært dyr å\noppdage etterpå.\n\nDen andre grunnen er rekkevidde. Fordi kunnskapen om hver plattform ligger i dens provider, dekker ett språk, én arbeidsflyt og ett sett gjennomgangsvaner alle providerne et team bruker. Et selskap med to skyer og en egen DNS-leverandør kan beskrive alle tre i ett repo og gå gjennom alle tre på samme måte. Bicep fra Microsoft gjør en annen avveining i arbeidsflyten med Azure Resource Manager: det fører ingen egen tilstandsfil, fordi Azure lagrer utrullingstilstanden. Det gjør ikke Bicep til et språk som bare dekker Azure: [utvidelsene](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension) støtter også ressurser utenfor Resource Manager, blant annet Kubernetes og Microsoft Graph.\n\nDen tredje grunnen er tilstanden. Siden Terraform registrerer hvilket ekte objekt som hører til\nhvilken blokk, kan det skille et objekt det styrer fra et det aldri har sett, og det kan\nsammenligne sine opptegnelser med det som kjører. De opptegnelsene er samtidig prisen for\nverktøyet. De må ligge et sted hele teamet når, de trenger en lås så to kjøringer ikke skriver\nsamtidig, og de kan inneholde hemmeligheter, så tilgangen til dem må styres like strengt som til\nhemmelighetene selv.\n\nDet finnes mindre kostnader også. HCL er ett språk til å lære, og hver provider har sine egne\nressurstyper og særheter. Team som bygger et produkt oppå Terraform, har også en lisens å lese:\nHashiCorps lisens-FAQ har et eget spørsmål om hva som regnes som et konkurrerende tilbud. OpenTofu\ntilbyr den samme arbeidsflyten under MPL 2.0.\n\n## Slik ser det ut i praksis\n\nHashiCorps side om ressurssyntaks bruker denne blokken som eksempel:\n\n```hcl\nresource \"aws_instance\" \"web\" {\n  ami           = \"ami-a1b2c3d4\"\n  instance_type = \"t2.micro\"\n}\n```\n\n`resource` er blokktypen, og `aws_instance` er ressurstypen, som AWS-provideren definerer. `\"web\"`\ner det lokale navnet: Terraform bruker den etiketten til å følge ressursen i tilstandsfilen, og den\nhar ingen virkning på innstillingene til den ekte maskinen. De to linjene inne i blokken er\nargumenter.\n\nTre kommandoer tar filen fra tekst til en kjørende maskin:\n\n```sh\nterraform init\nterraform plan -out=tfplan\nterraform apply tfplan\n```\n\n`terraform init` gjør arbeidskatalogen klar: den installerer provider-programtilleggene som\nkonfigurasjonen ber om, og setter opp stedet der tilstanden skal ligge. Den er trygg å kjøre flere\nganger, og dokumentasjonen sier at låsefilen for avhengigheter skal sjekkes inn i versjonskontroll.\n\n`terraform plan -out=tfplan` beregner planen og skriver den til en fil i et ugjennomsiktig format. Planleggingen utfører ikke de foreslåtte infrastrukturendringene. Deretter utfører `terraform apply tfplan` operasjonene i den filen uten å be om bekreftelse, fordi HashiCorp regner det å sende inn en lagret plan som godkjenningen. Av samme grunn blir flagget `-auto-approve` ignorert når en planfil er oppgitt.\n\nI et team faller delingen naturlig. En CI-jobb kjører planen på pull requesten og tar vare på filen,\nen person leser planen i tillegg til forskjellen i filene, og etter sammenslåingen bruker en annen\njobb nettopp den filen, slik at det som kjøres, er det som ble lest. Dokumentasjonen for apply\nlegger til en betingelse som er lett å glemme: sørg for at ingen kan endre infrastrukturen utenom\nTerraform-arbeidsflyten, ellers beskriver planen en verden som allerede har flyttet seg.\n\nHer på nettstedet setter [teknologisiden](/nb/tech-stack/) Terraform ved siden av Ansible: begge\nskriver ned hvordan maskinene skal være, slik at et miljø kan leses i stedet for å måtte\nrekonstrueres. Et oppdrag i porteføljen bruker ideen med et annet verktøy:\n[Azure-infrastrukturen ble satt opp som kode](/nb/portfolio/provisioned-azure-infrastructure-as-code/)\ni Bicep. Miljøene testing, staging og product bygges alle fra ett sett maler, og siden malene tar\nparametere, er et nytt eller endret miljø en pull request. Ved siden av denne artikkelen viser\noppdraget avveiningen fra tidligere. Bicep har ingen egen tilstandsfil fordi Azure selv holder\noversikten, mens Terraform fører sin egen tilstand og til gjengjeld kan brukes på tvers av flere\nskyer.\n\n## Hvor det går galt\n\nDe fleste Terraform-uhell har samme form: konfigurasjonen er gyldig, kjøringen lykkes, og noe ekte\ner borte eller endret.\n\n**En omdøpt ressurs blir slettet.** Endre etiketten `\"web\"` til `\"frontend\"`, og ressursen får en ny\nadresse. HashiCorps veiledning om refaktorering sier at Terraform som standard tolker en endret\nadresse som en instruks om å slette det eksisterende objektet og opprette et nytt. For en maskin\nsom kan kastes, koster det noen minutter; for en database koster det dataene. Løsningen er en\n`moved`-blokk, som oppdaterer adressen uten å slette noe:\n\n```hcl\nmoved {\n  from = aws_instance.web\n  to   = aws_instance.frontend\n}\n```\n\nBehold blokken når den har gjort jobben sin. HashiCorp anbefaler sterkt å beholde gamle\n`moved`-blokker og skriver at det å fjerne en slik blokk er en bakoverinkompatibel endring.\n\n**To personer kjører apply mot hver sin lokale tilstand.** I utgangspunktet er tilstanden til hvert\nworkspace en lokal fil. Det passer for én person på én bærbar maskin. Så snart en kollega kjører\nTerraform fra en annen kopi, er de to tilstandsfilene uenige om hva som finnes, og hver kjøring\nhandler ut fra sin egen versjon. Løsningen er å holde tilstanden i HCP Terraform eller i\nfjernlagring med låsing og tilgangskontroll, slik HashiCorp anbefaler. Terraform låser da\ntilstanden automatisk for hver operasjon som kan skrive til den, og fortsetter ikke hvis låsen ikke\nkan tas. Ikke all lagring støtter låsing, så sjekk det før du velger, og la `-lock=false` være:\nflagget finnes, men dokumentasjonen fraråder det.\n\n**En hengende lås brytes mens noen fortsatt arbeider.** Når den automatiske opplåsingen svikter,\nblir låsen liggende, og kommandoen `force-unlock` frigjør den med lås-ID-en som Terraform skrev ut.\nDokumentasjonen om låsing ber brukeren være svært forsiktig: å bryte en lås som noen andre holder,\nkan gi to skrivere mot samme tilstand, og kommandoen er bare ment for din egen lås etter at den\nautomatiske opplåsingen har sviktet. Løsningen er å finne ut hvem låsen tilhører og om den\nkjøringen fortsatt lever, før noe tvinges.\n\n**Tilstandsfilen lekker hemmeligheter.** HashiCorp advarer om at hemmeligheter kan havne i\ntilstanden, og at de kan bli eksponert hvis tilstanden lagres i et system uten sikker\ntilgangskontroll. En tilstandsfil i en bøtte alle kan lese, eller kopiert inn i en byggeartefakt,\ner en lekkasje av påloggingsdata. Hold den utenfor repoet, gi den samme tilgangskontroll som\nhemmelighetene den inneholder, og rediger den aldri for hånd; kommandoen `terraform state` finnes\nfor de rettelsene som trengs.\n\n**Godkjenningen blir en formalitet.** Flagget `-auto-approve` hopper over den interaktive\ngodkjenningen av planen, og en lagret planfil hopper også over den, fordi filen regnes som\ngodkjenningen. Dokumentasjonen for apply påpeker at dette også gjelder destruktive operasjoner som\nsletting av ressurser. En CI-jobb som kjører apply etter hver sammenslåing uten en gjennomgått\nplan, har fjernet det ene øyeblikket der en person kunne ha sett slettingen komme. Løsningen er\nflyten med lagret plan som er beskrevet ovenfor, med påkrevd gjennomgang av et menneske mellom\nplan-jobben og apply-jobben. Der `-auto-approve` brukes i automatisering, er HashiCorps eget råd å\nkjøre en plan først og gå gjennom den.\n\n## Les mer\n\n- [What is Terraform?](https://developer.hashicorp.com/terraform/intro)\n  — HashiCorps innføring: write, plan, apply, providere og tilstand.\n- [terraform apply command](https://developer.hashicorp.com/terraform/cli/commands/apply)\n  — lagrede planer, `-auto-approve` og kommandoen i automatisering.\n- [State Locking](https://developer.hashicorp.com/terraform/language/state/locking)\n  — automatiske låser, lagring uten låsing og advarselen om `force-unlock`.\n- [Refactor modules](https://developer.hashicorp.com/terraform/language/modules/develop/refactoring)\n  — hvorfor en endret adresse betyr sletting og nyopprettelse, og `moved`-blokken.\n- [HashiCorp adopts Business Source License](https://www.hashicorp.com/en/blog/hashicorp-adopts-business-source-license)\n  — kunngjøringen fra august 2023 om overgangen fra MPL 2.0 til BSL 1.1.\n- [OpenTofu](https://opentofu.org/)\n  — forken av Terraform som utvikles under forvaltning av Linux Foundation.\n\n\u003chttps://engineer.company/nb/glossary/terraform/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hva Terraform er, hvordan write, plan og apply henger sammen, hvorfor tilstandsfilen må låses, og hvordan en omdøping sletter ekte ressurser.","formats":{"gemtext":"https://engineer.company/nb/glossary/terraform/index.gmi","gopher":"https://engineer.company/nb/glossary/terraform/gophermap","html":"https://engineer.company/nb/glossary/terraform/","json":"https://engineer.company/nb/glossary/terraform/index.json","markdown":"https://engineer.company/nb/glossary/terraform/index.md","pdf":"https://engineer.company/nb/glossary/terraform/index.pdf"},"kind":"page","language":"nb","title":"Hva er Terraform?","url":"https://engineer.company/nb/glossary/terraform/","version":1}