Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
A Bicep egy tartományspecifikus nyelv, amely deklaratív szintaxist használ az Azure-erőforrások üzembe helyezéséhez. Egy Bicep-fájlban definiálja az Azure-ban üzembe helyezni kívánt infrastruktúrát, majd a fejlesztési életciklus során ezt a fájlt használja az infrastruktúra ismételt üzembe helyezéséhez. Az erőforrásokat következetes módon helyezik üzembe.
A Bicep tömör szintaxist, megbízható típusbiztonságot és a kód újrafelhasználásának támogatását biztosítja. A Bicep optimális szerkesztési élményt nyújt az Azure-ban az infrastruktúra mint kód megoldásokhoz.
A bicepsz előnyei
A Bicep a következő előnyöket biztosítja:
Minden erőforrástípus és API-verzió támogatása: A Bicep azonnal támogatja az Azure-szolgáltatások összes előzetes és GA-verzióját. Amint egy erőforrás-szolgáltató új erőforrástípusokat és API-verziókat vezet be, használhatja őket a Bicep-fájlban. Az új szolgáltatások használata előtt nem kell megvárnia az eszközök frissítését.
Egyszerű szintaxis: Az egyenértékű JSON-sablonnal összehasonlítva a Bicep-fájlok tömörebbek és könnyebben olvashatók. A Bicep nem igényel előzetes ismereteket a programozási nyelvekről. A Bicep szintaxis deklaratív, és meghatározza, hogy mely erőforrásokat és erőforrástulajdonságokat szeretné üzembe helyezni.
Az alábbi példák a Bicep-fájl és az azzal egyenértékű JSON-sablon közötti különbséget mutatják be. Mindkét példa üzembe helyez egy tárfiókot:
param location string = resourceGroup().location param storageAccountName string = 'toylaunch${uniqueString(resourceGroup().id)}' resource storageAccount 'Microsoft.Storage/storageAccounts@2023-05-01' = { name: storageAccountName location: location sku: { name: 'Standard_LRS' } kind: 'StorageV2' properties: { accessTier: 'Hot' } }
Szerzői élmény: Amikor a VS Code Bicep-bővítményét használja a Bicep-fájlok létrehozásához, első osztályú szerzői élményt kap. A szerkesztő gazdag típusbiztonságot, IntelliSense-t és szintaxisérvényesítést biztosít.
A Visual Studio Bicep-bővítményével Bicep-fájlokat is létrehozhat a Visual Studióban.
Megismételhető eredmények: Az infrastruktúra üzembe helyezése a fejlesztési életciklus során, megbízhatóan üzembe helyezve az erőforrásokat. A Bicep-fájlok idempotensek, ami azt jelenti, hogy ugyanazt a fájlt többször is üzembe helyezheti, és ugyanabban az állapotban ugyanazokat az erőforrástípusokat szerezheti be. Létrehozhat egy fájlt, amely a kívánt állapotot képviseli ahelyett, hogy több különálló fájlt fejlesztenek a frissítések megjelenítéséhez. Az alábbi fájl például létrehoz egy tárfiókot. Ha ezt a sablont és a tárfiókot akkor helyezi üzembe, amikor a megadott tulajdonságok már léteznek, a módosítások nem történnek:
Vezénylés: Nem kell aggódnia a rendelési műveletek összetettsége miatt. Az Azure Resource Manager koordinálja az egymástól függő erőforrások üzembe helyezését, hogy azok a megfelelő sorrendben legyenek létrehozva. Ha lehetséges, a Resource Manager párhuzamosan telepíti az erőforrásokat, így a telepítések gyorsabban fejeződnek be, mint a soros telepítések. A fájlt több imperatív parancs helyett egyen kell üzembe helyeznie.
Modularitás: Modulokkalkezelhető részekre szegmentelheti a Bicep-kódot. A modulok segítenek a kód újrafelhasználásában és a fejlesztés egyszerűsítésében. A modul egy kapcsolódó erőforráskészletet helyez üzembe. Ha telepítenie kell ezeket az erőforrásokat, adjon hozzá egy modult egy Bicep-fájlhoz.
Integráció az Azure-szolgáltatásokkal: A Bicep integrálható olyan Azure-szolgáltatásokkal, mint az Azure Policy, a sablon specifikációi és az Azure Blueprints.
Változások előnézete: A What-if művelettel megtekintheti a módosításokat a Bicep-fájl üzembe helyezése előtt. A lehetőségelemzési művelet megmutatja, hogy mely erőforrásokat kell létrehoznia, frissítenie vagy törölnie, és milyen erőforrástulajdonságokat kell módosítania. Emellett ellenőrzi a környezet aktuális állapotát, és szükségtelenné teszi ennek az állapotnak a kezelését.
Nincs állapot vagy állapotfájl kezelésére szükség: Az Azure minden állapotot tárol. Együttműködhet másokkal, és biztos lehet abban, hogy a frissítések kezelése a várt módon történik.
Nincs költség és nyílt forráskódú: Mivel a Bicep ingyenes, nem kell fizetnie a prémium képességekért. Microsoft ügyfélszolgálata támogatja.
Első lépések
A Bicep használatának kezdete:
Telepítse az eszközöket. További információért tekintse meg a Bicep fejlesztési és üzembehelyezési környezetek beállítása című részt, vagy használja a VS Code devcontainer/Codespaces adattárat egy előre konfigurált fejlesztői környezet beszerzéséhez.
Töltse ki a Quickstart és a Learn moduljait a Bicephez.
Meglévő Resource Manager-sablon Bicep formátumra történő visszafejtéséhez lásd a JSON Azure Resource Manager-sablon Bicep formátumra történő visszafejtése című részt. A Bicep Playground használatával egymás mellett tekintheti meg a Bicepet és annak megfelelőjét, a JSON-t.
A Bicep-fájlban elérhető erőforrásokról további információt a Bicep-erőforrás referenciájában talál.
Bicep-példákat a Bicep GitHub-adattárban találhat.
Tudnivalók a nyelvről
A Bicep nem általános programozási nyelv az alkalmazások írásához. A Bicep-fájlok anélkül deklarálják az Azure-erőforrásokat és az erőforrás-tulajdonságokat, hogy programozási parancsokat írnak a létrehozásukhoz.
A Bicep-munka állapotának nyomon követéséhez tekintse meg a Bicep-projekt adattárát.
A Bicep megismeréséhez tekintse meg az alábbi videót:
A Bicep-et JSON helyett Resource Manager-sablonok fejlesztésére használhatja. A Resource Manager-sablon létrehozásához szükséges JSON-szintaxis részletes lehet, és bonyolult kifejezéseket igényelhet. A Bicep szintaxis csökkenti ezt az összetettságot, és javítja a fejlesztési élményt. A Bicep egy transzparens absztrakció egy Resource Manager JSON-sablon felett, amely nem veszíti el a JSON-sablonok képességeit. Az üzembe helyezés során a Bicep parancssori felület a Bicep-fájlokat Resource Manager JSON-sablonlá alakítja.
A Resource Manager-sablonban érvényes erőforrástípusok, API-verziók és tulajdonságok bicep fájlban érvényesek.
A Bicep egyszerűbb és tömörebb szintaxist kínál, mint annak megfelelője, a JSON. Nem használ kapcsos zárójelezett kifejezéseket [...]
. Ehelyett közvetlenül függvényeket hívhat meg, és paraméterekből és változókból kérhet le értékeket. Minden üzembe helyezett erőforrásnak szimbolikus nevet ad, így könnyen hivatkozhat rá a sablonban.
A szintaxis teljes összehasonlításáért nézze meg JSON és Bicep összehasonlítása a sablonokhoz.
A Bicep automatikusan kezeli az erőforrások közötti függőségeket. Elkerülheti a dependsOn
beállítását, amikor egy erőforrás szimbolikus neve egy másik erőforrás-deklarációban van használva.
A Bicep-fájl szerkezete rugalmasabb, mint egy JSON-sablon. A fájl bármely pontján deklarálhat paramétereket, változókat és kimeneteket. A JSON-ban deklarálnia kell az összes paramétert, változót és kimenetet a sablon megfelelő szakaszaiban.
Támogatás kérése
Az Alábbiakban bemutatjuk az Azure Resource Manager-sablonokkal kapcsolatos támogatási jegy megnyitásának lépéseit:
Nyissa meg az Azure Portalt.
A jobb felső sarokban válassza a Támogatás és hibaelhárítás ikont.
Röviden írja le a problémát, írja be az ARM-sablont, majd válassza az Ugrás lehetőséget.
Melyik szolgáltatásban van probléma?, válassza a Portál lehetőséget a Figyelés és kezelés területen, majd válassza a Tovább gombot.
Jelöljön ki egy előfizetést, majd válassza a Tovább gombot.
Válassza az ARM-sablonokkal kapcsolatos probléma lehetőséget, majd válassza a Tovább gombot.
Közreműködés a Bicep-ben
A Bicep egy nyílt forráskódú projekt. Ez azt jelenti, hogy hozzájárulhat a Bicep fejlődéséhez, és részt vehet a szélesebb körű Bicep-közösségben. A hozzájárulási típusok a következők:
- Azure gyorsútmutató-sablonok. Példa Bicep-fájlokat és ARM-sablonokat is hozzáadhat az Azure Rövid útmutatósablonok adattárához. További információkért tekintse meg az Azure Gyorsindítási sablonok közreműködési útmutatót.
- Dokumentáció. A Bicep dokumentációja a közreműködők számára is nyitott. További információkért tekintse meg a közreműködői útmutató áttekintését.
- Töredékek. Van egy kedvenc kódrészlete, amelyet a közösség hasznosnak tart? Hozzáadhatja a Visual Studio Code bővítmény kódrészleteinek gyűjteményéhez. További információ: Hozzájárulás a Bicep-hez.
- Kódmódosítások. Ha Ön fejlesztő, és olyan ötletei vannak, amelyeket a Bicep nyelvében vagy eszközkészletében szeretne látni, egy lekéréses kérelmet is megadhat. További információ: Hozzájárulás a Bicep-hez.
Következő lépések
- Kezdéshez lásd a Gyorsindítás: Bicep-fájlok létrehozása a Visual Studio Code segítségével.
- A gyakori kérdésekre adott válaszokért tekintse meg a Bicepvel kapcsolatos gyakori kérdéseket.