Rövid útmutató: ARM-sablonok létrehozása Visual Studio Code használatával

A Azure Resource Manager Tools for Visual Studio Code nyelvi támogatást, erőforrás-kódrészleteket és erőforrás-automatikus kiegészítést biztosít. Ezek az eszközök segítenek az Azure Resource Manager (ARM-sablonok) létrehozásában és ellenőrzésében. Ebben a rövid útmutatóban a bővítmény használatával fog létrehozni egy ARM-sablont az elejétől kezdve. E közben olyan bővítményeket is tapasztal, mint az ARM-sablonrészletek, az ellenőrzés, a befejezés és a paraméterfájl támogatása.

A rövid útmutató befejezéséhez telepítenie kell Visual Studio Code-et, és telepítenie kell Azure Resource Manager eszközbővítményt. Az Azure CLI vagy a Azure PowerShell is telepíteni és hitelesíteni kell.

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

ARM-sablon létrehozása

Hozzon létre és nyisson meg Visual Studio Code használatával egy új fájlt azuredeploy.json névvel. Írja be a kódot a kódszerkesztőbe, amely Azure Resource Manager ARM-sablon arm caffolding kódrészleteiből.

Válassza arm! a lehetőséget egy Azure-erőforráscsoport üzemelő példányának hatókörű sablon létrehozásához.

Kép a Azure Resource Manager kódrészletek megjelenítéséről

Ez a kódrészlet egy ARM-sablon alapvető építőelemét hozza létre.

Teljes mértékben kiállt ARM-sablont bemutató kép

Figyelje meg, hogy a Visual Studio Code nyelvi módja JSON-ról Azure Resource Manager sablonra. A bővítmény tartalmaz egy ARM-sablonokra jellemző nyelvi kiszolgálót, amely ARM-sablonspecifikus ellenőrzést, kiegészítést és más nyelvi szolgáltatásokat biztosít.

Kép a Azure Resource Manager kódnyelvi Visual Studio módról

Azure-erőforrás hozzáadása

A bővítmény számos Azure-erőforráshoz tartalmaz kódrészleteket. Ezekkel a kódrészletekkel egyszerűen adhat hozzá erőforrásokat a sablon üzembe helyezéséhez.

Helyezze a kurzort a sablon erőforrásblokkjába, írja be a parancsot, és válassza ki az storage arm-storage kódrészletet.

Az ARM-sablonhoz hozzáadott erőforrást bemutató kép

Ez a művelet hozzáad egy tárolási erőforrást a sablonhoz.

Az ARM-Storage Azure-erőforrást bemutató kép

A lapkulcs a tárfiók konfigurálható tulajdonságain keresztüli lapfül-beállításhoz használható.

Kép arról, hogyan használható a lapkulcs az erőforrás-konfigurációban való navigáláshoz

Befejezés és ellenőrzés

A bővítmény egyik leghatékonyabb képessége az Azure-sémákba való integráció. Az Azure-sémák érvényesítési és erőforrás- alapú befejezési képességekkel biztosítják a bővítményt. Módosítsuk a tárfiókot, hogy látható legyen az érvényesítés és a befejezés.

Először frissítse a tárfiók fajtáját egy érvénytelen értékre, például megaStorage a következőre: . Figyelje meg, hogy ez a művelet egy figyelmeztetést hoz létre, amely azt megaStorage jelzi, hogy nem érvényes érték.

Érvénytelen tárolókonfigurációt bemutató kép

A befejezési képességeket úgy használhatja, ha eltávolítja a et, helyezze a kurzort az idézőjelek megaStorage közé, és nyomja le a ctrl + space billentyűt. Ez a művelet az érvényes értékek befejezési listáját mutatja.

A bővítmény automatikus kiegészítését bemutató kép

Sablonparaméterek hozzáadása

Most hozzon létre és használjon egy paramétert a tárfiók nevének megadásához.

Helyezze a kurzort a paraméterek blokkba, adjon hozzá egy kocsivissza gombra, írja be a parancsot, majd válassza ki a " new-parameter kódrészletet. Ez a művelet egy általános paramétert ad hozzá a sablonhoz.

