Oktatóanyag: Erőforrás hozzáadása ARM-sablonhoz

  • Cikk

Az előző oktatóanyagban megtanulta, hogyan hozhatja létre és helyezheti üzembe az első üres Azure Resource Manager-sablont (ARM-sablont). Most már készen áll egy tényleges erőforrás üzembe helyezésére a sablonban. Ebben az esetben egy Azure Storage-fiók. Ez az utasítás 9 percet vesz igénybe.

Előfeltételek

Javasoljuk, hogy végezze el a sablonok bevezető oktatóanyagát, de nem szükséges.

Telepítenie kell a Visual Studio Code-ot, és együtt kell működnie az Azure Resource Manager Tools bővítményével, valamint Azure PowerShell vagy az Azure Command-Line Interface (CLI) használatával. További információ: sabloneszközök.

Erőforrás hozzáadása

Ha hozzá szeretne adni egy Azure Storage-fiókdefiníciót a meglévő sablonhoz, tekintse meg a kiemelt JSON-fájlt az alábbi példában. A sablon szakaszainak másolása helyett másolja ki a teljes fájlt, és cserélje le a sablont annak tartalmára.

Cserélje le {provide-unique-name} a kapcsos zárójeleket {} egy egyedi tárfióknévre.

Fontos

A tárfiók nevének egyedinek kell lennie az Azure-ban. Csak kisbetűk vagy számok, és legfeljebb 24 karakterből állhat. Előtagként használhatja a store1 nevet, majd hozzáadhatja a monogramját és a mai dátumot. A név például tárolható1abc06132022.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2021-09-01",
      "name": "{provide-unique-name}",
      "location": "eastus",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "supportsHttpsTrafficOnly": true
      }
    }
  ]
}

A tárfiók egyedi nevének kitalálása nem egyszerű, és nem működik jól a nagy méretű üzemelő példányok automatizálásához. Az oktatóanyag-sorozat későbbi részében sablonfunkciókat használ, amelyek megkönnyítik az egyedi név létrehozását.

Erőforrás tulajdonságai

Felmerülhet a kérdés, hogyan keresheti meg az egyes erőforrástípusokhoz használandó tulajdonságokat. Az ARM-sablonhivatkozással megkeresheti az üzembe helyezni kívánt erőforrástípusokat.

Minden telepített erőforrás legalább a következő három tulajdonsággal rendelkezik:

  • type: Az erőforrás típusa. Ez az érték az erőforrás-szolgáltató névterének és az olyan erőforrástípusnak a kombinációja, mint a Microsoft.Storage/storageAccounts.
  • apiVersion: Az erőforrás létrehozásához használandó REST API verziója. Minden erőforrás-szolgáltató közzéteszi a saját API-verzióit, így ez az érték a típusra jellemző.
  • name: Az erőforrás neve.

A legtöbb erőforrásnak van egy location tulajdonsága is, amely beállítja azt a régiót, ahol az erőforrást üzembe helyezi.

A többi tulajdonság erőforrástípustól és API-verziótól függően változik. Fontos megérteni az API-verzió és a rendelkezésre álló tulajdonságok közötti kapcsolatot, ezért vizsgáljuk meg részletesebben.

Ebben az oktatóanyagban egy tárfiókot ad hozzá a sablonhoz. A tárfiók API-verziója a storageAccounts 2021-09-01 címen érhető el. Figyelje meg, hogy nem adja hozzá az összes tulajdonságot a sablonhoz. Számos tulajdonság nem kötelező. Az Microsoft.Storage erőforrás-szolgáltató kiadhat egy új API-verziót, de az üzembe helyezendő verziót nem kell módosítania. Továbbra is használhatja ezt a verziót, és tudja, hogy az üzembe helyezés eredményei konzisztensek.

Ha egy régebbi API-verziót tekint meg, előfordulhat, hogy egy kisebb tulajdonságkészlet érhető el.

Ha úgy dönt, hogy módosítja egy erőforrás API-verzióját, győződjön meg arról, hogy kiértékeli az adott verzió tulajdonságait, és megfelelően módosítja a sablont.

Sablon üzembe helyezése

A sablont üzembe helyezheti a tárfiók létrehozásához. Adjon egy másik nevet az üzembe helyezésnek, hogy könnyen megtalálhassa az előzmények között.

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ó.

New-AzResourceGroupDeployment `
  -Name addstorage `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Megjegyzés

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

Ezek a hibák két lehetséges üzembehelyezési hibával járhatnak:

  • Error: Code=AccountNameInvalid; Message={provide-unique-name} nem érvényes tárfióknév. A tárfiók nevének 3 és 24 karakter közötti hosszúságúnak kell lennie, és csak számokat és kisbetűket kell használnia.

    A sablonban cserélje le a elemet {provide-unique-name} egy egyedi tárfióknévre. Lásd: Erőforrás hozzáadása.

  • Error: Code=StorageAccountAlreadyTaken; Message=The storage account named store1abc09092019 már megtörtént.

    A sablonban próbálkozzon egy másik tárfióknévvel.

Ez az üzembe helyezés több időt vesz igénybe, mint az üres sablon üzembe helyezése, mivel tárfiókot hoz létre. Akár egy percig is eltarthat.

Az üzembe helyezés ellenőrzése

Az üzembe helyezést a Azure Portal erőforráscsoportjának vizsgálatával ellenőrizheti.

  1. Jelentkezzen be az Azure Portal.
  2. A bal oldali menüben válassza az Erőforráscsoportok lehetőséget.
  3. Jelölje be a myResourceGrouptól balra található jelölőnégyzetet, és válassza a myResourceGroup lehetőséget
  4. Válassza ki azt az erőforráscsoportot, amelybe üzembe helyezett.
  5. Láthatja, hogy egy tárfiók üzembe lett helyezve.
  6. Figyelje meg, hogy az üzembe helyezés címkéje a következőhöz hasonló: Üzemelő példányok: 2 Sikeres.

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 üzembe helyezett erőforrásokat az erőforráscsoport törlésével.

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

Következő lépések

Létrehozott egy egyszerű sablont egy Azure Storage-fiók üzembe helyezéséhez. A későbbi oktatóanyagokban megtudhatja, hogyan adhat hozzá paramétereket, változókat, erőforrásokat és kimeneteket egy sablonhoz. Ezek a funkciók a sokkal összetettebb sablonok építőelemei.

Paraméterek hozzáadása