Usare il portale di Azure per esportare un modello

Articolo
05/23/2024

Per facilitare la creazione di modelli di Azure Resource Manager, è possibile esportare un modello da risorse esistenti. Il modello esportato consente di comprendere la sintassi e le proprietà JSON che distribuiscono le risorse. Per automatizzare le distribuzioni future, inizia con il modello esportato e modificalo per lo scenario in uso. Il processo di esportazione modello tenta di creare un modello utilizzabile. Tuttavia, la maggior parte dei modelli esportati richiede alcune modifiche prima di poter essere usati per distribuire le risorse di Azure.

Resource Manager consente di selezionare una o più risorse per l'esportazione in un modello. È possibile concentrarsi esattamente sulle risorse necessarie nel modello.

Questo articolo mostra come esportare modelli tramite il portale. Per altre opzioni, vedere:

Scegli l'opzione di esportazione corretta

Per esportare un modello sono disponibili due modi:

Esportare da un gruppo di risorse o da una risorsa. Questa opzione genera un nuovo modello da risorse esistenti. Il modello esportato è uno "snapshot" dello stato corrente del gruppo di risorse. Puoi esportare un intero gruppo di risorse o risorse specifiche all'interno di tale gruppo di risorse.
Salva dalla cronologia. Questa opzione recupera una copia esatta di un modello usato per la distribuzione. Specifica la distribuzione dalla cronologia di distribuzione.

A seconda dell'opzione scelta, i modelli esportati hanno qualità diverse.

Dal gruppo di risorse o dalla risorsa	Dalla cronologia
Il modello viene generato automaticamente. È probabile che tu voglia migliorare il codice prima di distribuirlo.	Il modello è una copia esatta di quella creata dall'autore del modello. È pronto per essere ridistribuito senza modifiche.
Il modello è uno snapshot dello stato corrente delle risorse. Include tutte le modifiche manuali apportate dopo la distribuzione.	Il modello mostra solo lo stato delle risorse al momento della distribuzione. Tutte le modifiche manuali apportate dopo la distribuzione non sono incluse.
È possibile selezionare quali risorse esportare da un gruppo di risorse.	Sono incluse tutte le risorse per una distribuzione specifica. Non è possibile selezionare un subset di tali risorse o aggiungere risorse che erano state aggiunte in un momento diverso.
Il modello include tutte le proprietà per le risorse, comprese alcune proprietà che normalmente non vengono impostate durante la distribuzione. Potresti voler rimuovere o eliminare queste proprietà prima di riutilizzare il modello.	Il modello include solo le proprietà necessarie per la distribuzione. Il modello è più sparso e più facile da leggere.
Il modello probabilmente non include tutti i parametri necessari per il riutilizzo. La maggior parte dei valori delle proprietà è hardcoded nel modello. Per ridistribuire il modello in altri ambienti, devi aggiungere parametri che aumentano la possibilità di configurare le risorse. Puoi deselezionare Includi parametri in modo da poter creare parametri personalizzati.	Il modello include parametri che semplificano la ridistribuzione in ambienti diversi.

Esportare il modello da un gruppo di risorse o da una risorsa, quando:

È necessario acquisire le modifiche apportate alle risorse dopo la distribuzione originale.
Vuoi selezionare le risorse esportate.
Le risorse non sono state create con un modello.

Esportare il modello dalla cronologia, quando:

Vuoi un modello facile da riutilizzare.
Non è necessario includere le modifiche apportate dopo la distribuzione originale.

Limiti

L'esportazione non garantisce l'esito positivo. L'esportazione non è un modo affidabile per trasformare le risorse preesistenti in modelli utilizzabili nell'ambiente di produzione. È preferibile creare risorse da zero usando un file Bicep scritto a mano,un modello di ARM oTerraform.

Quando si esporta da un gruppo di risorse o da una risorsa, il modello esportato viene generato dagli schemi pubblicati per ogni tipo di risorsa. In alcuni casi, lo schema non ha la versione più recente per un tipo di risorsa. Controlla il modello esportato per assicurarti che includa le proprietà necessarie. Eventualmente modifica il modello esportato per usare la versione dell'API necessaria.

