Tutorial: Usar o modelo exportado do portal do Azure
Nesta série de tutoriais, você criou um modelo para implantar uma conta de armazenamento do Azure. Nos próximos dois tutoriais, você adicionará um Plano do Serviço de Aplicativo e um website. Em vez de criar modelos do zero, você aprenderá a exportar modelos do portal do Azure e a usar modelos de exemplo dos modelos de Início Rápido do Azure. Você personalizará esses modelos para seu uso. Este tutorial se concentra na exportação de modelos e na personalização do resultado para o modelo. Essa instrução levar cerca de 14 minutos para ser concluída.
Pré-requisitos
Recomendamos que você conclua o tutorial sobre saídas, não sendo, porém, necessário.
É necessário ter o Visual Studio Code com a extensão das Ferramentas do Resource Manager e o Azure PowerShell ou a CLI do Azure. Para obter mais informações, confira Ferramentas de modelo.
Examinar modelo
No final do tutorial anterior, o modelo tinha o seguinte arquivo 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]"
}
},
"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
}
}
],
"outputs": {
"storageEndpoint": {
"type": "object",
"value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
}
}
}
Esse modelo funciona bem para a implantação de contas de armazenamento, mas talvez você queira adicionar mais recursos a ele. Exporte um modelo de um recurso existente para obter rapidamente o JSON desse recurso.
Criar plano de Serviço de Aplicativo
Entre no portal do Azure.
Selecione Criar um recurso.
Em Pesquisar nos serviços e no Marketplace, insira Plano do Serviço de Aplicativo e, em seguida, selecione Plano do Serviço de Aplicativo.
Selecione Criar.
Na página Criar plano do Serviço de Aplicativo, insira o seguinte:
- Assinatura: no menu suspenso, selecione sua assinatura do Azure.
- Grupo de Recursos: Selecione Criar e, em seguida, especifique um nome. Forneça um nome de grupo de recursos diferente daquele que você está usando nesta série de tutoriais.
- Nome: insira um nome para o Plano do Serviço de Aplicativo.
- Sistema Operacional: selecione Linux.
- Região: selecione um local do Azure no menu suspenso, como EUA Central.
- Tipo de preço: para economizar custos, selecione Alterar tamanho para alterar o SKU e o tamanho para o primeiro Básico (B1), em Desenvolvimento/Teste para cargas de trabalho menos exigentes.
Selecione Examinar e criar.
Selecione Criar. São necessários alguns instantes para a criação do recurso.
Exportar modelo
Selecione Ir para o recurso.
No menu esquerdo, em Automação, selecione Exportar modelo.
O recurso Exportar Modelo usa o estado atual de um recurso e gera um modelo para implantá-lo. A exportação de um modelo pode ser uma maneira útil de obter rapidamente o JSON de que você precisa para implantar um recurso.
Examine a definição de
Microsoft.Web/serverfarmse a definição do parâmetro no modelo exportado. Não é necessário copiar essas seções. Você pode simplesmente usar esse modelo exportado como um exemplo de como deseja adicionar esse recurso ao modelo.
Importante
Normalmente, o modelo exportado é mais detalhado do que o esperado ao criar um modelo. O objeto do SKU, por exemplo, no modelo exportado tem cinco propriedades. Esse modelo funciona, mas você pode simplesmente usar a propriedade name. Comece com o modelo exportado e, em seguida, modifique-o como desejar de acordo com suas necessidades.
Revisar o modelo existente
O modelo exportado fornece a maior parte do JSON necessário, mas você precisará personalizá-lo para o modelo. Preste atenção especial nas diferenças em parâmetros e variáveis entre o modelo e o modelo exportado. Obviamente, o processo de exportação não conhece os parâmetros e as variáveis que você já definiu no modelo.
O exemplo a seguir realça as adições ao modelo. Ele contém o código exportado, além de algumas alterações. Primeiro, ele altera o nome do parâmetro para que corresponda à convenção de nomenclatura. Em segundo lugar, ele usa o parâmetro de localização para a localização do Plano do Serviço de Aplicativo. Terceiro, ele remove algumas das propriedades em que o valor padrão está ok.
Copie o arquivo inteiro e substitua o modelo pelo conteúdo.
{
"$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]"
}
}
}
Implantar modelo
Use a CLI do Azure ou o Azure PowerShell para implantar um modelo.
Caso você não tenha criado o grupo de recursos, confira Criar grupo de recursos. O exemplo pressupõe que você tenha definido a variável templateFile como o caminho para o arquivo de modelo, conforme mostrado no primeiro tutorial.
New-AzResourceGroupDeployment `
-Name addappserviceplan `
-ResourceGroupName myResourceGroup `
-TemplateFile $templateFile `
-storagePrefix "store" `
-storageSKU Standard_LRS
Observação
Se a implantação falhar, use a opção verbose para obter informações sobre os recursos que você está criando. Use a opção debug para obter mais informações de depuração.
Verificar implantação
Você pode verificar a implantação explorando o grupo de recursos no portal do Azure.
- Entre no portal do Azure.
- No menu à esquerda, selecione Grupos de recursos.
- Selecione o grupo de recursos no qual você fez a implantação.
- O grupo de recursos contém uma conta de armazenamento e um Plano do Serviço de Aplicativo.
Limpar os recursos
Se você estiver passando para o próximo tutorial, não será necessário excluir o grupo de recursos.
Se estiver parando agora, talvez você queira excluir o grupo de recursos.
- No portal do Azure, selecione Grupos de recursos no menu à esquerda.
- Digite o nome do grupo de recursos no campo de texto Filtro para qualquer campo....
- Marque a caixa ao lado de myResourceGroup e selecione myResourceGroup ou o nome do seu grupo de recursos.
- Escolha Excluir grupo de recursos no menu superior.
Próximas etapas
Você aprendeu a exportar um modelo do portal do Azure e a usar o modelo exportado para o desenvolvimento do modelo. Use também os modelos de Início Rápido do Azure para simplificar o desenvolvimento do modelo.