Använda Azure-portalen för att exportera en mall

  • Artikel

För att hjälpa dig att skapa Azure Resource Manager-mallar kan du exportera en mall från befintliga resurser. Den exporterade mallen hjälper dig att förstå JSON-syntaxen och egenskaperna som distribuerar dina resurser. Om du vill automatisera framtida distributioner börjar du med den exporterade mallen och ändrar den för ditt scenario. Exportmallen försöker skapa en användbar mall. De flesta exporterade mallar kräver dock vissa ändringar innan de kan användas för att distribuera Azure-resurser.

Med Resource Manager kan du välja en eller flera resurser för att exportera till en mall. Du kan fokusera på exakt de resurser du behöver i mallen.

Den här artikeln visar hur du exporterar mallar via portalen. Andra alternativ finns i:

Välj rätt exportalternativ

Det finns två sätt att exportera en mall:

  • Exportera från resursgrupp eller resurs. Det här alternativet genererar en ny mall från befintliga resurser. Den exporterade mallen är en "ögonblicksbild" av resursgruppens aktuella tillstånd. Du kan exportera en hel resursgrupp eller specifika resurser inom den resursgruppen.

  • Spara från historiken. Det här alternativet hämtar en exakt kopia av en mall som används för distribution. Du anger distributionen från distributionshistoriken.

Beroende på vilket alternativ du väljer har de exporterade mallarna olika egenskaper.

Från resursgrupp eller resurs Från historik
Mallen genereras automatiskt. Du vill förmodligen förbättra koden innan du distribuerar den. Mallen är en exakt kopia av den som skapats av mallförfattaren. Den är redo att distribueras om utan några ändringar.
Mallen är en ögonblicksbild av resursernas aktuella tillstånd. Den innehåller alla manuella ändringar som du har gjort efter distributionen. Mallen visar endast tillståndet för resurser vid tidpunkten för distributionen. Eventuella manuella ändringar som du har gjort efter distributionen ingår inte.
Du kan välja vilka resurser från en resursgrupp som ska exporteras. Alla resurser för en viss distribution ingår. Du kan inte välja en delmängd av dessa resurser eller lägga till resurser som lades till vid en annan tidpunkt.
Mallen innehåller alla egenskaper för resurserna, inklusive vissa egenskaper som du normalt inte skulle ange under distributionen. Du kanske vill ta bort eller rensa dessa egenskaper innan du återanvänder mallen igen. Mallen innehåller endast de egenskaper som behövs för distributionen. Mallen är mer gles och lättare att läsa.
Mallen innehåller förmodligen inte alla parametrar som du behöver för återanvändning. De flesta egenskapsvärden är hårdkodade i mallen. Om du vill distribuera om mallen i andra miljöer måste du lägga till parametrar som ökar möjligheten att konfigurera resurserna. Du kan avmarkera Inkludera parametrar så att du kan skapa egna parametrar. Mallen innehåller parametrar som gör det enkelt att distribuera om i olika miljöer.

Exportera mallen från en resursgrupp eller resurs när:

  • Du måste samla in ändringar i de resurser som gjordes efter den ursprungliga distributionen.
  • Du vill välja vilka resurser som ska exporteras.
  • Resurserna skapades inte med en mall.

Exportera mallen från historiken när:

  • Du vill ha en lättanvänd mall.
  • Du behöver inte inkludera ändringar som du gjorde efter den ursprungliga distributionen.

Begränsningar

Exporten är inte garanterad att lyckas. Export är inte ett tillförlitligt sätt att omvandla befintliga resurser till mallar som kan användas i produktion. Det är bättre att skapa resurser från grunden med hjälp av handskriven Bicep-fil, ARM-mall eller terraform.

När du exporterar från en resursgrupp eller resurs genereras den exporterade mallen från de publicerade schemana för varje resurstyp. Ibland har schemat inte den senaste versionen för en resurstyp. Kontrollera den exporterade mallen för att se till att den innehåller de egenskaper du behöver. Om det behövs redigerar du den exporterade mallen för att använda den API-version som du behöver.

