ARM-templates schrijven

Met ARM-sjablonen kun je Azure-infrastructuur als code definiëren in JSON-indeling. Hierdoor kun je herhaalbare, consistente implementaties uitvoeren en de sjablonen samen met je toepassingscode onder versiebeheer plaatsen. Sjablonen zijn idempotent: als je dezelfde sjabloon meerdere keren uitvoert, krijg je hetzelfde resultaat. Daardoor kun je ze veilig opnieuw toepassen na wijzigingen.

Elke ARM-sjabloon begint met een eigenschap $schema die verwijst naar de URL van het sjabloonschema, gevolgd door een tekenreeks contentVersion. Het schema vertelt de Azure-portal en editoruitbreidingen hoe ze je sjabloon moeten valideren en IntelliSense moeten bieden. De vijf hoofdsecties die volgen zijn parameters, variables, functions, resources en outputs.

Met parameters maak je sjablonen herbruikbaar door tijdens de implementatie invoerwaarden te accepteren. Elke parameter heeft een type (string, int, bool, object, array, secureString), een optionele defaultValue en optionele allowedValues voor validatie. Als je secureString voor wachtwoorden gebruikt, wordt de waarde nooit vastgelegd in de implementatiegeschiedenis.

Variabelen slaan waarden op die zijn berekend op basis van parameters of sjabloonfuncties. Zo verminder je herhaling en worden sjablonen eenvoudiger te onderhouden. Variabelen worden één keer geëvalueerd en in de sectie resources overal verwezen met de expressie [variables('name')]. Een veelgebruikt patroon is het opbouwen van een resourcenaam door een parameter samen te voegen met een uniek achtervoegsel.

De array resources vormt het hart van een ARM-sjabloon. Elk element beschrijft één Azure-resource met verplichte velden: type, apiVersion, name en location. Met apiVersion leg je de schemaversie van de resourceprovider vast. Gebruik altijd een recente stabiele versie om toegang te hebben tot de nieuwste functies en verouderde eigenschappen te vermijden.

Expressies in ARM-sjablonen staan tussen vierkante haakjes [...] en ondersteunen ingebouwde functies voor tekenreeksen, arrays, objecten en resource-id's. Veelgebruikte functies zijn concat(), resourceGroup(), resourceId(), uniqueString() en parameters(). ARM evalueert deze functies tijdens de implementatie aan de serverzijde, niet lokaal.

In de sectie outputs definieer je waarden die ARM na een geslaagde implementatie retourneert. Uitvoerwaarden zijn essentieel voor het koppelen van sjablonen: je implementeert een netwerksjabloon en retourneert de resource-id van het subnet, waarna je die als parameter doorgeeft aan een VM-sjabloon. Uitvoerwaarden kunnen naar elke expressie verwijzen, waaronder resource-eigenschappen uit de implementatie.

Voor complexe architecturen ondersteunt ARM gekoppelde sjablonen (verwijzingen naar externe URL's van sjablonen) en geneste sjablonen (een sjabloon die in de resourcearray is opgenomen met het type Microsoft.Resources/deployments). Zo kun je een grote infrastructuurimplementatie opsplitsen in modulaire, herbruikbare onderdelen, terwijl één orkestratiesjabloon het toegangspunt blijft.

In plaats van parameters op de opdrachtregel door te geven, kun je ze opslaan in een afzonderlijk parameterbestand: een JSON-bestand met een object parameters dat naam-waardeparen bevat. Parameterbestanden kunnen omgevingsspecifiek zijn (bijvoorbeeld dev.parameters.json en prod.parameters.json) en aan bronbeheer worden toegevoegd. Gevoelige waarden blijven daarbij in verwijzingen naar Azure Key Vault staan in plaats van als tekst.

Gebruik de Azure CLI-opdracht az deployment group create om een sjabloon in een resourcegroep te implementeren. Voer vóór een implementatie naar productie az deployment group validate uit om schema- en logische fouten te vinden, en az deployment group what-if om een voorbeeld van de resourcewijzigingen te bekijken. Deze drie opdrachten vormen samen een veilige implementatiepijplijn: valideren, voorbeeld bekijken, implementeren.

Volg deze aanbevolen werkwijzen voor ARM-sjablonen: gebruik parameters voor omgevingsspecifieke waarden, gebruik variabelen om herhaling te voorkomen, leg API-versies vast op stabiele versies, gebruik secureString voor wachtwoorden, voeg metagegevensbeschrijvingen toe aan parameters en splits grote sjablonen op in gekoppelde modules. Sla sjablonen op in een Git-opslagplaats en implementeer ze via een CI/CD-pijplijn voor controleerbaarheid.

In deze les heb je geleerd dat ARM-sjablonen JSON-documenten zijn die Azure-infrastructuur declaratief definiëren, dat parameters en variabelen sjablonen herbruikbaar en onderhoudbaar maken en dat de werkstroom valideren, what-if, implementeren veilige, herhaalbare implementaties mogelijk maakt. Hierna leer je Bicep kennen, een moderne abstractielaag boven ARM JSON.