ARM-Vorlagen schreiben

Mit ARM-Vorlagen können Sie die Azure-Infrastruktur im JSON-Format als Code definieren. Dadurch werden wiederholbare und konsistente Bereitstellungen möglich, die zusammen mit Ihrem Anwendungscode versioniert werden können. Vorlagen sind idempotent — bei mehrfacher Ausführung derselben Vorlage wird dasselbe Ergebnis erzeugt. Dadurch können sie nach Änderungen sicher erneut angewendet werden.

Jede ARM-Vorlage beginnt mit einer $schema-Eigenschaft, die auf die URL des Vorlagenschemas verweist, gefolgt von einer contentVersion-Zeichenfolge. Das Schema teilt dem Azure-Portal und den Editor-Erweiterungen mit, wie die Vorlage validiert und IntelliSense dafür bereitgestellt wird. Die fünf folgenden Hauptabschnitte sind parameters, variables, functions, resources und outputs.

Parameter machen Vorlagen wiederverwendbar, indem sie Eingaben zum Zeitpunkt der Bereitstellung akzeptieren. Jeder Parameter hat einen type (string, int, bool, object, array, secureString), einen optionalen defaultValue und optionale allowedValues zur Validierung. Wenn Sie secureString für Kennwörter verwenden, wird sichergestellt, dass der Wert niemals im Bereitstellungsverlauf protokolliert wird.

Variablen speichern Werte, die aus Parametern oder Vorlagenfunktionen berechnet werden. Dadurch vermeiden sie Wiederholungen und erleichtern die Wartung von Vorlagen. Variablen werden einmal ausgewertet und im gesamten Abschnitt resources mithilfe des Ausdrucks [variables('name')] referenziert. Ein häufig verwendetes Muster besteht darin, einen Ressourcennamen durch die Verkettung eines Parameters mit einem eindeutigen Suffix zu erstellen.

Das Array resources bildet das Herzstück einer ARM-Vorlage. Jedes Element beschreibt eine Azure-Ressource mit den erforderlichen Feldern type, apiVersion, name und location. apiVersion legt die Schemaversion des Ressourcenanbieters fest — verwenden Sie immer eine aktuelle stabile Version, um auf die neuesten Funktionen zugreifen zu können und veraltete Eigenschaften zu vermeiden.

Ausdrücke in ARM-Vorlagen stehen in eckigen Klammern [...] und unterstützen integrierte Funktionen für Zeichenfolgen, Arrays, Objekte und Ressourcen-IDs. Zu den häufig verwendeten Funktionen gehören concat(), resourceGroup(), resourceId(), uniqueString() und parameters(). Diese Funktionen werden zum Zeitpunkt der Bereitstellung serverseitig von ARM ausgewertet, nicht lokal.

Der Abschnitt outputs definiert Werte, die ARM nach einer erfolgreichen Bereitstellung zurückgibt. Outputs sind für das Verknüpfen von Vorlagen unverzichtbar: Sie stellen eine Netzwerkvorlage bereit und geben die Ressourcen-ID des Subnetzes aus, die Sie anschließend als Parameter an eine VM-Vorlage übergeben. Outputs können auf jeden Ausdruck verweisen, einschließlich Ressourceneigenschaften aus der Bereitstellung.

Für komplexe Architekturen unterstützt ARM verknüpfte Vorlagen (mit Verweisen auf externe Vorlagen-URLs) und geschachtelte Vorlagen (eine Vorlage, die mithilfe des Typs Microsoft.Resources/deployments in das Array resources eingebettet wird). So können Sie eine umfangreiche Infrastrukturbereitstellung in modulare, wiederverwendbare Bestandteile aufteilen und gleichzeitig eine einzige Orchestrierungsvorlage als Einstiegspunkt beibehalten.

Statt Parameter in der Befehlszeile zu übergeben, können Sie sie in einer separaten Parameterdatei speichern — einer JSON-Datei mit einem parameters-Objekt, das Name-Wert-Paare enthält. Parameterdateien können umgebungsspezifisch sein (z. B. dev.parameters.json, prod.parameters.json) und in der Quellcodeverwaltung gespeichert werden. Sensible Werte bleiben dabei in Verweisen auf Azure Key Vault und nicht im Klartext.

Verwenden Sie den Azure-CLI-Befehl az deployment group create, um eine Vorlage in einer Ressourcengruppe bereitzustellen. Führen Sie vor der Bereitstellung in der Produktion az deployment group validate aus, um Schema- und Logikfehler zu erkennen, und az deployment group what-if, um eine Vorschau der Ressourcenänderungen anzuzeigen. Diese drei Befehle bilden eine sichere Bereitstellungspipeline: validieren, Vorschau anzeigen, bereitstellen.

Befolgen Sie diese bewährten Methoden für ARM-Vorlagen: Verwenden Sie Parameter für umgebungsspezifische Werte, verwenden Sie Variablen, um Wiederholungen zu vermeiden, fixieren Sie API-Versionen auf stabile Versionen, verwenden Sie secureString für Kennwörter, fügen Sie Metadatenbeschreibungen hinzu und teilen Sie umfangreiche Vorlagen in verknüpfte Module auf. Speichern Sie Vorlagen in einem Git-Repository und stellen Sie sie über eine CI/CD-Pipeline bereit, um eine nachvollziehbare Prüfung zu ermöglichen.

In dieser Lektion haben Sie gelernt: ARM-Vorlagen sind JSON-Dokumente, die die Azure-Infrastruktur deklarativ definieren, Parameter und Variablen machen Vorlagen wiederverwendbar und wartbar, und der Ablauf validieren, what-if, bereitstellen ermöglicht sichere und wiederholbare Bereitstellungen. Als Nächstes beschäftigen wir uns mit Bicep, einer modernen Abstraktion über ARM-JSON.