Skrivning af ARM-skabeloner

ARM-skabeloner lader dig definere Azure-infrastruktur som kode i JSON-format. Det giver gentagelige og ensartede implementeringer, som kan versionsstyres sammen med din applikationskode. Skabeloner er idempotente — hvis du kører den samme skabelon flere gange, får du det samme resultat, så det er sikkert at anvende dem igen efter ændringer.

Alle ARM-skabeloner begynder med en egenskab ved navn $schema, der peger på URL'en til skabelonens skema, efterfulgt af en streng med contentVersion. Skemaet fortæller Azure-portalen og editorudvidelser, hvordan skabelonen skal valideres, og giver IntelliSense-understøttelse. De fem hovedsektioner, der følger, er parameters, variables, functions, resources og outputs.

Parametre gør skabeloner genanvendelige ved at acceptere input på implementeringstidspunktet. Hver parameter har en type (string, int, bool, object, array, secureString), en valgfri defaultValue og valgfri allowedValues til validering. Hvis du bruger secureString til adgangskoder, sikrer du, at værdien aldrig logges i implementeringshistorikken.

Variabler gemmer værdier, der beregnes ud fra parametre eller skabelonfunktioner. Det reducerer gentagelser og gør skabeloner nemmere at vedligeholde. Variabler evalueres én gang og refereres til i hele ressourceafsnittet ved hjælp af udtrykket [variables('name')]. Et almindeligt mønster er at opbygge et ressourcenavn ved at sammenkæde en parameter med et entydigt suffiks.

Arrayet resources er kernen i en ARM-skabelon. Hvert element beskriver én Azure-ressource med de obligatoriske felter: type, apiVersion, name og location. apiVersion fastlåser skemaet for ressourceudbyderen til en bestemt version — brug altid en nyere stabil version for at få adgang til de nyeste funktioner og undgå udfasede egenskaber.

Udtryk i ARM-skabeloner er omsluttet af kantede parenteser [...] og understøtter indbyggede funktioner til strenge, arrays, objekter og ressource-id'er. Almindelige funktioner omfatter concat(), resourceGroup(), resourceId(), uniqueString() og parameters(). ARM evaluerer disse funktioner på serversiden på implementeringstidspunktet, ikke lokalt.

Sektionen outputs definerer de værdier, ARM returnerer efter en vellykket implementering. Output er afgørende for at kæde skabeloner sammen — du implementerer en netværksskabelon og sender ressource-id'et for undernettet som output, hvorefter du videregiver det som en parameter til en VM-skabelon. Output kan referere til alle udtryk, herunder ressourceegenskaber fra implementeringen.

Til komplekse arkitekturer understøtter ARM sammenkædede skabeloner (der refererer til eksterne URL'er til skabeloner) og indlejrede skabeloner (der integrerer en skabelon i ressourcernes array ved hjælp af typen Microsoft.Resources/deployments). Det lader dig opdele en stor infrastrukturimplementering i modulære, genanvendelige dele, samtidig med at én orkestreringsskabelon fungerer som indgangspunkt.

I stedet for at angive parametre på kommandolinjen kan du gemme dem i en separat parameterfil — en JSON-fil med et parameters-objekt, der indeholder navn-værdi-par. Parameterfiler kan være miljøspecifikke (f.eks. dev.parameters.json og prod.parameters.json) og gemmes i kildekontrol, mens følsomme værdier opbevares som referencer til Azure Key Vault i stedet for som almindelig tekst.

Brug Azure CLI-kommandoen az deployment group create til at implementere en skabelon i en ressourcegruppe. Før du implementerer i produktion, skal du køre az deployment group validate for at finde skema- og logikfejl og az deployment group what-if for at få vist ændringer i ressourcerne på forhånd. Disse tre kommandoer udgør et sikkert implementeringsflow: valider, forhåndsvis, implementer.

Følg denne bedste praksis for ARM-skabeloner: brug parametre til miljøspecifikke værdier, brug variabler for at undgå gentagelser, fastlås API-versioner til stabile versioner, brug secureString til adgangskoder, tilføj metadatabeskrivelser til parametre, og opdel store skabeloner i sammenkædede moduler. Gem skabeloner i et Git-lager, og implementer dem gennem et CI/CD-flow, så de kan revideres.

I denne lektion har du lært, at ARM-skabeloner er JSON-dokumenter, der deklarativt definerer Azure-infrastruktur, at parametre og variabler gør skabeloner genanvendelige og nemme at vedligeholde, og at arbejdsgangen valider, what-if, implementer muliggør sikre, gentagelige implementeringer. Nu skal vi se på Bicep, en moderne abstraktion oven på ARM JSON.