Azure Portal gebruiken om een sjabloon te exporteren

Artikel
03/22/2024

Als u hulp wilt bij het maken van Azure Resource Manager-sjablonen, kunt u een sjabloon exporteren uit bestaande resources. De geëxporteerde sjabloon helpt u inzicht te krijgen in de JSON-syntaxis en eigenschappen waarmee uw resources worden geïmplementeerd. Als u toekomstige implementaties wilt automatiseren, begint u met de geëxporteerde sjabloon en wijzigt u deze voor uw scenario. Het exportsjabloonproces probeert een bruikbare sjabloon te maken. Voor de meeste geëxporteerde sjablonen zijn echter enkele wijzigingen vereist voordat ze kunnen worden gebruikt voor het implementeren van Azure-resources.

Met Resource Manager kunt u een of meer resources kiezen voor het exporteren naar een sjabloon. U kunt zich richten op precies de resources die u nodig hebt in de sjabloon.

In dit artikel wordt beschreven hoe u sjablonen exporteert via de portal. Zie voor andere opties:

De juiste exportoptie kiezen

Er zijn twee manieren om een sjabloon te exporteren:

Exporteren uit resourcegroep of resource. Met deze optie wordt een nieuwe sjabloon gegenereerd op basis van bestaande resources. De geëxporteerde sjabloon is een momentopname van de huidige status van de resourcegroep. U kunt een hele resourcegroep of specifieke resources binnen die resourcegroep exporteren.
Opslaan vanuit de geschiedenis. Met deze optie wordt een exacte kopie opgehaald van een sjabloon die wordt gebruikt voor implementatie. U geeft de implementatie op uit de implementatiegeschiedenis.

Afhankelijk van de optie die u kiest, hebben de geëxporteerde sjablonen verschillende kwaliteiten.

Van resourcegroep of resource	Uit geschiedenis
Sjabloon wordt automatisch gegenereerd. Waarschijnlijk wilt u de code verbeteren voordat u deze implementeert.	Sjabloon is een exacte kopie van de sjabloon die is gemaakt door de auteur van de sjabloon. Het is klaar om opnieuw te worden geïmplementeerd zonder wijzigingen.
Sjabloon is een momentopname van de huidige status van de resources. Het bevat eventuele handmatige wijzigingen die u na de implementatie hebt aangebracht.	Sjabloon toont alleen de status van resources op het moment van de implementatie. Eventuele handmatige wijzigingen die u na de implementatie hebt aangebracht, zijn niet opgenomen.
U kunt selecteren welke resources u wilt exporteren uit een resourcegroep.	Alle resources voor een specifieke implementatie zijn opgenomen. U kunt geen subset van deze resources kiezen of resources toevoegen die op een ander moment zijn toegevoegd.
Sjabloon bevat alle eigenschappen voor de resources, inclusief enkele eigenschappen die u normaal gesproken niet tijdens de implementatie zou instellen. U kunt deze eigenschappen verwijderen of opschonen voordat u de sjabloon opnieuw kunt gebruiken.	Sjabloon bevat alleen de eigenschappen die nodig zijn voor de implementatie. De sjabloon is meer sparse en gemakkelijker te lezen.
Sjabloon bevat waarschijnlijk niet alle parameters die u nodig hebt voor hergebruik. De meeste eigenschapswaarden zijn vastgelegd in de sjabloon. Als u de sjabloon opnieuw wilt implementeren in andere omgevingen, moet u parameters toevoegen waarmee u de resources kunt configureren. U kunt de selectie Van parameters opnemen opheffen, zodat u uw eigen parameters kunt ontwerpen.	Sjabloon bevat parameters waarmee u eenvoudig opnieuw kunt implementeren in verschillende omgevingen.

Exporteer de sjabloon uit een resourcegroep of resource wanneer:

U moet wijzigingen vastleggen in de resources die zijn aangebracht na de oorspronkelijke implementatie.
U wilt selecteren welke resources worden geëxporteerd.
De resources zijn niet gemaakt met een sjabloon.

Exporteer de sjabloon uit de geschiedenis wanneer:

U wilt een eenvoudig te hergebruiken sjabloon.
U hoeft geen wijzigingen op te nemen die u hebt aangebracht na de oorspronkelijke implementatie.

Beperkingen

Exporteren is niet gegarandeerd geslaagd. Exporteren is geen betrouwbare manier om bestaande resources om te zetten in sjablonen die in productie kunnen worden gebruikt. Het is beter om volledig nieuwe resources te maken met behulp van handgeschreven Bicep-bestand, ARM-sjabloon of terraform.

