Oktatóanyag: Kimenetek hozzáadása az ARM-sablonhoz

Cikk
07/28/2023

Ebben az oktatóanyagban megtudhatja, hogyan adhat vissza értéket az Azure Resource Manager-sablonból (ARM-sablonból). A kimeneteket akkor használja, ha egy üzembe helyezendő erőforráshoz értékre van szüksége. Ez az oktatóanyag 7 percet vesz igénybe.

Előfeltételek

Javasoljuk, hogy végezze el a változókról szóló oktatóanyagot, de nincs rá szükség.

Rendelkeznie kell a Visual Studio Code-tal a Resource Manager Tools bővítménnyel, valamint Azure PowerShell vagy Azure Command-Line Interface (CLI) használatával. További információ: Sabloneszközök.

Sablon áttekintése

Az előző oktatóanyag végén a sablon a következő JSON-t tartalmazza:

{
  "$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": "2021-09-01",
      "name": "[variables('uniqueStorageName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "[parameters('storageSKU')]"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

Üzembe helyez egy tárfiókot, de nem ad vissza vele kapcsolatos információt. Előfordulhat, hogy rögzítenie kell az új erőforrás tulajdonságait, hogy később referenciaként elérhetők legyenek.

Kimenetek hozzáadása

A kimenetekkel értékeket adhat vissza a sablonból. Hasznos lehet például az új tárfiók végpontjainak lekérése.

Az alábbi példa kiemeli a sablon módosítását egy kimeneti érték hozzáadásához. Másolja ki a teljes fájlt, és cserélje le a sablont annak tartalmára.

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

Néhány fontos elemet fel kell jegyezni a hozzáadott kimeneti értékről.

A visszaadott érték típusa értékre objectvan állítva, ami azt jelenti, hogy egy JSON-objektumot ad vissza.

A referenciafüggvény használatával lekéri a tárfiók futtatókörnyezeti állapotát. Egy erőforrás futtatókörnyezeti állapotának lekéréséhez adja meg egy erőforrás nevét vagy azonosítóját. Ebben az esetben ugyanazt a változót használja, amelyet a tárfiók nevének létrehozásához használt.

Végül visszaadja a tulajdonságot primaryEndpoints a tárfiókból.

Sablon üzembe helyezése

Készen áll a sablon üzembe helyezésére, és megtekintheti a visszaadott értéket.

Ha még nem hozta létre az erőforráscsoportot, olvassa el az Erőforráscsoport létrehozása című témakört. A példa feltételezi, hogy a változót templateFile a sablonfájl elérési útjára állította, ahogy az első oktatóanyagban is látható.

PowerShell
Azure CLI

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

Az üzembe helyezési parancs futtatásához az Azure CLI legújabb verziójával kell rendelkeznie.

az deployment group create \
  --name addoutputs \
  --resource-group myResourceGroup \
  --template-file $templateFile \
  --parameters storagePrefix=store storageSKU=Standard_LRS

Az üzembe helyezési parancs kimenetében csak akkor jelenik meg az alábbi példához hasonló objektum, ha a kimenet JSON formátumban van:

{
    "dfs": "https://storeluktbfkpjjrkm.dfs.core.windows.net/",
    "web": "https://storeluktbfkpjjrkm.z19.web.core.windows.net/",
    "blob": "https://storeluktbfkpjjrkm.blob.core.windows.net/",
    "queue": "https://storeluktbfkpjjrkm.queue.core.windows.net/",
    "table": "https://storeluktbfkpjjrkm.table.core.windows.net/",
    "file": "https://storeluktbfkpjjrkm.file.core.windows.net/"
}

Megjegyzés

Ha az üzembe helyezés sikertelen, a verbose kapcsolóval lekérheti a létrehozott erőforrásokra vonatkozó információkat. A kapcsolóval debug további információt kaphat a hibakeresésről.

A munka áttekintése

Sokat tett az elmúlt hat oktatóanyagban. Szánjunk egy kis időt, hogy áttekintsük, mit tett. Létrehozott egy könnyen megadható paramétereket tartalmazó sablont. A sablon különböző környezetekben újrafelhasználható, mert lehetővé teszi a testreszabást, és dinamikusan létrehozza a szükséges értékeket. Emellett a szkriptben használható tárfiókra vonatkozó információkat is visszaad.

Most nézzük meg az erőforráscsoportot és az üzembehelyezési előzményeket.

Jelentkezzen be az Azure Portalra.
A bal oldali menüben válassza az Erőforráscsoportok lehetőséget.
Válassza ki azt az erőforráscsoportot, amelybe üzembe helyezett.
A lépésektől függően rendelkeznie kell legalább egy, esetleg több tárfiókkal az erőforráscsoportban.
Emellett több sikeres üzembe helyezésnek is szerepelnie kell az előzmények között. Válassza ki ezt a hivatkozást.
Az összes üzemelő példány megjelenik az előzmények között. Válassza ki az addoutputs nevű üzemelő példányt.
A bemeneteket áttekintheti.
A kimeneteket áttekintheti.
A sablont áttekintheti.

Az erőforrások eltávolítása

Ha továbblép a következő oktatóanyagra, nem kell törölnie az erőforráscsoportot.

Ha most leáll, érdemes lehet törölnie az erőforráscsoportot.

A Azure Portal válassza az Erőforráscsoportok lehetőséget a bal oldali menüben.
Írja be az erőforráscsoport nevét a Szűrő bármely mezőhöz... szövegmezőbe.
Jelölje be a myResourceGroup melletti jelölőnégyzetet, és válassza a myResourceGroup vagy az erőforráscsoport nevét.
Válassza az Erőforráscsoport törlése lehetőséget a felső menüben.

Következő lépések

Ebben az oktatóanyagban hozzáadott egy visszatérési értéket a sablonhoz. A következő oktatóanyagból megtudhatja, hogyan exportálhat egy sablont, és hogyan használhatja az exportált sablon részeit a sablonban.

Exportált sablon használata

Megosztás a következőn keresztül: