Condividi tramite


Esercitazione: Esportare e usare i modelli del portale di Azure

In questa serie di esercitazioni viene creato un modello per distribuire un account di archiviazione di Azure. Nelle due esercitazioni successive si aggiunge un piano di servizio app e un sito Web. Invece di creare modelli da zero, si apprenderà come esportare modelli dal portale di Azure e come usare modelli di esempio dai modelli di avvio rapido di Azure. È possibile personalizzare questi modelli per l'uso. Questa esercitazione è incentrata sull'esportazione dei modelli e sulla personalizzazione del risultato per il modello. Il completamento di questa istruzione richiede 14 minuti .

Prerequisiti

È consigliabile completare l'esercitazione sugli output, ma non è obbligatorio.

È necessario avere Visual Studio Code e Azure PowerShell o l'interfaccia della riga di comando di Azure. Per altre informazioni, vedere Strumenti modello.

Rivedere il modello

Alla fine dell'esercitazione precedente, il modello aveva il file JSON seguente:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Questo modello funziona bene per la distribuzione degli account di archiviazione, ma potrebbe essere necessario aggiungervi altre risorse. È possibile esportare un modello da una risorsa esistente per ottenere rapidamente il codice JSON per tale risorsa.

Creare un piano di servizio App

  1. Accedi al portale di Azure.

  2. Seleziona Crea una risorsa.

  3. In Servizi di ricerca e Marketplace immettere Piano di servizio app e quindi selezionare Piano di servizio app.

  4. Fare clic su Crea.

  5. Nella pagina Crea piano di servizio app immettere quanto segue:

    • Sottoscrizione: selezionare la sottoscrizione di Azure dal menu a discesa.
    • Gruppo di risorse: selezionare Crea nuovo e quindi specificare un nome. Specificare un nome di gruppo di risorse diverso da quello usato in questa serie di esercitazioni.
    • Nome: immettere un nome per il piano di servizio app.
    • Sistema operativo: selezionare Linux.
    • Area: selezionare una località di Azure dal menu a discesa, ad esempio Stati Uniti centrali.
    • Livello di Prezzo: per risparmiare sui costi, selezionare Cambia dimensioni per modificare lo SKU e le dimensioni verso Base (B1), sotto Sviluppo/Test per carichi di lavoro meno impegnativi.

    Screenshot della pagina Crea piano servizio app nel portale di Azure.

  6. Seleziona Rivedi e crea.

  7. Fare clic su Crea. La creazione della risorsa richiede alcuni istanti.

Esportare il modello

  1. Selezionare Vai alla risorsa.

    Screenshot del pulsante Vai alla risorsa nel portale di Azure.

  2. Nel menu a sinistra, in Automazione, selezionare Esporta modello.

    Screenshot dell'opzione Esporta modello nel portale di Azure.

    La funzionalità modello di esportazione accetta lo stato corrente di una risorsa e genera un modello per distribuirlo. L'esportazione di un modello può essere utile per ottenere rapidamente il codice JSON necessario per distribuire una risorsa.

  3. Esaminare la Microsoft.Web/serverfarms definizione e la definizione del parametro nel modello esportato. Non è necessario copiare queste sezioni. È sufficiente usare questo modello esportato come esempio di come si vuole aggiungere questa risorsa al modello.

    Screenshot del codice JSON del modello esportato nel portale di Azure.

Importante

In genere, il modello esportato è più dettagliato di quanto si voglia quando si crea un modello. L'oggetto SKU, ad esempio, nel modello esportato ha cinque proprietà. Questo modello funziona, ma è sufficiente usare la name proprietà . È possibile iniziare con il modello esportato e quindi modificarlo in base alle proprie esigenze.

Rivedere il modello esistente

Il modello esportato offre la maggior parte del codice JSON necessario, ma è necessario personalizzarlo per il modello. Prestare particolare attenzione alle differenze nei parametri e nelle variabili tra il modello e il modello esportato. Ovviamente, il processo di esportazione non conosce i parametri e le variabili già definiti nel modello.

L'esempio seguente mostra le aggiunte al modello. Contiene il codice esportato e alcune modifiche. Prima di tutto, modifica il nome del parametro in modo che corrisponda alla convenzione di denominazione. Quindi, usa il parametro location per la località del piano di servizio app. In terzo luogo, rimuove alcune delle proprietà in cui il valore predefinito è corretto.

Copiare l'intero file e sostituire il modello con il relativo contenuto:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "type": "string",
      "minLength": 3,
      "maxLength": 11
    },
    "storageSKU": {
      "type": "string",
      "defaultValue": "Standard_LRS",
      "allowedValues": [
        "Standard_LRS",
        "Standard_GRS",
        "Standard_RAGRS",
        "Standard_ZRS",
        "Premium_LRS",
        "Premium_ZRS",
        "Standard_GZRS",
        "Standard_RAGZRS"
      ]
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "appServicePlanName": {
      "type": "string",
      "defaultValue": "exampleplan"
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "B1",
        "tier": "Basic",
        "size": "B1",
        "family": "B",
        "capacity": 1
      },
      "kind": "linux",
      "properties": {
        "perSiteScaling": false,
        "reserved": true,
        "targetWorkerCount": 0,
        "targetWorkerSizeId": 0
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Distribuire un modello

Usare l'interfaccia della riga di comando di Azure o Azure PowerShell per distribuire un modello.

Se il gruppo di risorse non è stato creato, vedere Creare un gruppo di risorse. L'esempio presuppone che la templateFile variabile sia stata impostata sul percorso del file modello, come illustrato nella prima esercitazione.

New-AzResourceGroupDeployment `
  -Name addappserviceplan `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile `
  -storagePrefix "store" `
  -storageSKU Standard_LRS

Annotazioni

Se la distribuzione non riesce, usare l'opzione verbose per ottenere informazioni sulle risorse che si stanno creando. Usare l'opzione debug per ottenere altre informazioni per il debug.

Verificare la distribuzione

È possibile verificare la distribuzione esplorando il gruppo di risorse dal portale di Azure.

  1. Accedi al portale di Azure.
  2. Nel menu a sinistra selezionare Gruppi di risorse.
  3. Selezionare il gruppo di risorse in cui è stato distribuito.
  4. Il gruppo di risorse contiene un account di archiviazione e un piano di servizio app.

Pulire le risorse

Se si passa all'esercitazione successiva, non è necessario eliminare il gruppo di risorse.

Se ti fermi ora, potresti voler eliminare il gruppo di risorse.

  1. Nel portale di Azure selezionare Gruppi di risorse dal menu a sinistra.
  2. Digitare il nome del gruppo di risorse nel campo di testo Filtra per qualsiasi campo... .
  3. Selezionare la casella accanto a myResourceGroup e selezionare myResourceGroup o il nome del gruppo di risorse.
  4. Selezionare Elimina gruppo di risorse dal menu in alto.

Passaggi successivi

Si è appreso come esportare un modello dal portale di Azure e come usare il modello esportato per lo sviluppo di modelli. È anche possibile usare i modelli di avvio rapido di Azure per semplificare lo sviluppo di modelli.