Wanneer u exporteert vanuit een resourcegroep of resource, wordt de geëxporteerde sjabloon gegenereerd op basis van de gepubliceerde schema's voor elk resourcetype. Af en toe heeft het schema niet de nieuwste versie voor een resourcetype. Controleer de geëxporteerde sjabloon om ervoor te zorgen dat deze de eigenschappen bevat die u nodig hebt. Bewerk indien nodig de geëxporteerde sjabloon om de API-versie te gebruiken die u nodig hebt.

Sommige wachtwoordparameters ontbreken mogelijk in de geëxporteerde sjablonen. U moet de sjabloonreferentie controleren en deze parameters handmatig toevoegen voordat u de sjablonen kunt gebruiken om resources te implementeren.

De exportsjabloonfunctie biedt geen ondersteuning voor het exporteren van Azure Data Factory-resources. Zie Een data factory kopiëren of klonen in Azure Data Factory voor meer informatie over het exporteren van Data Factory-resources.

Als u resources wilt exporteren die zijn gemaakt via het klassieke implementatiemodel, moet u ze migreren naar het Resource Manager-implementatiemodel.

Als u een waarschuwing krijgt bij het exporteren van een sjabloon die aangeeft dat een resourcetype niet is geëxporteerd, kunt u nog steeds de eigenschappen voor die resource detecteren. Zie de sjabloonreferentie voor resource-eigenschappen. U kunt ook de Azure REST API voor het resourcetype bekijken.

Er is een limiet van 200 resources in de resourcegroep waarvoor u de geëxporteerde sjabloon maakt. Als u probeert een resourcegroep met meer dan 200 resources te exporteren, wordt het foutbericht Export template is not supported for resource groups more than 200 resources weergegeven.

Sjabloon exporteren vanuit een resourcegroep

Een of meer resources exporteren uit een resourcegroep:

Selecteer de resourcegroep die de resources bevat die u wilt exporteren.
Selecteer een of meer resources door de selectievakjes in te schakelen. Als u alles wilt selecteren, schakelt u het selectievakje links van Naam in. Het menu-item Sjabloon exporteren wordt pas ingeschakeld nadat u ten minste één resource hebt geselecteerd.

In de schermopname is alleen het opslagaccount geselecteerd.
Selecteer Sjabloon exporteren.
De geëxporteerde sjabloon wordt weergegeven en is beschikbaar om te downloaden en te implementeren.

Parameters opnemen is standaard geselecteerd. Wanneer deze optie is geselecteerd, worden alle sjabloonparameters opgenomen wanneer de sjabloon wordt gegenereerd. Als u uw eigen parameters wilt maken, schakelt u dit selectievakje in om ze niet op te nemen.

Sjabloon exporteren vanuit een resource

Eén resource exporteren:

Selecteer de resourcegroep met de resource die u wilt exporteren.
Selecteer de resource die u wilt exporteren om de resource te openen.
Voor die resource selecteert u De sjabloon Exporteren in het linkerdeelvenster.
De geëxporteerde sjabloon wordt weergegeven en is beschikbaar om te downloaden en te implementeren. De sjabloon bevat alleen de ene resource. Parameters opnemen is standaard geselecteerd. Wanneer deze optie is geselecteerd, worden alle sjabloonparameters opgenomen wanneer de sjabloon wordt gegenereerd. Als u uw eigen parameters wilt maken, schakelt u dit selectievakje in om ze niet op te nemen.

Sjabloon vóór implementatie downloaden

De portal heeft de mogelijkheid om een sjabloon te downloaden voordat deze wordt geïmplementeerd. Deze optie is niet beschikbaar via PowerShell of Azure CLI.

Selecteer de Azure-service die u wilt implementeren.
Vul de waarden voor de nieuwe service in.
Nadat u de validatie hebt doorgegeven, maar voordat u de implementatie start, selecteert u Een sjabloon downloaden voor automatisering.
De sjabloon wordt weergegeven en is beschikbaar voor downloaden en implementeren.

Sjabloon exporteren na implementatie

U kunt de sjabloon exporteren die is gebruikt voor het implementeren van bestaande resources. De sjabloon die u krijgt, is precies de sjabloon die is gebruikt voor implementatie.

Selecteer de resourcegroep die u wilt exporteren.
Selecteer de koppeling onder Implementaties.
Selecteer een van de implementaties in de implementatiegeschiedenis.
Selecteer sjabloon. De sjabloon die voor deze implementatie wordt gebruikt, wordt weergegeven en is beschikbaar voor downloaden.

Volgende stappen

Meer informatie over het exporteren van sjablonen met Azure CLI, Azure PowerShell of REST API.
Zie De structuur en syntaxis van Azure Resource Manager-sjablonen begrijpen voor meer informatie over de syntaxis van de Resource Manager-sjabloon.
Zie de stapsgewijze zelfstudies voor meer informatie over het ontwikkelen van sjablonen.