Partilhar via

Tutorial: Exportar e usar modelos de 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ê adiciona um plano do Serviço de Aplicativo e um site. Em vez de criar modelos do zero, você aprenderá como 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 para seu modelo. Esta instrução leva 14 minutos para ser concluída.

Pré-requisitos

Recomendamos que você conclua o tutorial sobre saídas, mas 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 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]"
    }
  }
}

Este 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 para esse recurso.

Criar plano do Serviço de Aplicativo

  1. Inicie sessão no portal Azure.

  2. Selecione Criar um recurso.

  3. Em Serviços de Pesquisa e Marketplace, insira Plano do Serviço de Aplicativo e selecione Plano do Serviço de Aplicativo.

  4. Selecione Criar.

  5. 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 especifique um nome. Forneça um nome de grupo de recursos diferente daquele 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 uma localização do Azure no menu suspenso, como Estados Unidos - Centro.
    • Nível de preço: para economizar custos, selecione Alterar tamanho para alterar a SKU e o tamanho para primeiro Básico (B1), em Desenvolvimento/Teste para cargas de trabalho menos exigentes.

    Captura de ecrã da página Criar Plano do Serviço de Aplicação no portal do Azure.

  6. Selecione Rever e criar.

  7. Selecione Criar. Leva alguns minutos para criar o recurso.

Exportar modelo

  1. Selecione Ir para recurso.

    Captura de ecrã do botão Ir para o recurso no portal do Azure.

  2. No menu à esquerda, em Automação, selecione Exportar modelo.

    Captura de ecrã da opção Exportar modelo no portal do Azure.

    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.

  3. Observe a Microsoft.Web/serverfarms definição e a definição de parâmetro no modelo exportado. Não é necessário copiar essas seções. Você pode usar esse modelo exportado como um exemplo de como deseja adicionar esse recurso ao seu modelo.

    Captura de ecrã do código JSON do modelo exportado no portal do Azure.

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. Este modelo funciona, mas você pode simplesmente usar a name propriedade. Você pode começar com o modelo exportado e, em seguida, modificá-lo como quiser para atender às suas necessidades.

Revisar modelo existente

O modelo exportado fornece a maior parte do JSON de que você precisa, mas você precisa personalizá-lo para seu modelo. Preste especial atenção às diferenças de parâmetros e variáveis entre o seu modelo e o modelo exportado. Obviamente, o processo de exportação não conhece os parâmetros e variáveis que você já definiu em seu modelo.

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

Copie o arquivo inteiro e substitua seu 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]"
    }
  }
}

Implementar o modelo

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

Se você não criou o grupo de recursos, consulte Criar grupo de recursos. O exemplo pressupõe que você tenha definido a templateFile variável 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 o verbose switch para obter informações sobre os recursos que você está criando. Use o comando debug para obter mais informações para depuração.

Verificar a implementação

Você pode verificar a implantação explorando o grupo de recursos no portal do Azure.

  1. Inicie sessão no portal Azure.
  2. No menu à esquerda, selecione Grupos de recursos.
  3. Selecione o grupo de recursos no qual você implantou.
  4. O grupo de recursos contém uma conta de armazenamento e um Plano do Serviço de Aplicativo.

Limpeza de recursos

Se você estiver passando para o próximo tutorial, não precisará excluir o grupo de recursos.

Se estiveres a parar agora, podes querer eliminar o grupo de recursos.

  1. No portal do Azure, selecione Grupos de recursos no menu à esquerda.
  2. Escreva o nome do grupo de recursos no campo Filtrar por qualquer campo... .
  3. Marque a caixa ao lado de myResourceGroup e selecione myResourceGroup ou o nome do seu grupo de recursos.
  4. Selecione Excluir grupo de recursos no menu superior.

Próximos passos

Você aprendeu como 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

  • Last updated on