Vissa lösenordsparametrar kanske saknas i de exporterade mallarna. Du måste kontrollera mallreferensen och lägga till dessa parametrar manuellt innan du kan använda mallarna för att distribuera resurser.

Funktionen exportmall stöder inte export av Azure Data Factory-resurser. Mer information om hur du kan exportera Data Factory-resurser finns i Kopiera eller klona en datafabrik i Azure Data Factory.

Om du vill exportera resurser som skapats via den klassiska distributionsmodellen måste du migrera dem till Resource Manager-distributionsmodellen.

Om du får en varning när du exporterar en mall som anger att en resurstyp inte har exporterats kan du fortfarande identifiera egenskaperna för den resursen. Information om resursegenskaper finns i mallreferens. Du kan också titta på Azure REST API för resurstypen.

Det finns en gräns på 200 resurser i resursgruppen som du skapar den exporterade mallen för. Om du försöker exportera en resursgrupp som har fler än 200 resurser visas felmeddelandet Export template is not supported for resource groups more than 200 resources .

Exportera en mall från en resursgrupp

Så här exporterar du en eller flera resurser från en resursgrupp:

  1. Välj den resursgrupp som innehåller de resurser som du vill exportera.

  2. Markera en eller flera resurser genom att markera kryssrutorna. Markera alla genom att markera kryssrutan till vänster om Namn. Menyalternativet Exportera mall aktiveras bara när du har valt minst en resurs.

    Skärmbild av att välja alla resurser för export i Azure-portalen.

    På skärmbilden är endast lagringskontot valt.

  3. Välj Exportera mall.

  4. Den exporterade mallen visas och kan laddas ned och distribueras.

    Skärmbild av den exporterade mallen som visas i Azure-portalen.

    Ta med parametrar är markerat som standard. När du väljer inkluderas alla mallparametrar när mallen genereras. Om du vill skapa egna parametrar kan du växla den här kryssrutan så att den inte innehåller dem.

Exportera mall från en resurs

Så här exporterar du en resurs:

  1. Välj den resursgrupp som innehåller den resurs som du vill exportera.

  2. Välj den resurs som du vill exportera för att öppna resursen.

  3. För den resursen väljer du Exportera mall i den vänstra rutan.

    Skärmbild av export av en enskild resurs i Azure-portalen.

  4. Den exporterade mallen visas och kan laddas ned och distribueras. Mallen innehåller bara den enskilda resursen. Ta med parametrar är markerat som standard. När du väljer inkluderas alla mallparametrar när mallen genereras. Om du vill skapa egna parametrar kan du växla den här kryssrutan så att den inte innehåller dem.

Ladda ned mall före distribution

Portalen har möjlighet att ladda ned en mall innan den distribueras. Det här alternativet är inte tillgängligt via PowerShell eller Azure CLI.

  1. Välj den Azure-tjänst som du vill distribuera.

  2. Fyll i värdena för den nya tjänsten.

  3. När valideringen har slutförts väljer du Ladda ned en mall för automatisering innan du påbörjar distributionen.

    Skärmbild av alternativet att ladda ned en mall före distribution i Azure-portalen.

  4. Mallen visas och är tillgänglig för nedladdning och distribution.

Exportera mall efter distribution

Du kan exportera mallen som användes för att distribuera befintliga resurser. Mallen du får är exakt den som användes för distributionen.

  1. Välj den resursgrupp som du vill exportera.

  2. Välj länken under Distributioner.

    Skärmbild av hur du väljer distributionshistorik i Azure-portalen.

  3. Välj en av distributionerna från distributionshistoriken.

    Skärmbild av att välja en specifik distribution från distributionshistoriken i Azure-portalen.

  4. Välj Mall. Mallen som används för den här distributionen visas och är tillgänglig för nedladdning.

    Skärmbild av att välja den mall som används för en specifik distribution i Azure-portalen.

Nästa steg