Oktatóanyag: Az első ARM-sablon létrehozása és üzembe helyezése

Ez az oktatóanyag bemutatja a Azure Resource Manager (ARM-sablonok) használatával. Bemutatja, hogyan hozhat létre egy kezdősablont, és hogyan helyezheti üzembe az Azure-ban. Megismeri a sablon struktúráját és a sablonokhoz szükséges eszközöket. Az oktatóanyag befejezése körülbelül 12 percet vesz igénybe, de a tényleges idő attól függően változik, hogy hány eszközt kell telepítenie.

Ez az oktatóanyag az első sorozat. A sorozat előrehaladtáig lépésről lépésre kell módosítania a sablon kezdősablonját, amíg meg nem ismerkedik az ARM-sablon összes alapvető elemét. Ezek az elemek a sokkal összetettebb sablonok építőelemei. Reméljük, hogy a sorozat végére magabiztosan hoz létre saját sablonokat, és készen áll az üzemelő példányok sablonokkal való automatizálásra.

Ha szeretné megtudni a sablonok használatának előnyeit, és hogy miért érdemes sablonokkal automatizálni az üzembe helyezést, tekintse meg az ARM-sablonok áttekintését. Ha többet szeretne megtudni az ARM-sablonokról a Microsoft Learn interaktív moduljaival, tekintse meg az Erőforrások üzembe helyezése és kezelése az Azure-ban ARM-sablonok használatával részt.

Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot a feladatok megkezdése előtt.

Eszközök lekérte

Először is győződjön meg arról, hogy rendelkezésre vannak a sablonok létrehozásához és üzembe helyezéséhez szükséges eszközök. Telepítse ezeket az eszközöket a helyi gépre.

Szerkesztő

A sablonok JSON-fájlok. Sablonok létrehozásához egy jó JSON-szerkesztőre van szükség. Javasoljuk, Visual Studio Code-et a Resource Manager Tools bővítsen. Ha telepítenie kell ezeket az eszközöket, lásd: Rövid útmutató: ARM-sablonok létrehozása Visual Studio Code használatával.

Parancssori üzembe helyezés

A sablon üzembe helyezéséhez Azure PowerShell Azure CLI-nek is szüksége lesz. Ha az Azure CLI-t használja, a legújabb verzióra lesz szükség. A telepítési utasításokért lásd:

Miután telepítette Azure PowerShell Azure CLI-t, először jelentkezzen be. További segítségért lásd: Bejelentkezés – PowerShell vagy Bejelentkezés – Azure CLI.

Fontos

Ha az Azure CLI-t használja, győződjön meg arról, hogy 2.6-os vagy újabb verzióval van. Az oktatóanyagban bemutatott parancsok nem fognak működni, ha korábbi verziókat használ. A telepített verzió ellenőrzéshez használja a következőt: az --version .

Most már készen áll arra, hogy megismerjük a sablonokat.

Az első saját sablon létrehozása

  1. Nyissa Visual Studio Code-et, és Resource Manager az Resource Manager Tools bővítményt.

  2. Új fájl létrehozásához a Fájl menüben válassza az Új fájl lehetőséget.

  3. A Fájl menüben válassza a Mentés másként lehetőséget.

  4. Adja a fájlnak az azuredeploy nevet, és válassza ki a json fájlkiterjesztést. A fájl teljes neve azuredeploy.json.

  5. Mentse a fájlt a munkaállomásra. Olyan elérési utat válasszon, amely könnyen jegyezhető meg, mert ezt az elérési utat később, a sablon üzembe helyezésekor fogja használni.

  6. Másolja és illessze be a következő JSON-t a fájlba:

    {
      "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
      "contentVersion": "1.0.0.0",
      "resources": []
    }
    

    A kódkörnyezet a Visual Studio így néz ki:

    ARM-sablon Visual Studio Code első sablonja

    Ez a sablon nem helyez üzembe erőforrásokat. Egy üres sablonnal kezdünk, így megismerheti a sablon üzembe helyezésének lépéseit, miközben minimalizálja annak esélyét, hogy valami hiba történik.

    A JSON-fájl a következő elemeket tartalmazza:

    • $schema: A JSON-sémafájl helyét adja meg. A sémafájl a sablonon belül elérhető tulajdonságokat írja le. A séma például a sablon egyik érvényes resources tulajdonságaként definiálja. Ne aggódjon, a séma dátuma 2019-04-01. Ez a sémaverzió naprakész, és az összes legújabb funkciót tartalmazza. A séma dátuma nem változott, mert a bevezetés óta nem történt jelentős változás.
    • contentVersion: A sablon verzióját adja meg (például 1.0.0.0). Ehhez az elemhez bármilyen értéket meg lehet adni. Ezzel az értékkel dokumentálja a sablon jelentős változásait. Amikor erőforrásokat helyez üzembe a sablon használatával, ezzel az értékkel győződhet meg arról, hogy a megfelelő sablont használja.
    • resources: A telepíteni vagy frissíteni kívánt erőforrásokat tartalmazza. Jelenleg üres, de később erőforrásokat fog hozzáadni.
  7. Mentse a fájlt.

