Was ist Bicep?

2025-05-03

Bicep ist eine domänenspezifische Sprache, die eine deklarative Syntax zur Bereitstellung von Azure-Ressourcen verwendet. In einer Bicep-Datei definieren Sie die Infrastruktur, die Sie in Azure bereitstellen möchten, und verwenden diese Datei dann während des gesamten Entwicklungslebenszyklus, um diese Infrastruktur wiederholt bereitzustellen. Ihre Ressourcen werden auf einheitliche Weise bereitgestellt.

Bicep bietet eine präzise Syntax, zuverlässige Typsicherheit und Unterstützung für die Wiederverwendung von Code. Bicep bietet eine optimale Erstellungserfahrung für Ihre Infrastruktur-as-Code-Lösungen in Azure.

Vorteile von Bicep

Bicep bietet folgende Vorteile:

Unterstützung für alle Ressourcentypen und API-Versionen: In Bicep werden alle Vorschau- und allgemein verfügbaren Versionen für Azure-Dienste direkt unterstützt. Sobald ein Ressourcenanbieter neue Ressourcentypen und API-Versionen einführt, können Sie diese in der Bicep-Datei verwenden. Sie müssen nicht warten, bis Tools aktualisiert werden, bevor Sie neue Dienste verwenden.

Einfache Syntax: Im Vergleich zur entsprechenden JSON-Vorlage sind Bicep-Dateien präziser und einfacher zu lesen. Für Bicep sind keine Vorkenntnisse über Programmiersprachen erforderlich. Die Bicep-Syntax ist deklarativ und gibt an, welche Ressourcen und Ressourceneigenschaften Sie bereitstellen möchten.

Die folgenden Beispiele zeigen den Unterschied zwischen einer Bicep-Datei und der entsprechenden JSON-Vorlage. In beiden Beispielen wird ein Speicherkonto bereitgestellt:

Bizeps
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'
  }
}

{
  "$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-05-01",
      "name": "[parameters('storageAccountName')]",
      "___location": "[parameters('___location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2",
      "properties": {
        "accessTier": "Hot"
      }
    }
  ]
}

Erstellungsfunktionen: Wenn Sie Bicep-Dateien über die Bicep-Erweiterung für VS Code erstellen, profitieren Sie von erstklassigen Erstellungsfunktionen. Der Editor bietet umfassende Typsicherheit, IntelliSense und Syntaxvalidierung.

Mit der Bicep-Erweiterung für Visual Studio können Sie auch Bicep-Dateien in Visual Studio erstellen.

Wiederholbare Ergebnisse: Stellen Sie Ihre Infrastruktur während des gesamten Entwicklungslebenszyklus mit der Gewissheit bereit, dass dies einheitlich geschieht. Bicep-Dateien sind idempotent, d. h. Sie können dieselbe Datei mehrmals bereitstellen und erhalten immer dieselben Ressourcentypen im selben Zustand. Sie können eine Datei entwickeln, die den gewünschten Zustand darstellt, anstatt viele separate Dateien zur Darstellung von Aktualisierungen zu entwickeln. Die folgende Datei erstellt z. B. ein Speicherkonto. Wenn Sie diese Vorlage bereitstellen und das Speicherkonto mit den angegebenen Eigenschaften bereits vorhanden ist, werden keine Änderungen vorgenommen:

Bizeps
JSON

param ___location string = resourceGroup().___location

resource mystore 'Microsoft.Storage/storageAccounts@2023-05-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-05-01",
      "name": "mystorageaccount",
      "___location": "[parameters('___location')]",
      "sku": {
        "name": "Standard_LRS"
      },
      "kind": "StorageV2"
    }
  }
}

Orchestrierung: Sie müssen sich keine Gedanken über die Komplexität von Bestellvorgängen machen. Azure Resource Manager koordiniert die Bereitstellung von interdependenten Ressourcen, sodass sie in der richtigen Reihenfolge erstellt werden. Wenn möglich, stellt der Resource Manager Ressourcen parallel bereit, sodass Ihre Bereitstellungen schneller abgeschlossen werden als serielle Bereitstellungen. Sie stellen die Datei über einen statt über mehrere imperativer Befehle bereit.
Modularität: Verwenden Sie Module, um Ihren Bicep-Code in verwaltbare Teile zu segmentieren. Mit Modulen lässt sich Code wiederverwenden und die Entwicklung vereinfachen. Über ein Modul werden zugehörige Ressourcen bereitgestellt. Sie können ein Modul in einer Bicep-Datei hinzufügen, wenn Sie die entsprechenden Ressourcen bereitstellen möchten.
Integration in Azure-Diensten: Bicep ist in Azure-Diensten wie Azure Policy, Vorlagenspezifikationen und Azure Blueprints integriert.
Vorschau von Änderungen: Sie können den Was-wäre-wenn-Vorgang verwenden, um vor der Bereitstellung der Bicep-Datei eine Vorschau der Änderungen anzuzeigen. Der Was-wäre-wenn-Vorgang zeigt Ihnen, welche Ressourcen erstellt, aktualisiert oder gelöscht und welche Ressourceneigenschaften geändert werden müssen. Er überprüft außerdem den aktuellen Zustand Ihrer Umgebung, sodass Sie diesen nicht verwalten müssen.
Es werden keine Zustands- oder Zustandsdateien verwaltet: Azure speichert alle Zustände. Sie können mit anderen zusammenarbeiten und sicher sein, dass Ihre Updates wie erwartet verarbeitet werden.
Keine Kosten und Open Source: Da Bicep kostenlos ist, zahlen Sie nicht für Premium-Funktionen. Es wird von Microsoft-Support unterstützt.

Erste Schritte

