Tutorial: Usar arquivos de parâmetro para implantar o modelo do Azure Resource Manager

Neste tutorial, você aprenderá a usar arquivos de parâmetros para armazenar os valores passados durante a implantação. Nos tutoriais anteriores, você usou parâmetros embutidos com seu comando de implantação. Essa abordagem funcionou para testar seu modelo do Azure Resource Manager (modelo ARM), mas ao automatizar implantações pode ser mais fácil passar um conjunto de valores para seu ambiente. Os arquivos de parâmetros facilitam o empacotamento de valores de parâmetros para um ambiente específico. Neste tutorial, você cria arquivos de parâmetros para ambientes de desenvolvimento e produção. Esta instrução leva 12 minutos para ser concluída.

Pré-requisitos

Recomendamos que você conclua o tutorial sobre tags, mas não é obrigató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

Seu modelo tem muitos parâmetros que você pode fornecer durante a implantaçã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]"
    },
    "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"
      }
    },
    "resourceTags": {
      "type": "object",
      "defaultValue": {
        "Environment": "Dev",
        "Project": "Tutorial"
      }
    }
  },
  "variables": {
    "uniqueStorageName": "[concat(parameters('storagePrefix'), uniqueString(resourceGroup().id))]",
    "webAppPortalName": "[concat(parameters('webAppName'), uniqueString(resourceGroup().id))]"
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2025-06-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "tags": "[parameters('resourceTags')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    },
    {
      "type": "Microsoft.Web/serverfarms",
      "apiVersion": "2025-03-01",
      "name": "[parameters('appServicePlanName')]",
      "location": "[parameters('location')]",
      "tags": "[parameters('resourceTags')]",
      "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": "2025-03-01",
      "name": "[variables('webAppPortalName')]",
      "location": "[parameters('location')]",
      "dependsOn": [
        "[parameters('appServicePlanName')]"
      ],
      "tags": "[parameters('resourceTags')]",
      "kind": "app",
      "properties": {
        "serverFarmId": "[resourceId('Microsoft.Web/serverfarms', parameters('appServicePlanName'))]",
        "siteConfig": {
          "linuxFxVersion": "[parameters('linuxFxVersion')]"
        }
      }
    }
  ],
  "outputs": {
    "storageEndpoint": {
      "type": "object",
      "value": "[reference(variables('uniqueStorageName')).primaryEndpoints]"
    }
  }
}

Este modelo funciona bem, mas agora você deseja gerenciar facilmente os parâmetros que você passa para o modelo.

Adicionar arquivos de parâmetro

Os arquivos de parâmetro são arquivos JSON com uma estrutura semelhante ao seu modelo. No arquivo, você fornece os valores de parâmetro que deseja passar durante a implantação.

Dentro do arquivo de parâmetros, você fornece valores para os parâmetros em seu modelo. O nome de cada parâmetro em seu arquivo de parâmetros precisa corresponder ao nome de um parâmetro em seu modelo. O nome não distingue maiúsculas de minúsculas, mas para ver facilmente os valores correspondentes, recomenda-se que ajuste as maiúsculas e minúsculas conforme o modelo.

Não é necessário fornecer um valor para cada parâmetro. Se um parâmetro não especificado tiver um valor padrão, esse valor será usado durante a implantação. Se um parâmetro não tiver um valor padrão e não for especificado no arquivo de parâmetro, você será solicitado a fornecer um valor durante a implantação.

Não é possível especificar um nome de parâmetro no arquivo de parâmetros que não corresponda a um nome de parâmetro no modelo. Você recebe um erro quando fornece parâmetros desconhecidos.

No Visual Studio Code, crie um novo arquivo com o seguinte conteúdo. Salve o arquivo com o nome azuredeploy.parameters.dev.json:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "value": "devstore"
    },
    "storageSKU": {
      "value": "Standard_LRS"
    },
    "appServicePlanName": {
      "value": "devplan"
    },
    "webAppName": {
      "value": "devapp"
    },
    "resourceTags": {
      "value": {
        "Environment": "Dev",
        "Project": "Tutorial"
      }
    }
  }
}

Este arquivo é seu arquivo de parâmetros para o ambiente de desenvolvimento. Observe que ele usa Standard_LRS para a conta de armazenamento, nomeia recursos com um prefixo de desenvolvimento e define a Environment tag como Dev.

