Tutorial: Exportar e usar modelos do portal do Azure

Nesta série de tutoriais, você cria 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 site. Em vez de criar modelos do zero, você aprenderá a exportar modelos do portal do Azure e como usar modelos de exemplo dos Modelos de Início Rápido do Azure. Você personaliza esses modelos para seu uso. Este tutorial se concentra na exportação de modelos e na personalização do resultado do modelo. Esta instrução leva 14 minutos para ser concluída.

Pré-requisitos

Recomendamos que você conclua o tutorial sobre saídas, mas isso não é necessário.

Você precisa ter o Visual Studio Code e o Azure PowerShell ou a CLI do Azure. Para obter mais informações, consulte as ferramentas de modelo.

Modelo de revisão

No final do tutorial anterior, seu 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": "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]"
    }
  }
}

Esse modelo funciona bem para implantar contas de armazenamento, mas talvez você queira adicionar mais recursos a ele. Você pode exportar um modelo de um recurso existente para obter rapidamente o JSON desse recurso.

Criar plano do Serviço de Aplicativo

Entre no portal do Azure.
Selecione Criar um recurso.
Nos serviços de Pesquisa e no Marketplace, insira o Plano do Serviço de Aplicativo e selecione o Plano do Serviço de Aplicativo.
Selecione Criar.
Na página Criar Plano do Serviço de Aplicativo , insira o seguinte:
- Assinatura: selecione sua assinatura do Azure no menu suspenso.
- Grupo de Recursos: selecione Criar novo e, em seguida, especifique um nome. Forneça um nome de grupo de recursos diferente do que você tem usado 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 o 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. Leva alguns instantes para criar o recurso.

Exportar modelo

Selecione e acesse o recurso.
No menu à esquerda, em Automação, selecione Exportar modelo.

O recurso de modelo de exportação usa o estado atual de um recurso e gera um modelo para implantá-lo. Exportar um modelo pode ser uma maneira útil de obter rapidamente o JSON necessário para implantar um recurso.
Examine a Microsoft.Web/serverfarms definição e a definição de parâmetro no modelo exportado. Você não precisa copiar essas seções. Você pode apenas usar esse modelo exportado como um exemplo de como deseja adicionar esse recurso ao seu modelo.

Importante

Normalmente, o modelo exportado é mais detalhado do que você pode querer ao criar um modelo. O objeto SKU, por exemplo, no modelo exportado tem cinco propriedades. Esse modelo funciona, mas você pode usar apenas a name propriedade. Você pode começar com o modelo exportado e modificá-lo conforme quiser para atender aos seus requisitos.

Revisar o modelo existente

O modelo exportado fornece a maior parte do JSON necessário, mas você precisa personalizá-lo para o modelo. Preste atenção especial às diferenças entre 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 em seu modelo.

O exemplo a seguir mostra as adições ao modelo. Ele contém o código exportado mais algumas alterações. Primeiro, ele altera o nome do parâmetro para corresponder à convenção de nomenclatura. Em segundo lugar, usa seu parâmetro de localização para definir o local do plano de serviço de aplicativo. Em terceiro lugar, ele remove algumas das propriedades em que o valor padrão está bom.

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": "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]"
    }
  }
}

Implantar modelo

Use a CLI do Azure ou o Azure PowerShell para implantar um modelo.

Se você ainda não criou o grupo de recursos, consulte Criar grupo de recursos. O exemplo pressupõe que você definiu a templateFile variável para o caminho para o arquivo de modelo, conforme mostrado no primeiro tutorial.

Azure PowerShell
Azure CLI

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

Para executar esse comando de implantação, você precisa ter a versão mais recente da CLI do Azure.

az deployment group create \
  --name addappserviceplan \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters 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 a 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ê implantou.
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 precisará excluir o grupo de recursos.

Se você estiver parando agora, talvez 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 Filtrar para qualquer campo... texto.
Marque a caixa ao lado de myResourceGroup e selecione myResourceGroup ou o nome do 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 como usar o modelo exportado para o desenvolvimento do modelo. Você também pode usar os Modelos de Início Rápido do Azure para simplificar o desenvolvimento de modelos.

Usar modelos de início rápido do Azure

Comentários

Esta página foi útil?

Last updated on 2025-10-29