Exercício – usar arquivos de parâmetro e marcas do Azure Resource Manager

• 8 minutos

Neste exercício, você adiciona marcas para ajudar a organizar e acompanhar seus recursos do Microsoft Azure. Você também usa um arquivo de parâmetro de modelo ARM (Azure Resource Manager) para permitir configurações de parâmetros diferentes para cada implantação.

Este exercício usará a extensão Ferramentas do Azure Resource Manager para Visual Studio Code. É necessário que você instale essa extensão no Visual Studio Code.

Criar uma marca para acompanhar o projeto e o ambiente de implantação de recursos

Primeiro, você cria um parâmetro para usar como uma marca de recurso em seu modelo.

1. No Visual Studio Code, no arquivo azuredeploy.json, coloque o cursor após a chave de fechamento para o parâmetro storageSKU. Adicione uma vírgula e pressione Enter.

2. Digite par. Você verá uma lista de snippets de código relacionados.

3. Selecione arm-param. Lembre-se de que essa ação adiciona um parâmetro genérico ao modelo. É semelhante a este código:

   "parameter1": {
       "type": "string",
       "metadata": {
           "description": "description"
       }
   

4. Altere parameter1 para resourceTags e altere o valor de "type": para object. Lembre-se de que os parâmetros podem ser dos tipos de dados string, secureString, int, bool, object, secureObject e array. Um link para a sintaxe de exemplo para esses tipos de parâmetro está no resumo deste módulo.

5. Adicione um atributo chamado defaultValue: e defina o valor para {"Environment": "Dev", "Project": "Tutorial"}.

   O bloco de parâmetro deve ter aparência semelhante à do seguinte código:

   "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"
           ]
       },
       "resourceTags": {
       "type": "object",
       "defaultValue": {
           "Environment": "Dev",
           "Project": "Tutorial"
           }
       }
   },
   

6. Use esse parâmetro para marcar o recurso de conta de armazenamento. Altere o atributo tags: na definição do recurso:

   "tags": "[parameters('resourceTags')]",
   

7. O seu arquivo deve ter aparência semelhante à deste:

   {
       "$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"
               ]
           },
           "resourceTags": {
           "type": "object",
           "defaultValue": {
               "Environment": "Dev",
               "Project": "Tutorial"
           }
       }
      },
       "functions": [],
       "variables": {
       "uniqueStorageName": "[toLower(concat(parameters('storagePrefix'),uniqueString(resourceGroup().id)))]"
     },
       "resources": [{
           "name": "[variables('uniqueStorageName')]",
           "type": "Microsoft.Storage/storageAccounts",
           "apiVersion": "2019-06-01",
           "tags": "[parameters('resourceTags')]",
           "location": "[resourceGroup().location]",
           "kind": "StorageV2",
           "sku": {
            "name": "[parameters('storageSKU')]"
          }
       }],
       "outputs": {}
   }
   

8. Salve o arquivo.

Implantar o modelo ARM com marcas atualizadas

Verifique se as novas marcas estão na implantação

1. No Azure, selecione o grupo de recursos [nome do grupo de recursos da área restrita] e selecione a conta de armazenamento implantada.

2. Observe o Ambiente : Dev e Project : Tutorial:

   

Usar um arquivo de parâmetro

Atualmente, há três parâmetros para preencher cada vez que você implantar esse modelo. Cada usuário, para guardar os próprios valores de parâmetro, pode criar um arquivo. Aqui, você cria um arquivo de parâmetros para usar com o seu modelo.

1. No Visual Studio Code, crie outro arquivo. Nomeie-o azuredeploy.parameters.dev.json.

2. Nesse arquivo, você adiciona os valores para os parâmetros de modelo que deseja inserir no modelo para o ambiente de desenvolvimento. Altere um valor de marca para ver a implantação fazer uma alteração. Por exemplo, você pode alterar projectName para Learn:

   {
     "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentParameters.json#",
     "contentVersion": "1.0.0.0",
     "parameters": {
       "storagePrefix": {
         "value": "{unique-prefix}"
       },
       "storageSKU": {
         "value": "Standard_LRS"
       },
       "resourceTags": {
         "value": {
           "Environment": "Dev",
           "Project": "Learn"
         }
       }
     }
   }
   

3. Substitua {unique-prefix} pelo seu prefixo exclusivo.

4. Salve o arquivo.

Implantar o modelo com o arquivo de parâmetro

Nesta seção, você implanta o modelo ARM especificando qual arquivo de parâmetro a ser usado.