Číst v angličtině

Sdílet prostřednictvím

Co je Bicep?

  • Článek

Bicep je jazyk specifický pro doménu, který k nasazení 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í této 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 spuštění 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 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 
    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'
  }
}

  • 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 bohatou bezpečnost typů, Technologii IntelliSense a ověřování syntaxe.

    Snímek obrazovky při vytváření souboru Bicep v reálném čase

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

  • Opakovatelné výsledky: Nasaďte infrastrukturu v průběhu životního cyklu vývoje s jistotou, že se vaše prostředky nasazují konzistentně. 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 vytvořit jeden soubor, který představuje požadovaný stav místo vývoje mnoha 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ě, pokud zadané vlastnosti již existují, změny se neprovedou:

    Bicep 
    param location string = resourceGroup().location

resource mystore 'Microsoft.Storage/storageAccounts@2023-05-01' = {
  name: 'mystorageaccount'
  location: 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ů tak, aby byly vytvořeny ve správném pořadí. Pokud je to možné, Resource Manager nasadí prostředky paralelně, což pomáhá vašim nasazením dokončit rychleji než sériová nasazení. Soubor nasadíte místo několika imperativních příkazů.

    Diagram porovnávání nasazení mezi souborem Bicep a infrastrukturou jako kódem, který není v šabloně.

  • Modularita: Pomocí modulů segmentujte kód Bicep do spravovatelných částí. Moduly vám pomůžou znovu použít kód a zjednodušit vývoj. Modul nasadí sadu souvisejících prostředků. Pokud potřebujete nasadit tyto prostředky, přidejte do souboru Bicep modul.

  • Integrace se službami Azure: Bicep se integruje se službami Azure, jako jsou Azure Policy, specifikace šablon a Azure Blueprints.

  • Změny ve verzi Preview: Před nasazením souboru Bicep můžete použít operaci citlivostní analýza k zobrazení náhledu změn. Operace citlivostní operace ukazuje, které prostředky se mají vytvořit, aktualizovat nebo odstranit, a všechny vlastnosti prostředku, které se mají změnit. Také zkontroluje aktuální stav vašeho prostředí a eliminuje potřebu spravovat tento stav.

  • Žádné soubory stavu ani soubory stavu ke správě: Azure ukládá veškerý stav. Můžete spolupracovat s ostatními a mít jistotu, že se vaše aktualizace zpracovávají podle očekávání.

  • Bez nákladů a open source: Vzhledem k tomu, že je Bicep zdarma, nemusíte platit za prémiové funkce. podpora Microsoftu ji podporuje.

Začínáme

Začněte s Bicepem:

  1. Nainstalujte nástroje. Další informace najdete v tématu Nastavení prostředí pro vývoj a nasazení Bicep nebo použití úložiště VS Code devcontainer/Codespaces k získání předkonfigurovaného prostředí pro vytváření.
  2. Dokončete moduly Rychlý start a Learn pro Bicep.

Pokud chcete dekompilovat existující šablonu Resource Manageru do Bicep, přečtěte si téma Dekompilování KÓDU JSON šablony ARM do Bicep. Pomocí dětského hřiště Bicep můžete zobrazit Bicep a jeho ekvivalent JSON vedle sebe.

Informace o prostředcích, které jsou k dispozici ve vašem souboru Bicep, najdete v tématu Referenční informace o prostředcích 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ů, které je vytvoří.

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

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

K vývoji šablon Resource Manageru můžete použít Bicep místo JSON. Syntaxe JSON pro vytvoření šablony Resource Manageru 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 šablony JSON Resource Manageru, která neztratí možnosti šablony JSON. Během nasazování rozhraní příkazového řádku Bicep převede soubor Bicep na šablonu JSON Resource Manageru.

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

Bicep nabízí v porovnání s ekvivalentem 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):

  1. Otevřete Azure Portal.

  2. V pravém horním rohu vyberte ikonu Podpora a řešení potíží.

  3. Stručně popište problém, zadejte šablonu ARM a pak vyberte Přejít.

  4. Ve které službě máte problém?, vyberte v části Monitorování a správa portálu a pak vyberte Další.

  5. Vyberte předplatné a pak vyberte Další.

  6. Vyberte Problém se šablonami ARM a pak vyberte Další.

    Snímek obrazovky s žádostí o podporu šablon ARM

Další kroky

Pokud chcete začít, podívejte se na rychlý start.

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