Skrive ARM-maler

ARM-maler lar Dem definere Azure-infrastruktur som kode i JSON-format. Dette muliggjør repeterbare og konsistente distribusjoner som kan versjonskontrolleres sammen med applikasjonskoden. Maler er idempotente — når den samme malen kjøres flere ganger, gir den samme resultat, slik at det er trygt å bruke den på nytt etter endringer.

Alle ARM-maler starter med egenskapen $schema, som peker til URL-en for malskjemaet, etterfulgt av en contentVersion-streng. Skjemaet forteller Azure-portalen og utvidelser for redigeringsprogrammer hvordan malen skal valideres, og gir støtte for IntelliSense. De fem hoveddelene som følger, er parameters, variables, functions, resources og outputs.

Parametere gjør maler gjenbrukbare ved å ta imot inndata på distribusjonstidspunktet. Hver parameter har en type (string, int, bool, object, array, secureString), en valgfri defaultValue og valgfrie allowedValues for validering. Ved å bruke secureString for passord sikrer De at verdien aldri logges i distribusjonshistorikken.

Variabler lagrer verdier som beregnes fra parametere eller malfunksjoner. Dette reduserer gjentakelser og gjør malene enklere å vedlikeholde. Variabler evalueres én gang og refereres til gjennom hele ressursdelen ved hjelp av uttrykket [variables('name')]. Et vanlig mønster er å bygge et ressursnavn ved å sette sammen en parameter med et unikt suffiks.

resources-matrisen er kjernen i en ARM-mal. Hvert element beskriver én Azure-ressurs med obligatoriske felt: type, apiVersion, name og location. apiVersion fastsetter versjonen av skjemaet for ressursleverandøren — bruk alltid en nyere stabil versjon for å få tilgang til de nyeste funksjonene og unngå utdaterte egenskaper.

Uttrykk i ARM-maler omsluttes av hakeparenteser [...] og støtter innebygde funksjoner for strenger, matriser, objekter og ressurs-ID-er. Vanlige funksjoner omfatter concat(), resourceGroup(), resourceId(), uniqueString() og parameters(). ARM evaluerer disse funksjonene på serversiden ved distribusjonstidspunktet, ikke lokalt.

outputs-delen definerer verdier som ARM returnerer etter en vellykket distribusjon. Outputs er avgjørende for å koble sammen maler — De distribuerer en nettverksmal og returnerer ressurs-ID-en til et subnett, som De deretter sender som parameter til en VM-mal. Outputs kan referere til alle uttrykk, inkludert ressursegenskaper fra distribusjonen.

For komplekse arkitekturer støtter ARM koblede maler (som refererer til eksterne URL-er for maler) og nestede maler (som bygger inn en mal i ressursmatrisen ved å bruke typen Microsoft.Resources/deployments). Dette lar Dem dele opp en stor infrastrukturd distribusjon i modulære, gjenbrukbare deler, samtidig som én orkestreringsmal beholdes som inngangspunkt.

I stedet for å sende parametere på kommandolinjen kan De lagre dem i en separat parameterfil — en JSON-fil med et parameters-objekt som inneholder navn-verdi-par. Parameterfiler kan være miljøspesifikke (for eksempel dev.parameters.json og prod.parameters.json) og legges inn i kildekontroll. Sensitive verdier kan da oppbevares som referanser til Azure Key Vault i stedet for som ren tekst.

Bruk Azure CLI-kommandoen az deployment group create til å distribuere en mal til en ressursgruppe. Før De distribuerer til produksjon, bør De kjøre az deployment group validate for å avdekke feil i skjema og logikk, samt az deployment group what-if for å forhåndsvise ressursendringer. Disse tre kommandoene utgjør en trygg distribusjonsprosess: valider, forhåndsvis, distribuer.

Følg denne beste praksisen for ARM-maler: bruk parametere for miljøspesifikke verdier, bruk variabler for å unngå gjentakelser, fastsett API-versjoner til stabile versjoner, bruk secureString for passord, legg til metadatabeskrivelser for parametere, og del opp store maler i koblede moduler. Lagre malene i et Git-repositorium og distribuer dem gjennom en CI/CD-pipeline for å sikre sporbarhet.

I denne leksjonen lærte De at ARM-maler er JSON-dokumenter som deklarativt definerer Azure-infrastruktur, at parametere og variabler gjør maler gjenbrukbare og enklere å vedlikeholde, og at arbeidsflyten valider, what-if, distribuer muliggjør trygge og repeterbare distribusjoner. Neste tema er Bicep, et moderne abstraksjonslag over ARM JSON.