Övning – Använda Azure Resource Manager-taggar och parameterfiler

8 minuter

I den här övningen lägger du till taggar för att organisera och spåra dina Microsoft Azure-resurser. Du använder också en AZURE Resource Manager-mallparameterfil (ARM) för att tillåta olika parameterkonfigurationer för varje distribution.

Den här övningen använder Azure Resource Manager Tools för Visual Studio Code. Se till att installera det här tillägget i Visual Studio Code.

Skapa en tagg för att spåra resursdistributionsmiljön och projektet

Först skapar du en parameter som ska användas som en resurstagg i mallen.

I Visual Studio Code i filen azuredeploy.json placerar du markören efter den avslutande klammerparentesen för parametern storageSKU. Lägg till ett kommatecken och tryck på Retur.
Skriv par. Du ser en lista över relaterade kodfragment.
Välj arm-param. Kom ihåg att den här åtgärden lägger till en allmän parameter i mallen. Det ser ut som den här koden:
```
"parameter1": {
    "type": "string",
    "metadata": {
        "description": "description"
    }
```
Ändra parameter1 till resursetiketter och ändra värdet för "type": till objektet. Kom ihåg att parametrar kan ha datatyperna string, secureString, int, bool, object, secureObject och array. En länk till exempelsyntaxen för dessa parametertyper finns i sammanfattningen av den här modulen.

Lägg till ett attribut med namnet defaultValue: och ange värdet till {"Environment": "Dev", "Project": "Tutorial"}.

Parameterblocket bör se ut så här:

"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"
        }
    }
},

Använd den här parametern för att tagga lagringskontoresursen. Ändra attributet tags: i resursdefinitionen:
```
"tags": "[parameters('resourceTags')]",
```

Filen bör se ut så här:

{
    "$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": {}
}

Spara filen.

Distribuera ARM-mallen med uppdaterade taggar

Distribuera den uppdaterade ARM-mallen till Azure. Se till att använda samma storagePrefix som du använde tidigare.

templateFile="azuredeploy.json"
today=$(date +"%d-%b-%Y")
DeploymentName="updateTags-"$today

az deployment group create \
    --name $DeploymentName \
    --template-file $templateFile \
    --parameters storagePrefix={your-Prefix} storageSKU=Standard_LRS

Distribuera den uppdaterade ARM-mallen till Azure. Se till att använda samma storagePrefix som du använde tidigare.

$templateFile = "azuredeploy.json"
$today=Get-Date -Format "MM-dd-yyyy"
$deploymentName="updateTags-"+"$today"
New-AzResourceGroupDeployment `
  -Name $deploymentName `
  -TemplateFile $templateFile `
  -storagePrefix {your storagePrefix} `
  -storageSKU Standard_LRS

Kontrollera att de nya taggarna finns i distributionen

I Azure väljer du [resursgruppsnamn för sandbox-miljö] resursgrupp och väljer sedan det lagringskonto som du distribuerade.
Observera taggarna Environment : Dev och Project : Tutorial:

Använda en parameterfil

Det finns för närvarande tre parametrar att fylla i varje gång du distribuerar den här mallen. Varje användare av mallen kan skapa en fil för att lagra sina parametervärden. Här skapar du en parameterfil som ska användas med mallen.

Skapa en annan fil i Visual Studio Code. Kalla det azuredeploy.parameters.dev.json.

I den här filen lägger du till värdena för de mallparametrar som du vill ha indata i mallen för utvecklingsmiljön. Ändra ett tagvärde för att se att distributionen ändras. Du kan till exempel ändra projectName till 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"
      }
    }
  }
}

Se till att ersätta {unique-prefix} med ditt unika prefix.
Spara filen.

Distribuera mallen med parameterfilen

I det här avsnittet distribuerar du ARM-mallen och anger vilken parameterfil som ska användas.

Kör följande Azure CLI-kommandon i Visual Studio Code-terminalen:

templateFile="azuredeploy.json"
devParameterFile="azuredeploy.parameters.dev.json"
today=$(date +"%d-%b-%Y")
DeploymentName="addParameterFile-"$today

az deployment group create \
  --name $DeploymentName \
  --template-file $templateFile \
  --parameters $devParameterFile

Kontrollera azure för att säkerställa att distributionen lyckades och att taggvärdet har ändrats:
Som en utmaning skapar du en parameterfil för produktionsmiljön. Ändra parameterfilens sökväg när du kör kommandot för att distribuera till produktionsmiljön.

Kör följande Azure PowerShell-kommandon i Visual Studio Code-terminalen:

$templateFile = "azuredeploy.json"
$parameterFile="azuredeploy.parameters.dev.json"
$today=Get-Date -Format "MM-dd-yyyy"
$deploymentName="addParameterFile-"+"$today"
New-AzResourceGroupDeployment `
  -Name $deploymentName `
  -TemplateFile $templateFile `
  -TemplateParameterFile $parameterFile