Novamente, crie um novo arquivo com o seguinte conteúdo. Salve o arquivo com o nome azuredeploy.parameters.prod.json:

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "storagePrefix": {
      "value": "contosodata"
    },
    "storageSKU": {
      "value": "Standard_GRS"
    },
    "appServicePlanName": {
      "value": "contosoplan"
    },
    "webAppName": {
      "value": "contosowebapp"
    },
    "resourceTags": {
      "value": {
        "Environment": "Production",
        "Project": "Tutorial"
      }
    }
  }
}

Este arquivo é seu arquivo de parâmetros para o ambiente de produção. Observe que ele usa Standard_GRS para a conta de armazenamento, nomeia recursos com um prefixo contoso e define a Environment tag como Production. Em um ambiente de produção real, você também gostaria de usar um serviço de aplicativo com um SKU diferente do gratuito, mas usamos esse SKU para este tutorial.

Implementar o modelo

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

Como um teste final do seu modelo, vamos criar dois novos grupos de recursos - um para o ambiente de desenvolvimento e outro para o ambiente de produção.

Para as variáveis de modelo e parâmetro, substitua {path-to-the-template-file}, {path-to-azuredeploy.parameters.dev.json}, {path-to-azuredeploy.parameters.prod.json} e as chaves {} pelos caminhos dos seus arquivos de modelo e parâmetro.

Primeiro, vamos implantar no ambiente de desenvolvimento.

Azure PowerShell
CLI do Azure

$templateFile = "{path-to-the-template-file}"
$parameterFile="{path-to-azuredeploy.parameters.dev.json}"
New-AzResourceGroup `
  -Name myResourceGroupDev `
  -Location "East US"
New-AzResourceGroupDeployment `
  -Name devenvironment `
  -ResourceGroupName myResourceGroupDev `
  -TemplateFile $templateFile `
  -TemplateParameterFile $parameterFile

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

templateFile="{path-to-the-template-file}"
devParameterFile="{path-to-azuredeploy.parameters.dev.json}"
az group create \
  --name myResourceGroupDev \
  --location 'East US'
az deployment group create \
  --name devenvironment \
  --resource-group myResourceGroupDev \
  --template-file $templateFile \
  --parameters $devParameterFile

Agora, implantamos no ambiente de produção.

Azure PowerShell
CLI do Azure

$parameterFile="{path-to-azuredeploy.parameters.prod.json}"
New-AzResourceGroup `
  -Name myResourceGroupProd `
  -Location "West US"
New-AzResourceGroupDeployment `
  -Name prodenvironment `
  -ResourceGroupName myResourceGroupProd `
  -TemplateFile $templateFile `
  -TemplateParameterFile $parameterFile

prodParameterFile="{path-to-azuredeploy.parameters.prod.json}"
az group create \
  --name myResourceGroupProd \
  --location "West US"
az deployment group create \
  --name prodenvironment \
  --resource-group myResourceGroupProd \
  --template-file $templateFile \
  --parameters $prodParameterFile

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 os grupos de recursos do portal do Azure.

Inicie sessão no portal Azure.
No menu à esquerda, selecione Grupos de recursos.
Você verá os dois novos grupos de recursos implantados neste tutorial.
Selecione um grupo de recursos e exiba os recursos implantados. Observe que eles correspondem aos valores especificados no arquivo de parâmetros para esse ambiente.

Limpeza de recursos

No portal do Azure, selecione Grupos de recursos no menu à esquerda.
Marque o nome do grupo de recursos com hiperlink ao lado da caixa de seleção. Se você concluir esta série, terá três grupos de recursos para excluir - myResourceGroup, myResourceGroupDev e myResourceGroupProd.
Selecione o ícone Excluir grupo de recursos no menu superior.

Atenção

A eliminação de um grupo de recursos é irreversível.
Digite o nome do grupo de recursos na janela pop-up exibida e selecione Excluir.

Próximos passos

Parabéns;. Você concluiu esta introdução à implantação de modelos no Azure. Deixe-nos saber se você tem quaisquer comentários e sugestões na seção de feedback.

A próxima série de tutoriais entra em mais detalhes sobre a implantação de modelos.

Implantar um modelo local

Feedback

Esta página foi útil?

Last updated on 2025-10-29