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

Mi az a Bicep?

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.

    Bicep-fájlok valós idejű készítésének képernyőfelvétele

    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:

    param location string = resourceGroup().location

resource mystore 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'mystorageaccount'
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
}

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

    Egy diagram, amely egy Bicep-fájl és egy infrastruktúra közötti üzembe helyezést hasonlítja össze egy sablonban nem szereplő kódként.

  • 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:

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

  2. 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:

  1. Nyissa meg az Azure Portalt.

  2. A jobb felső sarokban válassza a Támogatás és hibaelhárítás ikont.

  3. Röviden írja le a problémát, írja be az ARM-sablont, majd válassza az Ugrás lehetőséget.

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

  5. Jelöljön ki egy előfizetést, majd válassza a Tovább gombot.

  6. Válassza az ARM-sablonokkal kapcsolatos probléma lehetőséget, majd válassza a Tovább gombot.

    Képernyőkép az ARM-sablon támogatásának igényléséről.

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