Co je Bicep?

Článek
10/16/2024

Bicep je jazyk specifický pro doménu (DSL), který k nasazování prostředků Azure používá deklarativní syntaxi. V souboru Bicep definujete infrastrukturu, kterou chcete nasadit do Azure, a pak tento soubor použijete v průběhu životního cyklu vývoje k opakovanému nasazení infrastruktury. Vaše prostředky se nasazují konzistentním způsobem.

Bicep poskytuje stručnou syntaxi, spolehlivou bezpečnost typů a podporu opětovného použití kódu. Bicep nabízí prvotřídní prostředí pro vytváření obsahu pro řešení infrastruktury jako kódu v Azure.

Výhody Bicep

Bicep nabízí následující výhody:

Podpora všech typů prostředků a verzí rozhraní API: Bicep okamžitě podporuje všechny verze Preview a GA pro služby Azure. Jakmile poskytovatel prostředků zavádí nové typy prostředků a verze rozhraní API, můžete je použít ve svém souboru Bicep. Před použitím nových služeb nemusíte čekat na aktualizaci nástrojů.

Jednoduchá syntaxe: Ve srovnání s ekvivalentní šablonou JSON jsou soubory Bicep stručnější a čitelnější. Bicep nevyžaduje žádné předchozí znalosti programovacích jazyků. Syntaxe Bicep je deklarativní a určuje, které prostředky a vlastnosti prostředku chcete nasadit.

Následující příklady ukazují rozdíl mezi souborem Bicep a ekvivalentní šablonou JSON. Oba příklady nasazují účet úložiště.

Bicep
JSON

param location string = resourceGroup().location
param storageAccountName string = 'toylaunch${uniqueString(resourceGroup().id)}'

resource storageAccount 'Microsoft.Storage/storageAccounts@2023-04-01' = {
  name: storageAccountName
  location: location
  sku: {
    name: 'Standard_LRS'
  }
  kind: 'StorageV2'
  properties: {
    accessTier: 'Hot'
  }
}

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "storageAccountName": {
      "type": "string",
      "defaultValue": "[format('toylaunch{0}', uniqueString(resourceGroup().id))]"
    }
  },
  "resources": [
    {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2023-04-01",
      "name": "[parameters('storageAccountName')]",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

Prostředí pro vytváření: Když k vytváření souborů Bicep použijete rozšíření Bicep pro VS Code , získáte prvotřídní prostředí pro vytváření obsahu. Editor poskytuje bohaté zabezpečení typů, technologii IntelliSense a ověřování syntaxe.

Soubory Bicep můžete také vytvořit v sadě Visual Studio s příponou Bicep pro Visual Studio.

Opakovatelné výsledky: Opakovaně nasazovat infrastrukturu v průběhu životního cyklu vývoje a mít jistotu, že jsou vaše prostředky nasazeny konzistentním způsobem. Soubory Bicep jsou idempotentní, což znamená, že stejný soubor můžete nasadit mnohokrát a získat stejné typy prostředků ve stejném stavu. Můžete vyvíjet jeden soubor, který představuje požadovaný stav, a nikoli vyvíjet velké množství samostatných souborů pro reprezentaci aktualizací. Například následující soubor vytvoří účet úložiště. Pokud nasadíte tuto šablonu a účet úložiště se zadanými vlastnostmi, nebudou provedeny žádné změny.

Bicep
JSON

param location string = resourceGroup().location

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

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    }
  },
  "resources": {
    "mystore": {
      "type": "Microsoft.Storage/storageAccounts",
      "apiVersion": "2023-04-01",
      "name": "mystorageaccount",
      "location": "[parameters('location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2"
    }
  }
}

