Esercitazione - Usare i modelli di avvio rapido di Azure
I modelli di avvio rapido di Azure costituiscono un repository di modelli aggiunti come contributo dalla community. È possibile usare i modelli di esempio nello sviluppo del modello. In questa esercitazione si individuerà una definizione di risorsa del sito Web che verrà aggiunta al modello personalizzato. Il completamento di questa esercitazione richiede 12 minuti.
Prerequisiti
È consigliabile, ma non obbligatorio, completare l'esercitazione sui modelli esportati.
È necessario aver installato Visual Studio Code con l'estensione Strumenti di Resource Manager e Azure PowerShell o l'interfaccia della riga di comando di Azure (CLI). Per altre informazioni, vedere gli strumenti per i modelli.
Rivedere il modello
Al termine della precedente esercitazione, il modello includeva il seguente codice JSON:
{
"$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": "2021-09-01",
"name": "[variables('uniqueStorageName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('storageSKU')]"
},
"kind": "StorageV2",
"properties": {
"supportsHttpsTrafficOnly": true
}
},
{
"type": "Microsoft.Web/serverfarms",
"apiVersion": "2021-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]"
}
}
}
Questo modello è adatto per la distribuzione di account di archiviazione e piani di servizio app, ma è possibile che si voglia aggiungere un sito Web. È possibile usare i modelli predefiniti per individuare rapidamente il codice JSON necessario per la distribuzione di una risorsa.
Trovare il modello
Aprire i modelli di avvio rapido di Azure
Selezionare il riquadro con il titolo Deploy a basic Linux web app (Distribuire un'app Web Linux di base). Se non si riesce a trovarlo, ecco il collegamento diretto.
Selezionare Sfoglia su GitHub.
Selezionare azuredeploy.json.
Esaminare il modello. Cercare la risorsa
Microsoft.Web/sites.
Modificare il modello esistente
Unire il modello di avvio rapido con quello esistente:
{
"$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"
},
"webAppName": {
"type": "string",
"metadata": {
"description": "Base name of the resource such as web app name and app service plan "
},
"minLength": 2
},
"linuxFxVersion": {
"type": "string",
"defaultValue": "php|7.0",
"metadata": {
"description": "The Runtime stack of current web app"
}
}
},
"variables": {
"uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]",
"webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"
},
"resources": [
{
"type": "Microsoft.Storage/storageAccounts",
"apiVersion": "2021-09-01",
"name": "[variables('uniqueStorageName')]",
"location": "[parameters('location')]",
"sku": {
"name": "[parameters('storageSKU')]"
},
"kind": "StorageV2",
"properties": {
"supportsHttpsTrafficOnly": true
}
},
{
"type": "Microsoft.Web/serverfarms",
"apiVersion": "2021-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
}
},
{
"type": "Microsoft.Web/sites",
"apiVersion": "2021-03-01",
"name": "[variables('webAppPortalName')]",
"location": "[parameters('location')]",
"dependsOn": [
"[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]"
],
"kind": "app",
"properties": {
"serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
"siteConfig": {
"linuxFxVersion": "[parameters('linuxFxVersion')]"
}
}
}
],
"outputs": {
"storageEndpoint": {
"type": "object",
"value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
}
}
}
Il nome dell'app Web deve essere univoco in Azure. Per impedire la presenza di nomi duplicati, la variabile webAppPortalName viene aggiornata da "webAppPortalName": "[concat(parameters('webAppName'), '-webapp')]" a "webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]".
Aggiungere una virgola alla fine della definizione di Microsoft.Web/serverfarms per separare la definizione della risorsa dalla definizione di Microsoft.Web/sites.
In questa nuova risorsa sono presenti due importanti funzionalità da considerare.
Essa include un elemento denominato dependsOn impostato sul piano di servizio app. Questa impostazione è obbligatoria perché il piano di servizio app deve essere presente prima di creare l'app Web. L'elemento dependsOn indica a Resource Manager come ordinare le risorse per la distribuzione.
La proprietà serverFarmId usa la funzioneresourceId. Questa funzione consente di ottenere l'identificatore univoco per una risorsa. In questo caso, ottiene l'identificatore univoco per il piano di servizio app. L'app Web è associata a un piano di servizio app specifico.
Distribuire un modello
Per distribuire un modello, usare l'interfaccia della riga di comando di Azure o Azure PowerShell.
Se non è stato ancora creato il gruppo di risorse, vedere Creare il gruppo di risorse. Nell'esempio si presuppone che la variabile templateFile sia stata impostata sul percorso del file modello, come illustrato nella prima esercitazione.
New-AzResourceGroupDeployment `
-Name addwebapp `
-ResourceGroupName myResourceGroup `
-TemplateFile $templateFile `
-storagePrefix "store" `
-storageSKU Standard_LRS `
-webAppName demoapp
Nota
Se la distribuzione non viene eseguita, utilizzare l'opzione verbose per ottenere informazioni sulle risorse create. Usare l'opzione debug per ottenere ulteriori informazioni su come eseguire il debug.
Pulire le risorse
Se si intende passare all'esercitazione successiva, non è necessario eliminare il gruppo di risorse.
Se invece ci si ferma, è opportuno eliminare il gruppo di risorse.
- Nel portale di Azure selezionare Gruppi di risorse nel menu a sinistra.
- Digitare il nome del gruppo di risorse nel campo di testo Filtra per qualsiasi campo....
- Spuntare la casella accanto a myResourceGroup e selezionare myResourceGroup o il nome del gruppo di risorse.
- Selezionare Elimina gruppo di risorse nel menu in alto.
Passaggi successivi
È stato illustrato come usare un modello di avvio rapido per lo sviluppo di modelli. Nell'esercitazione successiva si aggiungeranno tag alle risorse.