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ások üzembe helyezése konzisztens módon működik.

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 első osztályú szerzői élményt nyújt az Azure-beli infrastruktúra-kódmegoldásokhoz .

A Bicep 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:

  • Bicep
  • JSON

  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:

  • Bicep
  • JSON

  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. A Resource Manager vezényli 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 helyezi üzembe az erőforrásokat, így az üzembe helyezések gyorsabban fejeződnek be, mint a soros üzemelő példányok. 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 kezelendő állapot- vagy állapotfájl: 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 első lépése:

1. Telepítse az eszközöket. További információ: Bicep fejlesztési és üzembehelyezési környezetek beállítása, vagy a VS Code devcontainer/Codespaces-adattár használata egy előre konfigurált szerzői környezet lekéréséhez.
2. Töltse ki a Bicep rövid útmutató és learn moduljait.

Ha egy meglévő Resource Manager-sablont szeretne a Bicep-be bontani, olvassa el az ARM-sablon JSON-ból Bicep-hez való felbontását ismertető témakört. 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 az egyenértékű JSON-hoz képest. Nem használ szögletes 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ása: A JSON és a Bicep összehasonlítása a sablonokhoz.

A Bicep automatikusan kezeli az erőforrások közötti függőségeket. Elkerülheti dependsOn , hogy egy erőforrás szimbolikus neve egy másik erőforrás-deklarációban szerepeljen.

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övetkező lépések

Első lépésként tekintse meg a rövid útmutatót.

A gyakori kérdésekre adott válaszokért tekintse meg a Bicepvel kapcsolatos gyakori kérdéseket.