Gratulálunk, létrehozta az első sablonját.

Bejelentkezés az Azure-ba

A Azure PowerShell/Azure CLI használatának elkezdésében jelentkezzen be Azure-beli hitelesítő adataival.

Válassza ki az alábbi kódszakaszok lapfülét, hogy ki Azure PowerShell Azure CLI között. A cikkben leírt CLI-példák a Bash-felülethez vannak megírva.

Connect-AzAccount

Ha több Azure-előfizetéssel rendelkezik, válassza ki a használni kívánt előfizetést. Cserélje le SubscriptionName a helyére az előfizetés nevét. Az előfizetés neve helyett használhatja az előfizetés azonosítóját is.

Set-AzContext SubscriptionName

Erőforráscsoport létrehozása

Sablon üzembe helyezésekor meg kell adnia egy erőforráscsoportot, amely az erőforrásokat fogja tartalmazni. Az üzembe helyezési parancs futtatása előtt hozza létre az erőforráscsoportot az Azure CLI-vel vagy az Azure PowerShell-lel.

New-AzResourceGroup `
  -Name myResourceGroup `
  -Location "Central US"

Sablon üzembe helyezése

A sablon üzembe helyezéséhez használja az Azure CLI-t vagy a Azure PowerShell. Használja a létrehozott erőforráscsoportot. Nevezze el az üzemelő példányt, hogy könnyen azonosíthatja az üzembe helyezési előzményekben. Az egyszerűség kedvéért hozzon létre egy változót is, amely a sablonfájl elérési útját tárolja. Ez a változó megkönnyíti az üzembe helyezési parancsok futtatását, mert nem kell újra megadnia az elérési utat minden egyes üzembe helyezéskor. Cserélje {provide-the-path-to-the-template-file} le a és a kapcsos {} zárójeleket a sablonfájl elérési útjára.

$templateFile = "{provide-the-path-to-the-template-file}"
New-AzResourceGroupDeployment `
  -Name blanktemplate `
  -ResourceGroupName myResourceGroup `
  -TemplateFile $templateFile

Az üzembe helyezési parancs eredményeket ad vissza. Keresse ProvisioningState meg, hogy sikeres volt-e az üzembe helyezés.

Megjegyzés

Ha az üzembe helyezés sikertelen volt, a verbose kapcsolóval lekért információ a létrehozott erőforrásokról. A debug kapcsolóval további információkhoz jut a hibakereséshez.

Az üzembe helyezés ellenőrzése

Az üzembe helyezés ellenőrzéséhez vizsgálja meg az erőforráscsoportot a Azure Portal.

  1. Jelentkezzen be az Azure Portalra.

  2. A bal oldali menüben válassza az Erőforráscsoportok lehetőséget.

  3. Válassza ki az előző eljárásban üzembe helyezett erőforráscsoportot. Az alapértelmezett név a myResourceGroup. Az erőforráscsoporton belül nem fog látni üzembe helyezett erőforrást.

  4. Figyelje meg, hogy az áttekintés jobb felső sarkában megjelenik az üzembe helyezés állapota. Válassza az 1 Sikeres lehetőséget.

    Üzembe helyezés állapotának megtekintése

  5. Láthatja az erőforráscsoport üzembe helyezésének előzményeit. Válassza a blanktemplate lehetőséget.

    Üzembe helyezés kiválasztása

  6. Láthatja az üzemelő példány összegzését. Ebben az esetben nem sok mindent kell látnia, mivel nincsenek üzembe helyezett erőforrások. A sorozat későbbi része hasznosnak találhatja, ha áttekinti az összefoglalást az üzembehelyezés előzményeiben. Figyelje meg, hogy a bal oldalon megtekintheti a bemeneteket, a kimeneteket és az üzembe helyezés során használt sablont.

    Központi telepítés összegzésének megtekintése

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

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

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

  1. A Azure Portal bal oldali menüben válassza az Erőforráscsoport lehetőséget.
  2. A Szűrés név alapján mezőben adja meg az erőforráscsoport nevét.
  3. Válassza ki az erőforráscsoport nevét.
  4. A felső menüben válassza az Erőforráscsoport törlése lehetőséget.

Következő lépések

Létrehozott egy egyszerű sablont az Azure-ban való üzembe helyezéshez. A következő oktatóanyagban hozzáad egy tárfiókot a sablonhoz, és üzembe fogja helyezni az erőforráscsoportban.