Sjabloonspecificaties begrijpen
U bent nu gewend om Azure Resource Manager-sjablonen (ARM-sjablonen) in Azure te implementeren met behulp van Bicep of JSON. U maakt een sjabloonbestand en verzendt het vervolgens naar Azure door een implementatie te maken. Azure Resource Manager organiseert het maken of opnieuw configureren van uw resources.
Wanneer u met sjabloonspecificaties werkt, verzendt u de sjabloon nog steeds naar Azure. Maar in plaats van deze te implementeren, wordt deze in Azure opgeslagen voor gebruik in de toekomst. Vervolgens kunt u later teruggaan en Azure laten weten dat de sjabloonspecificatie moet worden geïmplementeerd. U kunt zelfs dezelfde sjabloonspecificatie herhaaldelijk gebruiken om meer omgevingen te implementeren.
Waarom sjabloonspecificaties gebruiken?
In uw speelgoedbedrijf hebt u veel herbruikbare sjablonen gemaakt, waaronder:
Sjabloonnaam | Beschrijving |
---|---|
Opslagaccount | Hiermee implementeert u een opslagaccount en dwingt u Microsoft Entra-verificatie af. |
Cosmos DB-account | Hiermee wordt een Azure Cosmos DB-account geïmplementeerd waarvoor continue back-up is ingeschakeld. |
Virtueel netwerk | Hiermee wordt een virtueel netwerk geïmplementeerd dat de juiste configuratie heeft om te peeren met het hoofdhubnetwerk. |
Website voor productlancering | Hiermee wordt een Azure-app Service-plan, app en opslagaccount geïmplementeerd voor websites met productlanceringen van nieuw speelgoed. |
Sjabloonspecificaties zijn een uitstekende manier om een bibliotheek met herbruikbare ARM-sjablonen te maken voor algemene scenario's in uw organisatie. Een expert kan een sjabloon bouwen met een vooraf geconfigureerde resource of set resources. Deze expert kan het vervolgens publiceren als sjabloonspecificatie, zodat andere personen in de organisatie deze kunnen implementeren.
U kunt sjabloonspecificaties gebruiken om ervoor te zorgen dat de resources die uw team maakt, volgens uw vereisten worden geconfigureerd. U kunt bijvoorbeeld een sjabloonspecificatie publiceren zoals de eerder beschreven opslagaccountsjabloon. Wanneer iedereen in uw organisatie vervolgens de sjabloonspecificatie implementeert, kunt u ervoor zorgen dat ze een opslagaccount maken met de juiste verificatie-instellingen.
Sjabloonspecificaties worden opgeslagen in Azure, dus u hoeft zelf geen gedeelde sjabloonbestanden te onderhouden. U beheert wie de sjabloonspecificaties kan gebruiken en wijzigen met op rollen gebaseerd toegangsbeheer van Azure. Zonder sjabloonspecificaties moet u een opslaglocatie, zoals Azure Storage, kiezen om uw sjabloonbestanden te behouden. U moet ook zelf de toegang beheren.
Hoe worden sjabloonspecificaties vergeleken met Bicep-modules?
Wanneer u met Bicep werkt, kunt u herbruikbare modules maken om sets resources in één bestand te definiëren. Sjabloonspecificaties en Bicep-modules zijn beide manieren om herbruikbaarheid toe te voegen aan uw sjablonen, maar ze zijn geoptimaliseerd voor verschillende dingen:
- Sjabloonspecificaties zijn ontworpen om te worden geïmplementeerd als een volledige sjabloon. U kunt sjabloonspecificaties implementeren met behulp van Azure Portal en hulpprogramma's zoals de Azure CLI en Azure PowerShell. Bicep-modules zijn bedoeld om te worden gecombineerd tot een grotere implementatie. Als u echter een sjabloonspecificatie maakt, kunt u deze desgewenst ook gebruiken als module.
- Sjabloonspecificaties bieden mogelijkheden voor versiebeheer en toegangsbeheer. U moet zelf de versies en beveiliging voor uw Bicep-code beheren.
- Sjabloonspecificaties worden als resource opgeslagen in Azure. U moet Bicep-modules ergens opslaan die u kunt beheren, zoals een versiebeheersysteem zoals Git of uw bestandssysteem.
- Bicep-modules behouden alle oorspronkelijke Bicep-code, inclusief opmerkingen, symbolische namen en witruimte. Wanneer u een sjabloonspecificatie maakt met bicep, wordt uw Bicep-code geconverteerd naar JSON en gaan sommige van deze gegevens verloren. U moet dus ook het Bicep-bronbestand ergens anders bewaren.
Wanneer u besluit tussen sjabloonspecificaties en Bicep-modules, is een goede vuistregel: als de sjabloon wordt geïmplementeerd zoals in uw organisatie, zijn sjabloonspecificaties waarschijnlijk geschikt. Maar als u deze sjabloon waarschijnlijk opnieuw wilt gebruiken binnen meerdere bovenliggende sjablonen, kunnen Bicep-modules uw behoeften verbeteren.
Hoe sjabloonspecificaties werken
Een sjabloonspecificatie is een Azure-resource, net als een opslagaccount of virtuele machine. Deze moet worden gemaakt binnen een resourcegroep, hoewel de sjabloon zelf resources kan implementeren in een abonnement, beheer of tenantbereik.
Wanneer u met sjabloonspecificaties werkt, maakt u twee resources:
- De sjabloonspecificatie is de containerresource. Het bevat een of meerdere versies.
- Sjabloonspecificatieversies bevatten de werkelijke sjabloon die moet worden geïmplementeerd.
U werkt met sjabloonspecificaties en -versies met behulp van hun resource-id's. Hier volgt een voorbeeld van een resource-id voor een sjabloonspecificatie:
/subscriptions/f0750bbe-ea75-4ae5-b24d-a92ca601da2c/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS
Een versie is een onderliggende resource van de sjabloonspecificatie. Deze heeft een resource-id zoals in dit voorbeeld:
/subscriptions/f0750bbe-ea75-4ae5-b24d-a92ca601da2c/resourceGroups/SharedTemplates/providers/Microsoft.Resources/templateSpecs/StorageWithoutSAS/versions/1.0
Wanneer u een sjabloonspecificatie implementeert, moet u de resource-id van de sjabloonspecificatieversie opgeven.
Hier volgt een afbeelding van de werkstroom die u volgt wanneer u sjabloonspecificaties gebruikt:
U maakt een sjabloon zoals u gewend bent. Er is niets speciaals aan een sjabloon die u maakt voor een sjabloonspecificatie. U declareert resources, maakt parameters en variabelen, gebruikt functies enzovoort.
Wanneer uw sjabloon gereed is, maakt u een sjabloonspecificatieresource. Vervolgens publiceert u de sjabloon als een versie naar de sjabloonspecificatie. Met de hulpprogramma's die u gebruikt om sjabloonspecificaties te maken, kunt u deze stappen allemaal in één bewerking uitvoeren. De sjabloonspecificatie wordt opgeslagen in Azure als een resource nadat u deze hebt gepubliceerd. U kunt het bekijken, bewerken en de toegang tot de resource beheren, net als elke andere Azure-resource. U kunt de sjabloonspecificatie publiceren vanaf uw lokale computer of vanuit een implementatiepijplijn.
Wanneer u de sjabloonspecificatie wilt implementeren, verwijst u naar de resource-id van de sjabloonspecificatieversie van de implementatie. U kunt deze implementeren in elke resourcegroep of zelfs naar een ander abonnement of een ander bereik. Azure leest de sjabloonspecificatie en gebruikt deze als de sjabloon voor de implementatie.