So beginnen Sie mit Bicep

Installieren Sie die Tools. Weitere Informationen finden Sie unter Einrichten von Bicep-Entwicklungs- und Bereitstellungsumgebungen oder verwenden Sie das VS Code devcontainer/Codespaces-Repository , um eine vorkonfigurierte Erstellungsumgebung abzurufen.
Absolvieren Sie den Schnellstart und die Lernmodule für Bicep.

Informationen zum Dekompilieren einer vorhandenen Resource Manager-Vorlage zu Bicep finden Sie unter Dekompilieren einer JSON-Vorlage für Azure Resource Manager auf Bicep. Mit dem Bicep-Playground können Sie Bicep und die JSON-Entsprechung nebeneinander anzeigen.

Informationen zu den Ressourcen, die in Ihrer Bicep-Datei verfügbar sind, finden Sie unter Bicep-Ressourcenreferenz.

Bicep-Beispiele können Sie im Bicep-GitHub-Repository finden.

Informationen zur Sprache

Bicep ist nicht als allgemeine Programmiersprache zum Schreiben von Anwendungen vorgesehen. Eine Bicep-Datei deklariert Azure-Ressourcen und -Ressourceneigenschaften, ohne eine Sequenz von Programmierbefehlen zum Erstellen von diesen zu schreiben.

Informationen zur Überwachung des Status der Bicep-Arbeit finden Sie im Bicep-Projektrepository.

Weitere Informationen zu Bicep finden Sie im folgenden Video:

Sie können Bicep anstelle von JSON verwenden, um Resource Manager-Vorlagen zu erstellen. Die JSON-Syntax zum Erstellen einer Resource Manager-Vorlage kann ausführlich sein und komplizierte Ausdrücke erfordern. Die Bicep-Syntax reduziert diese Komplexität und erleichtert die Entwicklung. Bicep ist eine transparente Abstraktion einer Resource Manager-JSON-Vorlage und büßt keine der Funktionen von JSON-Vorlagen ein. Während der Bereitstellung konvertiert die Bicep-CLI eine Bicep-Datei in eine Resource Manager-JSON-Vorlage.

In einer Resource Manager-Vorlage gültige Ressourcentypen, API-Versionen und Eigenschaften sind auch in einer Bicep-Datei gültig.

Bicep bietet eine einfachere und präzisere Syntax als die entsprechende JSON-Anweisung. Sie verwenden keine in Klammern stehenden Ausdrücke [...]. Stattdessen rufen Sie Funktionen direkt auf und erhalten Werte von Parametern und Variablen. Sie weisen jeder bereitgestellten Ressource einen symbolischen Namen zu, sodass Sie einfach in Ihrer Vorlage auf diese Ressource verweisen können.

Einen vollständigen Vergleich der Syntax finden Sie unter Vergleichen von JSON und Bicep für Vorlagen.

Bicep verwaltet Abhängigkeiten zwischen Ressourcen automatisch. Sie können die Einstellung dependsOn vermeiden, wenn der symbolische Name einer Ressource in einer anderen Ressourcendeklaration verwendet wird.

Die Struktur der Bicep-Datei ist flexibler als die einer JSON-Vorlage. Sie können an beliebiger Stelle in der Datei Parameter, Variablen und Ausgaben deklarieren. In JSON müssen Sie alle Parameter, Variablen und Ausgaben in den entsprechenden Abschnitten der Vorlage deklarieren.

Support

Dies sind die Schritte zum Öffnen eines Supporttickets für Probleme mit Azure Resource Manager (ARM)-Vorlagen:

Öffnen Sie das Azure-Portal.
Wählen Sie in der oberen rechten Ecke das Symbol Support + Problembehandlung aus.
Geben Sie im Feld Beschreiben Sie kurz das Problem den Text ARM-Vorlage ein, und wählen Sie dann Los aus.
Wählen Sie im Bereich Bei welchem Dienst besteht ein Problem? die Option Portal unter Überwachung und Verwaltung aus. Klicken Sie dann auf Weiter.
Wählen Sie ein Abonnement und dann Weiter aus.
Wählen Sie Problem mit ARM-Vorlagen und dann Weiter aus.

Mitwirkung an Bicep

Bicep ist ein Open-Source-Projekt. Das bedeutet, dass Sie zur Entwicklung von Bicep beitragen und an der breiteren Bicep-Community teilnehmen können. Zu den Beitragstypen gehören:

Azure-Schnellstartvorlagen. Sie können Beispiel-Bicep-Dateien und ARM-Vorlagen zum Azure-Schnellstartvorlagen-Repository beitragen. Weitere Informationen finden Sie im Beitragshandbuch für Azure-Schnellstartvorlagen.
Dokumentation. Auch die Dokumentation von Bicep ist für Beiträge offen. Weitere Informationen finden Sie in unserem Leitfaden für Mitwirkende.
Schnipsel. Haben Sie einen bevorzugten Codeausschnitt, von dem die Community profitieren würde? Sie können sie der Visual Studio Code-Erweiterungssammlung von Codeausschnitten hinzufügen. Weitere Informationen finden Sie unter "Beitragen zu Bicep".
Codeänderungen. Wenn Sie Entwickler sind und Ideen haben, die Sie in der Programmiersprache Bicep oder den zugehörigen Werkzeugen einbringen möchten, können Sie einen Pull-Request beitragen. Weitere Informationen finden Sie unter "Beitragen zu Bicep".

Nächste Schritte

Erste Schritte finden Sie in der Schnellstartanleitung: Erstellen von Bicep-Dateien mit Visual Studio Code.
Antworten auf gängige Fragen finden Sie unter Häufig gestellte Fragen zu Bicep.

Freigeben über