Orchestrace: Nemusíte se starat o složitosti operací řazení. Resource Manager orchestruje nasazení vzájemně závislých prostředků, aby se vytvořily ve správném pořadí. Pokud je to možné, Resource Manager nasadí prostředky paralelně, aby vaše nasazení byla dokončena rychleji než sériová nasazení. Soubor nasadíte jedním příkazem, nikoli několika imperativními příkazy.
Modularita: Kód Bicep můžete rozdělit na spravovatelné části pomocí modulů. Modul nasadí sadu souvisejících prostředků. Moduly umožňují opakovaně používat kód a zjednodušit vývoj. Modul přidejte do souboru Bicep, kdykoli potřebujete tyto prostředky nasadit.
Integrace se službami Azure: Bicep je integrovaná se službami Azure, jako jsou Azure Policy, specifikace šablon a podrobné plány.
Změny ve verzi Preview: Pomocí operace citlivostní analýza můžete získat náhled změn před nasazením souboru Bicep. Díky citlivosti uvidíte, které prostředky se vytvoří, aktualizují nebo odstraní, a všechny vlastnosti prostředku, které se změní. Operace citlivostní kontroly aktuálního stavu vašeho prostředí a eliminuje potřebu správy stavu.
Žádné soubory stavu ani soubory stavu ke správě: Veškerý stav je uložený v Azure. Uživatelé můžou spolupracovat a mít jistotu, že se jejich aktualizace zpracovávají podle očekávání.
Bez nákladů a open source: Bicep je zcela zdarma. Nemusíte platit za prémiové funkce. Podporuje ho také podpora Microsoftu.

Začínáme

Začněte s Bicepem:

Nainstalujte nástroje. Viz Nastavení prostředí pro vývoj a nasazení Bicep. Nebo můžete použít úložiště VS Code Devcontainer/Codespaces k získání předem nakonfigurovaného prostředí pro vytváření.
Dokončete rychlý start a moduly Learn pro Bicep.

Pokud chcete dekompilovat existující šablonu ARM na Bicep, přečtěte si téma Dekompilace kódu JSON šablony ARM na Bicep. Pomocí dětského hřiště Bicep můžete vedle sebe zobrazit Bicep a ekvivalentní JSON.

Další informace o prostředcích dostupných v souboru Bicep najdete v referenčních informacích k prostředkům Bicep.

Příklady Bicep najdete v úložišti Bicep na GitHubu .

Informace o jazyce

Bicep není určen jako obecný programovací jazyk pro psaní aplikací. Soubor Bicep deklaruje prostředky a vlastnosti prostředků Azure bez zápisu posloupnosti programovacích příkazů pro vytváření prostředků.

Pokud chcete sledovat stav práce Bicep, přečtěte si úložiště projektu Bicep.

Další informace o Bicep najdete v následujícím videu.

K vývoji šablon Azure Resource Manageru (šablon ARM) můžete použít Bicep místo JSON. Syntaxe JSON pro vytvoření šablony ARM může být podrobná a vyžaduje složité výrazy. Syntaxe Bicep snižuje složitost a zlepšuje vývojové prostředí. Bicep je transparentní abstrakce kódu JSON šablony ARM a nepřijde o žádné možnosti šablony JSON. Během nasazování rozhraní příkazového řádku Bicep převede soubor Bicep na JSON šablony ARM.

Typy prostředků, verze rozhraní API a vlastnosti platné v šabloně ARM jsou platné v souboru Bicep.

Bicep nabízí v porovnání s ekvivalentním JSON jednodušší a stručnější syntaxi. Nepoužívejte výrazy v hranatých závorkách [...]. Místo toho přímo voláte funkce a získáváte hodnoty z parametrů a proměnných. Každý nasazený prostředek pojmenujete symbolický název, který usnadňuje odkaz na tento prostředek ve vaší šabloně.

Úplné porovnání syntaxe najdete v tématu Porovnání json a Bicep pro šablony.

Bicep automaticky spravuje závislosti mezi prostředky. Nastavení se můžete vyhnout dependsOn , když se symbolický název prostředku použije v jiné deklaraci prostředku.

Struktura souboru Bicep je flexibilnější než šablona JSON. Můžete deklarovat parametry, proměnné a výstupy kdekoli v souboru. Ve formátu JSON musíte deklarovat všechny parametry, proměnné a výstupy v odpovídajících oddílech šablony.

Získání podpory

Tady jsou kroky pro otevření lístku podpory pro problémy související se šablonou Azure Resource Manageru (ARM):

Otevřete Azure Portal.
V pravém horním rohu vyberte ikonu Podpora a řešení potíží.
Stručně popište problém, zadejte šablonu ARM a pak vyberte Přejít.
Ve které službě máte problém?, vyberte v části Monitorování a správa portálu a pak vyberte Další.
Vyberte předplatné a pak vyberte Další.
Vyberte Problém se šablonami ARM a pak vyberte Další.

Další kroky

Začínáme s rychlým startem

Odpovědi na běžné otázky najdete v tématu Nejčastější dotazy k Bicep.

Sdílet prostřednictvím