Az ARM-sablonhoz hozzáadott paramétert bemutató kép

Frissítse a paraméter nevét a következőre: storageAccountName , a leírást pedig a következőre: Storage Account Name .

A kész paramétert egy ARM-sablonban bemutató kép

Az Azure-tárfiókok nevei legalább 3 karakterből és legfeljebb 24 karakterből állhatnak. Adja hozzá a minLength és maxLength a paramétert, és adja meg a megfelelő értékeket.

Kép a minLength és a maxLength ARM-sablonparaméterhez való hozzáadásról

Most a tárolási erőforráson frissítse a name tulajdonságot a paraméter használatára. Távolítsa el az aktuális nevet. Adjon meg egy dupla idézőjelet és egy nyitó szögletes zárójelet, amely [ létrehoz egy ARM-sablonfólistát. Válassza ki a paramétereket a listából.

A paraméterek ARM-sablonerőforrásokban való használatának automatikus kiegészítését bemutató kép

Ha egy egyszeres idézőjelet ad meg a kerek zárójelek között, a rendszer a sablonban definiált összes paraméter listáját állítja elő, ebben az esetben ' a storageAccountName paramétert. Válassza ki a paramétert.

Egy ARM-sablonerőforrás befejezett paraméterét bemutató kép

Paraméterfájl létrehozása

Az ARM-sablon paraméterfájlja lehetővé teszi, hogy környezetspecifikus paraméterértékeket tároljon, és ezeket az értékeket csoportként adja át az üzembe helyezéskor. Például lehet egy olyan paraméterfájlja, amely egy tesztkörnyezetre jellemző értékeket tartalmaz, egy másikat pedig egy éles környezethez.

A bővítmény segítségével egyszerűen hozhat létre paraméterfájlt a meglévő sablonokból. Kattintson a jobb gombbal a sablonra a kódszerkesztőben, és válassza a Select/Create Parameter File lehetőséget.

A paraméterfájl ARM-sablonból való létrehozásának jobb gombbal való létrehozási folyamatát bemutató kép

Válassza New > All Parameters > A paraméterfájl nevének és helyének kiválasztása lehetőséget.

Kép a név és a fájl mentése párbeszédpanelről, amikor paraméterfájlt hoz létre egy ARM-sablonból

Ez a művelet létrehoz egy új paraméterfájlt, és leképezi azt azzal a sablonnal, amelyből létre lett hozva. Az aktuális sablon-/paraméterfájl-leképezést a Visual Studio kód állapotsávjában láthatja és módosíthatja, amíg a sablon ki van választva.

A sablon/paraméter fájlleképezését a kód Visual Studio sávon bemutató kép.

Most, hogy a paraméterfájl le lett leképezve a sablonra, a bővítmény egyszerre ellenőrzi a sablont és a paraméterfájlt is. Ha a gyakorlatban is meg szeretne bizonyosodni az ellenőrzésről, adjon hozzá egy két karakterből áll értéket a paraméterfájlban található storageAccountName paraméterhez, és mentse a fájlt.

Paraméterfájl-probléma miatt érvénytelenné vált sablont bemutató kép

Lépjen vissza az ARM-sablonhoz, és figyelje meg, hogy hiba történt, amely azt jelzi, hogy az érték nem felel meg a paraméter kritériumainak.

Érvényes ARM-sablont bemutató kép

Frissítse az értéket valami megfelelőre, mentse a fájlt, és lépjen vissza a sablonhoz. Figyelje meg, hogy a paraméter hibája megoldódott.

A sablon üzembe helyezése

Nyissa meg az integrált Visual Studio Code terminált a billentyűkombinációval, és használja az Azure CLI-t vagy Azure PowerShell modult a ctrl + ` sablon üzembe helyezéséhez.

az group create --name arm-vscode --location eastus

az deployment group create --resource-group arm-vscode --template-file azuredeploy.json --parameters azuredeploy.parameters.json

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

Ha az Azure-erőforrásokra már nincs szükség, az Azure CLI vagy Azure PowerShell modul használatával törölheti a rövid útmutató erőforráscsoportját.

az group delete --name arm-vscode

További lépések