{"canonical_url":"https://engineer.company/nb/glossary/bicep/","content_markdown":"# Bicep\n\n## Hva det er\n\nBicep er et språk fra Microsoft for å skrive ned Azure-infrastruktur som tekst: hvilke ressurser som\nfinnes, hva de heter, hvordan hver av dem er konfigurert, og hvordan de henger sammen. En Bicep-fil\nlister ikke opp steg. Den oppgir sluttresultatet, og Azure Resource Manager, laget\nadministrasjonsforespørsler til Azure går gjennom, finner ut hva som må opprettes, endres eller få være i fred\nfor å komme dit. Den som spør «hva er Bicep?», vil som regel vite om det erstatter klikking gjennom\nAzure-portalen. Det gjør det, og der ligger det meste av verdien.\n\nUnder overflaten er Bicep en vennligere måte å skrive noe Azure allerede forsto. Resource Manager\nhar lenge tatt imot maler for utrulling skrevet i JSON, som er komplette, men tunge å lese og enda\ntyngre å gjennomgå. Under en utrulling gjør kommandolinjeverktøyet for Bicep en `.bicep`-fil om til\nen slik JSON-mal, og Resource Manager ruller den ut nøyaktig slik den ville rullet ut en håndskrevet\nmal. Microsoft oppgir at Bicep støtter hver ressurstype og API-versjon så snart en ressursleverandør\ninnfører den, forhåndsversjoner inkludert, så en ny tjeneste kan tas i bruk uten å vente på at noen\noppdaterer et tillegg. Eksisterende JSON-maler kan dekompileres til Bicep, og det gjør flyttingen av\net eldre oppsett til en mekanisk jobb i stedet for en omskriving.\n\nEn liten fil viser formen. Parameterne kommer først, så ressursene, hver med et symbolsk navn resten\nav filen kan vise til:\n\n```text\nparam env string\nparam location string = resourceGroup().location\n\nresource store 'Microsoft.Storage/storageAccounts@2023-05-01' = {\n  name: 'st${env}${uniqueString(resourceGroup().id)}'\n  location: location\n  sku: {\n    name: 'Standard_LRS'\n  }\n  kind: 'StorageV2'\n}\n```\n\nNår en annen ressurs nevner `store.id`, slutter Bicep seg til at den må vente på lagringskontoen, så\ningen skriver rekkefølgen for hånd, og Resource Manager ruller ut parallelt alt som ikke avhenger av\nnoe annet. En fil kan kalle en annen fil som en modul, og det lar et team beskrive «en database med\nnettverksreglene sine» én gang og bruke den overalt. Verdier som varierer mellom miljøene, ligger i\nen egen `.bicepparam`-fil. Microsoft sier tydelig at Bicep er gratis, har åpen kildekode og ikke er\nment som et generelt programmeringsspråk: det har løkker, betingelser og funksjoner, men bare for å\nbeskrive ressurser.\n\nHvordan står Bicep seg mot alternativene? Mot ARM-JSON er det den samme motoren med langt kortere\nkildekode. Mot Terraform er de viktigste forskjellene rekkevidde og tilstand: Terraform dekker mange\nskyer og fører sin egen tilstandsfil, mens Biceps arbeidsflyt med Azure Resource Manager ikke fører noen egen\ntilstandsfil, fordi Azure lagrer utrullingstilstanden. Biceps [utvidelser](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/bicep-extension)\nstøtter også ressurser utenfor Resource Manager, blant annet Kubernetes og Microsoft Graph. Mot Pulumi, som beskriver infrastruktur i\ngenerelle programmeringsspråk som TypeScript eller Go, bytter Bicep bort fleksibilitet mot et mindre\nspråk som er raskt å lese i en gjennomgang.\n\n## Hvorfor det er viktig\n\nInfrastruktur bygd for hånd har ingen historikk. En innstilling som endres i portalen, etterlater\ningen begrunnelse, ingen ser over den før den skjer, og å bygge opp miljøet igjen etter en dårlig\ndag avhenger av at noen husker hvert klikk. Når infrastrukturen er et sett filer i repoet, får den\ndet applikasjonskoden allerede har: en pull request, en kollega som leser den, en historikk og en\nvei tilbake.\n\nDen andre gevinsten er likhet. Utvikling, staging og produksjon bygd fra de samme filene med ulike\nparametere skiller seg bare der parameterne sier at de skal. Utrullinger med Bicep er idempotente,\nsom med Microsofts ord betyr at den samme filen rullet ut mange ganger gir de samme ressurstypene i\nsamme tilstand. En utrulling er dermed trygg å gjenta, og et nytt miljø er den samme kommandoen\nrettet mot en ny ressursgruppe.\n\nDen tredje er innsyn før endringen. Operasjonen what-if sammenligner en fil med det som kjører, og\nlister opp hver ressurs den ville opprettet, endret eller slettet, før noe blir rørt. Sammen med en\npull request gjør den forhåndsvisningen «jeg tror dette bare endrer brannmurregelen» om til noe den\nsom gjennomgår endringen, kan sjekke.\n\nKostnadene er verdt å nevne. Ressursdekningen avhenger av arbeidsflyten for utrulling og utvidelsene som brukes, så DNS hos en\nannen leverandør eller ressurser i en annen sky kan fortsatt kreve et eget verktøy. I arbeidsflyten\nmed Resource Manager beskriver Bicep Azure-ressurser; pakker og filer inne i en virtuell maskin\nhører hjemme i konfigurasjonsstyring som Ansible. Og det Resource Manager gjør som standard ved sletting og ny\nutrulling, overrasker folk som venter at et verktøy for ønsket tilstand fjerner det filen ikke\nlenger nevner. Det tar delen om hvor det går galt, for seg nedenfor.\n\n## Slik ser det ut i praksis\n\nFlere av Azure-prosjektene på dette nettstedet hviler på Bicep, og tre av dem viser hva det gjør for\net team over tid.\n\nPå én plattform er hele Azure-oppsettet skrevet i Bicep.\n[Hvert miljø kommer ut av de samme malene](/nb/portfolio/provisioned-azure-infrastructure-as-code/):\napi og www kjører som Azure Container Apps, med en PostgreSQL Flexible Server, Redis til caching og\nFront Door med en WAF-policy foran. Nettverket under består av VNet, NSG og privat DNS, Log\nAnalytics samler diagnostikken, og containerbildene kommer fra prosjektets eget Azure Container\nRegistry. Fordi alt er parameterisert, er det å sette opp et nytt miljø eller endre et eksisterende\nen pull request. Siden oppgir resultatet som miljøer som ble reproduserbare og lot seg gjennomgå, og\navvik som sluttet å være et mysterium, fordi koden er sannhetskilden.\n\nDe samme malene bærer utgivelsesveien.\n[Utgivelser går fra utvikling til staging til produksjon](/nb/portfolio/owned-end-to-end-platform-deployments-to-azure/),\nog Bicep holder målinfrastrukturen identisk fra ett miljø til det neste, slik at et bygg aldri føres\nvidere til et miljø som er litt annerledes. Den delen av konfigurasjonen som skiller ett miljø\nfra et annet, ligger atskilt fra hemmelighetene, og det lar én bygd artefakt passere hvert trinn\nuten å bygges på nytt.\n\nOg Bicep holder en del av gjenopprettingsplanen.\n[Oppbevaringstiden for sikkerhetskopier er satt i Bicep ved siden av databasen den beskytter](/nb/portfolio/implemented-backups-and-disaster-recovery-as-code/),\nså gjenoppretting til et valgt tidspunkt følger av malen, i stedet for å være en innstilling noen\nsatte i portalen en gang. Miljøet rundt databasen er også kode, og det betyr noe, fordi å\ngjenopprette data inn i et miljø som må bygges opp igjen etter hukommelsen, knapt er gjenoppretting.\nSiden nevner deretter det som fortsatt står åpent: georedundans er slått av, og målet for\ngjenopprettingstid er foreslått og ikke målt. En mal viser hva som er konfigurert; bare en øvelse\nviser hvor lang tid en gjenoppretting tar.\n\n## Hvor det går galt\n\nDe fleste problemer med Bicep kommer av å vente at det skal oppføre seg som et verktøy som eier alt\ni en ressursgruppe. Som standard eier det bare det filen nevner, og bare på den måten filen sier.\n\n**En innstilling som ble endret i portalen, forsvinner ved neste utrulling.** Når en ressurs rulles\nut på nytt, brukes alle egenskapene dens igjen, og en egenskap malen utelater, settes tilbake til\nstandardverdien. En hasteretting gjort for hånd under en driftshendelse blir angret av neste\nrutinemessige utgivelse. Behandle filen som den fullstendige sluttilstanden for hver ressurs, skriv\nhver verdi som avviker fra standarden, inn i den, og gjør hasteendringer gjennom en pull request.\nInnstillingene for å nekte endringer (deny settings) i en deployment stack kan blokkere redigering\nutenfor utrullingen helt.\n\n**En ressurs som er fjernet fra malen, fortsetter å kjøre og å koste penger.** Standardmodusen for\nutrulling er inkrementell: ressurser i ressursgruppen som filen ikke nevner, får være i fred. Slett\nen database fra koden, og den blir værende i Azure. Microsofts svar er deployment stacks. En stack\nregistrerer ressursene den styrer, og innstillingen `actionOnUnmanage` avgjør om en ressurs som\nfaller ut av filen, kobles fra eller slettes. Komplett modus (complete) sletter også det filen\nutelater, men Microsoft fraråder den og er i ferd med å fase den ut.\n\n**Forhåndsvisningen what-if lister opp endringer ingen har gjort.** En egenskap filen utelater, men\nsom Azure fyller inn med en standardverdi under utrullingen, kan bli rapportert som slettet, og\nMicrosoft kaller dette støy. En egenskap som settes fra funksjonen `reference`, rapporteres som\nendret hver gang, og verdier som `utcNow()` eller en sikker parameter finnes bare under utrullingen,\nså what-if viser dem uevaluert. Kjør den på hver pull request, les den som et utkast, og sett de\nstøyende egenskapene eksplisitt, slik at de virkelige endringene skiller seg ut:\n\n```sh\naz deployment group what-if \\\n  --resource-group rg-staging \\\n  --template-file main.bicep \\\n  --parameters staging.bicepparam\n```\n\n**Et passord dukker opp i utrullingshistorikken.** En vanlig strengparameter blir lagret sammen med\nutrullingen, der alle med lesetilgang til historikken kan se den. Merk hemmelige parametere med\ndekoratøren `@secure()`, som holder verdien utenfor utrullingshistorikken og loggene, og oppbevar\nselve hemmeligheten i Key Vault i stedet for i en parameterfil i repoet.\n\n## Les mer\n\n- [What is Bicep?](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/overview)\n  — Microsofts egen oversikt: språket, fordelene og hva det ikke prøver å være.\n- [Bicep modules](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/modules)\n  — å dele en utrulling opp i filer som kaller hverandre.\n- [Parameters in Bicep files](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/parameters)\n  — typer, dekoratører, standardverdier og hva `@secure()` holder utenfor historikken.\n- [Deployment modes](https://learn.microsoft.com/en-us/azure/azure-resource-manager/templates/deployment-modes)\n  — inkrementell mot komplett, og hva hver av dem gjør med ressurser filen ikke nevner.\n- [Bicep deployment what-if operation](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deploy-what-if)\n  — forhåndsvisning av en utrulling, endringstypene og de kjente kildene til støy.\n- [Deployment stacks](https://learn.microsoft.com/en-us/azure/azure-resource-manager/bicep/deployment-stacks)\n  — å styre ressurser som én enhet, med innstillinger for sletting og for å nekte endringer.\n\n\u003chttps://engineer.company/nb/glossary/bicep/\u003e\n","date_modified":"2026-11-12T05:34:23Z","description":"Bicep skriver Azure-ressurser ned som tekst: hvordan det står seg mot ARM-JSON og Terraform, hvorfor miljøene blir like, og fire vanlige feller.","formats":{"gemtext":"https://engineer.company/nb/glossary/bicep/index.gmi","gopher":"https://engineer.company/nb/glossary/bicep/gophermap","html":"https://engineer.company/nb/glossary/bicep/","json":"https://engineer.company/nb/glossary/bicep/index.json","markdown":"https://engineer.company/nb/glossary/bicep/index.md","pdf":"https://engineer.company/nb/glossary/bicep/index.pdf"},"kind":"page","language":"nb","title":"Hva er Bicep?","url":"https://engineer.company/nb/glossary/bicep/","version":1}