Alcuni parametri password potrebbero non essere presenti nei modelli esportati. È necessario controllare il riferimento al modello e aggiungere manualmente questi parametri prima di poter usare i modelli per distribuire le risorse.

La funzionalità modello di esportazione non supporta l'esportazione delle risorse di Azure Data Factory. Per informazioni su come esportare le risorse di Data Factory, vedi Copiare o clonare una data factory in Azure Data Factory.

Per esportare le risorse create tramite il modello di distribuzione classico, è necessario eseguirne la migrazione al modello di distribuzione Resource Manager.

Se durante l'esportazione di un modello visualizzi un avviso che indica che un tipo di risorsa non è stato esportato, puoi comunque individuare le proprietà per tale risorsa. Per le proprietà delle risorse, vedi informazioni di riferimento sul modello. Puoi anche esaminare l'API REST di Azure per il tipo di risorsa.

Esiste un limite di 200 risorse nel gruppo di risorse per il quale si crea il modello esportato. Se tenti di esportare un gruppo di risorse con più di 200 risorse, viene visualizzato il messaggio di errore Export template is not supported for resource groups more than 200 resources .

Esportare il modello da un gruppo di risorse

Per esportare una o più risorse da un gruppo di risorse:

Selezionare il gruppo di risorse che contiene le risorse da esportare.
Selezionare una o più risorse selezionando le caselle di controllo. Per selezionare tutto, selezionare la casella di controllo a sinistra di Nome. La del menu Esporta modello diventa abilitata solo dopo aver selezionato almeno una risorsa.

Nello screenshot è selezionato solo l'account di archiviazione.
Selezionare Esporta modello.
Il modello esportato viene visualizzato ed è disponibile per il download e la distribuzione.

Includi parametri è selezionato per impostazione predefinita. Se questa opzione è selezionata, tutti i parametri del modello vengono inclusi quando viene generato il modello. Per creare parametri personalizzati, attivare o disattivare questa casella di controllo per non includerli.

Esportare il modello da una risorsa

Per esportare una risorsa:

Selezionare il gruppo di risorse contenente la risorsa da esportare.
Selezionare la risorsa da esportare per aprirla.
Per quella risorsa, selezionare Esporta modello nel riquadro sinistro.
Il modello esportato viene visualizzato ed è disponibile per il download e la distribuzione. Il modello contiene solo la singola risorsa. Includi parametri è selezionato per impostazione predefinita. Se questa opzione è selezionata, tutti i parametri del modello vengono inclusi quando viene generato il modello. Per creare parametri personalizzati, attivare o disattivare questa casella di controllo per non includerli.

Scaricare il modello prima della distribuzione

Il portale permette di scaricare un modello prima di distribuirlo. Questa opzione non è disponibile tramite PowerShell o l'interfaccia della riga di comando di Azure.

Selezionare il servizio di Azure che si vuole distribuire.
Immettere i valori per il nuovo servizio.
Dopo aver superato la convalida, ma prima di avviare la distribuzione, selezionare Scarica un modello per l'automazione.
Il modello viene visualizzato ed è disponibile per il download e la distribuzione.

Esportare il modello dopo la distribuzione

È possibile esportare il modello usato per distribuire le risorse esistenti. Il modello che si ottiene è esattamente quello usato per la distribuzione.

Selezionare il gruppo di risorse da esportare.
Selezionare il collegamento in Distribuzioni.
Selezionare una delle distribuzioni dalla cronologia delle distribuzioni.
Selezionare Modello. Il modello usato viene visualizzato ed è disponibile per il download.

Passaggi successivi

Informazioni su come esportare modelli con l'interfaccia della riga di comando di Azure, Azure PowerShello l'API REST.
Per informazioni sulla sintassi dei modelli di Resource Manager, vedere Comprendere la struttura e la sintassi dei modelli di Azure Resource Manager.
Per informazioni su come sviluppare i modelli, vedi le esercitazioni dettagliate.

Condividi tramite