Lernprogramm: Kontinuierliche Integration von ARM-Vorlagen in Azure-Pipelines

2025-04-30

Im vorherigen Lernprogramm stellen Sie eine verknüpfte Vorlage bereit. In diesem Lernprogramm erfahren Sie, wie Sie Azure-Pipelines zum kontinuierlichen Erstellen und Bereitstellen von Azure Resource Manager-Vorlagenprojekten (ARM-Vorlagen) verwenden.

Azure DevOps bietet Entwicklerdienste zur Unterstützung von Teams bei der Arbeitsplanung, der Zusammenarbeit bei der Code-Entwicklung und der Erstellung und Bereitstellung von Anwendungen. Entwickler können in der Cloud mit Azure DevOps Services arbeiten. Azure DevOps bietet einen integrierten Satz von Features, auf die Sie über Ihren Webbrowser oder IDE-Client zugreifen können. Azure Pipelines ist eines dieser Features. Azure Pipelines ist ein umfassend ausgestatteter Dienst für kontinuierliche Integration (Continuous Integration, CI) und kontinuierliche Bereitstellung (Continuous Delivery, CD). Es funktioniert mit Ihrem bevorzugten Git-Anbieter und kann für die meisten wichtigen Clouddienste bereitgestellt werden. Anschließend können Sie den Build, das Testen und die Bereitstellung Ihres Codes für Microsoft Azure, Google Cloud Platform oder Amazon Web Services automatisieren.

Hinweis

Wählen Sie einen Projektnamen aus. Ersetzen Sie in diesem Tutorial jedes Vorkommen von ARMPipelineProj durch Ihren Projektnamen. Dieser Projektname wird verwendet, um Ressourcennamen zu generieren. Eine der Ressourcen ist ein Speicherkonto. Die Namen von Speicherkonten müssen zwischen 3 und 24 Zeichen lang sein und nur Zahlen und Kleinbuchstaben verwenden. Der Name muss eindeutig sein. In der Vorlage ist der Name des Speicherkontos der Projektname, an den store angehängt wird, und der Projektname muss eine Länge von 3 bis 11 Zeichen haben. Daher muss der Projektname den Anforderungen des Speicherkontonamens entsprechen und weniger als 11 Zeichen enthalten.

Dieses Tutorial enthält die folgenden Aufgaben:

Vorbereiten eines GitHub-Repositorys
Ein Azure DevOps-Projekt erstellen
Erstellen einer Azure-Pipeline
Überprüfen der Pipelinebereitstellung
Vorlage aktualisieren und erneut bereitstellen
Bereinigen von Ressourcen

Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto , bevor Sie beginnen.

Voraussetzungen

Damit Sie die Anweisungen in diesem Artikel ausführen können, benötigen Sie Folgendes:

Ein GitHub-Konto, bei dem Sie es zum Erstellen eines Repositorys für Ihre Vorlagen verwenden. Wenn Sie keins haben, können Sie eine kostenlos erstellen. Weitere Informationen zur Verwendung von GitHub-Repositorys finden Sie unter Erstellen von GitHub-Repositorys.
Installieren Sie Git. Diese Lernprogrammanleitung verwendet Git Bash oder Git Shell. Anweisungen finden Sie unter Installieren von Git.
Eine Azure DevOps-Organisation. Wenn Sie noch keines besitzen, können Sie es kostenlos erstellen. Siehe Erstellen einer Organisation oder Projektsammlung.
(optional) Visual Studio Code mit der Erweiterung Resource Manager Tools. Siehe Schnellstart: Erstellen von ARM-Vorlagen mit Visual Studio Code.

Vorbereiten eines GitHub-Repositorys

GitHub wird verwendet, um Ihren Projektquellcode einschließlich Ressourcen-Manager-Vorlagen zu speichern. Weitere unterstützte Repositorys finden Sie unter Repositorys, die von Azure DevOps unterstützt werden.

Erstellen eines GitHub-Repositorys

Wenn Sie nicht über ein GitHub-Konto verfügen, lesen Sie die Voraussetzungen.

Melden Sie sich bei GitHub an.
Wählen Sie Ihr Kontobild in der oberen rechten Ecke aus, und wählen Sie dann Ihre Repositorys aus.
Wählen Sie "Neu" aus, eine grüne Schaltfläche.
Geben Sie im Repositorynamen einen Repositorynamen ein. Beispiel: ARMPipeline-Repository. Denken Sie daran, ARMPipeline durch Ihren Projektnamen zu ersetzen. Sie können entweder öffentlich oder privat auswählen, um dieses Lernprogramm zu durchlaufen. Wählen Sie dann "Repository erstellen" aus.
Notieren Sie sich die URL. Die Repository-URL ist das folgende Format - https://github.com/[YourAccountName]/[YourRepositoryName].

Dieses Repository wird als Remote-Repository bezeichnet. Jedes der Entwickler desselben Projekts kann ein eigenes lokales Repository klonen und die Änderungen am Remote-Repository zusammenführen.

Klonen des Remote-Repositorys

Öffnen Sie Git Shell oder Git Bash. Siehe Voraussetzungen.
Überprüfen Sie, ob Ihr aktueller Ordner GitHub ist.
Führen Sie den folgenden Befehl aus:
```
git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
cd [YourGitHubRepositoryName]
mkdir create_web_app
cd create_web_app
pwd
```
Ersetzen Sie [YourAccountName] durch den Namen Ihres GitHub-Kontos und [YourGitHubRepositoryName] durch den Namen Ihres Repositorys, das Sie im vorherigen Verfahren erstellt haben.

Der ordner create_web_app ist der Ordner, in dem die Vorlage gespeichert ist. Der pwd Befehl zeigt den Ordnerpfad an. Der Pfad ist der Ort, an dem Sie die Vorlage im folgenden Verfahren speichern.

Herunterladen einer Schnellstartvorlage

Anstatt die Vorlagen zu erstellen, können Sie die Vorlagen herunterladen und im Ordner create_web_app speichern.

Sowohl der Ordnername als auch der Dateiname werden genau so in der Pipeline verwendet. Wenn Sie diese Namen ändern, müssen Sie die in der Pipeline verwendeten Namen aktualisieren.

Übertragen der Vorlage an das Remote-Repository

Das azuredeploy.json wurde dem lokalen Repository hinzugefügt. Als Nächstes laden Sie die Vorlage in das Remote-Repository hoch.

Öffnen Sie Git Shell oder Git Bash, wenn sie nicht geöffnet ist.
Wechseln Sie in das Verzeichnis create_web_app in Ihrem lokalen Repository.
Überprüfen Sie, ob sich die azuredeploy.json Datei im Ordner befindet.
Führen Sie den folgenden Befehl aus:
```
git add .
git commit -m "Add web app templates."
git push origin main
```
Daraufhin wird unter Umständen eine LF-Warnung angezeigt. Sie können die Warnung ignorieren. haupt ist der Hauptzweig. Normalerweise erstellen Sie für jedes Update eine Verzweigung. Um das Tutorial zu vereinfachen, verwenden Sie direkt den Hauptzweig.
Navigieren Sie über einen Browser zu Ihrem GitHub-Repository. Die URL ist https://github.com/[YourAccountName]/[YourGitHubRepository]. Sie sehen die create_web_app Ordner und die beiden Dateien im Ordner.
Wählen Sie azuredeploy.json aus, um die Vorlage zu öffnen.
Wählen Sie die Schaltfläche Roh aus. Die URL beginnt mit https://raw.githubusercontent.com.
Erstellen Sie eine Kopie der URL. Sie müssen diesen Wert angeben, wenn Sie die Pipeline später im Lernprogramm konfigurieren.

Bisher haben Sie ein GitHub-Repository erstellt und die Vorlagen in das Repository hochgeladen.

Erstellen eines DevOps-Projekts

Eine DevOps-Organisation ist erforderlich, bevor Sie mit dem nächsten Verfahren fortfahren können. Wenn Sie keins haben, lesen Sie die Voraussetzungen.

Melden Sie sich bei Azure DevOps an.
Wählen Sie links eine DevOps-Organisation und dann "Neues Projekt" aus. Wenn Sie keine Projekte haben, wird die Projekterstellungsseite automatisch geöffnet.
Geben Sie die folgenden Werte ein:
- Projektname: Geben Sie einen Projektnamen ein. Sie können den Projektnamen verwenden, den Sie am Anfang des Lernprogramms ausgewählt haben.
- Sichtbarkeit: Wählen Sie "Privat" aus.
Verwenden Sie den Standardwert für die anderen Eigenschaften.
Wählen Sie "Erstellen" aus.

Erstellen Sie eine Dienstverbindung, die zum Bereitstellen von Projekten in Azure verwendet wird.

Wählen Sie " Projekteinstellungen" unten im linken Menü aus.
Wählen Sie "Dienstverbindungen " unter "Pipelines" aus.
Wählen Sie "Dienstverbindung erstellen", wählen Sie "Azure Resource Manager" und dann "Weiter" aus.
Wählen Sie Dienstprinzipal (automatisch) und dann Weiter aus.
Geben Sie die folgenden Werte ein:
- Bereichsebene: Wählen Sie "Abonnement" aus.
- Abonnement: Wählen Sie Ihr Abonnement aus.
- Ressourcengruppe: Lassen Sie das Feld leer.
- Verbindungsname: Geben Sie einen Verbindungsnamen ein. Beispiel: ARMPipeline-Conn. Notieren Sie diesen Namen, sie benötigen den Namen, wenn Sie Ihre Pipeline erstellen.
- Gewähren der Zugriffsberechtigung für alle Pipelines. (ausgewählt)
Wählen Sie "Speichern" aus.

Erstellen einer Pipeline

Bis jetzt haben Sie die folgenden Aufgaben abgeschlossen. Wenn Sie die vorherigen Abschnitte überspringen, da Sie mit GitHub und DevOps vertraut sind, müssen Sie die Aufgaben ausführen, bevor Sie fortfahren.

Erstellen Sie ein GitHub-Repository, und speichern Sie die Vorlagen im create_web_app Ordner im Repository.
Erstellen Sie ein DevOps-Projekt, und erstellen Sie eine Azure Resource Manager-Dienstverbindung.

So erstellen Sie eine Pipeline mit einem Schritt zum Bereitstellen einer Vorlage:

Wählen Sie "Pipelines" im linken Menü aus.
Wählen Sie "Pipeline erstellen" aus.
Wählen Sie auf der Registerkarte " Verbinden " GitHub aus. Wenn Sie gefragt werden, geben Sie Ihre GitHub-Anmeldeinformationen ein, und folgen Sie dann den Anweisungen. Wenn der folgende Bildschirm angezeigt wird, wählen Sie nur Repositorys aus, und vergewissern Sie sich, dass Sich Ihr Repository in der Liste befindet, bevor Sie "Genehmigen und Installieren" auswählen.
Wählen Sie auf der Registerkarte "Auswählen " Ihr Repository aus. Der Standardname ist [YourAccountName]/[YourGitHubRepositoryName].
Wählen Sie auf der Registerkarte " Konfigurieren " die Option "Startpipeline" aus. Sie zeigt die azure-pipelines.yml Pipelinedatei mit zwei Skriptschritten an.
Löschen Sie die beiden Skriptschritte aus der datei .yml .
Bewegen Sie den Cursor in die Zeile nach Schritte:.
Wählen Sie Assistent anzeigen auf der rechten Seite des Bildschirms aus, um den Bereich Aufgaben zu öffnen.
Wählen Sie die ARM-Vorlagenbereitstellung aus.
Geben Sie die folgenden Werte ein:
- deploymentScope: Wählen Sie "Ressourcengruppe" aus. Weitere Informationen zu den Bereichen finden Sie unter Bereitstellungsbereiche.
- Azure Resource Manager-Verbindung: Wählen Sie den Dienstverbindungsnamen aus, den Sie zuvor erstellt haben.
- Abonnement: Geben Sie die Zielabonnement-ID an.
- Aktion: Wählen Sie die Aktion Ressourcengruppe erstellen oder aktualisieren, die zwei Aktionen ausführt - 1. erstellen Sie eine Ressourcengruppe, wenn ein neuer Ressourcengruppenname angegeben wird; 2. stellen Sie die angegebene Vorlage bereit.
- Ressourcengruppe: Geben Sie einen neuen Ressourcengruppennamen ein. Beispiel: ARMPipeline-rg.
- Ort: Wählen Sie einen Speicherort für die Ressourcengruppe aus, z. B. "Zentral-USA".
- Vorlagenspeicherort: Wählen Sie die URL der Datei aus, was bedeutet, dass die Aufgabe mithilfe der URL nach der Vorlagendatei sucht. Da relativePath in der Hauptvorlage verwendet wird und relativePath nur für URI-basierte Bereitstellungen unterstützt wird, müssen Sie hier DIE URL verwenden.
- Vorlagenlink: Geben Sie die URL ein, die Sie am Ende des Abschnitts " Vorbereiten eines GitHub-Repositorys " erhalten haben. Sie beginnt mit https://raw.githubusercontent.com .
- Link "Vorlagenparameter": Lassen Sie dieses Feld leer. Sie geben die Parameterwerte unter Vorlagenparameter überschreiben an.
- Parameter der Vorlage außer Kraft setzen: Geben Sie -projectName [EnterAProjectName]ein.
- Bereitstellungsmodus: Wählen Sie inkrementell aus.
- Bereitstellungsname: Enter DeployPipelineTemplate. Wählen Sie "Erweitert" aus, bevor der Bereitstellungsname angezeigt werden kann.
Wählen Sie "Hinzufügen" aus.

Weitere Informationen zur Aufgabe finden Sie unter Azure Resource Group-Bereitstellungsaufgabe und Azure Resource Manager-Vorlagenbereitstellungsaufgabe

Die .yml Datei ist ähnlich wie die folgenden:
Wählen Sie "Speichern" und "Ausführen" aus.
Wählen Sie im Bereich "Speichern und Ausführen die Option "Speichern und Ausführen" erneut aus. Eine Kopie der YAML-Datei wird im verbundenen Repository gespeichert. Sie können die YAML-Datei anzeigen, indem Sie zu Ihrem Repository navigieren.
Vergewissern Sie sich, dass die Pipeline erfolgreich ausgeführt wird.

Überprüfen Sie die Bereitstellung

Melden Sie sich beim Azure-Portal an.
Öffnen Sie die Ressourcengruppe. Der Name ist das, was Sie in der YaML-Pipelinedatei angegeben haben. Es wird ein Speicherkonto erstellt. Der Name des Speicherkontos beginnt mit store.
Wählen Sie den Namen des Speicherkontos aus, um ihn zu öffnen.
Wählen Sie "Eigenschaften" aus. Beachten Sie, dass unter Replikation die Option Lokal redundanter Speicher (LRS) ausgewählt ist.

Aktualisieren und erneutes Bereitstellen

Wenn Sie die Vorlage aktualisieren und die Änderungen an das Remote-Repository übertragen, aktualisiert die Pipeline automatisch die Ressourcen, das Speicherkonto in diesem Fall.

Öffnen Sie linkedStorageAccount.json aus Ihrem lokalen Repository in Visual Studio Code oder einem beliebigen Text-Editor.
Aktualisieren Sie den Standardwert (defaultValue) von storageAccountType auf Standard_GRS. Sehen Sie sich den folgenden Screenshot an:
Speichern Sie die Änderungen.
Übertragen Sie die Änderungen an das Remote-Repository, indem Sie die folgenden Befehle von Git Bash/Shell ausführen.
```
git pull origin main
git add .
git commit -m "Update the storage account type."
git push origin main
```
Der erste Befehl (pull) synchronisiert das lokale Repository mit dem Remote-Repository. Die YaML-Pipelinedatei wurde nur dem Remote-Repository hinzugefügt. Das Ausführen des pull Befehls lädt eine Kopie der YAML-Datei in den lokalen Branch herunter.

Der vierte Befehl (push) lädt die überarbeitete linkedStorageAccount.json Datei in das Remote-Repository hoch. Nachdem der Mainbranch des Remoterepositorys aktualisiert wurde, wird die Pipeline erneut ausgelöst.

Um die Änderungen zu überprüfen, können Sie die Replikationseigenschaft des Speicherkontos überprüfen. Siehe Überprüfen der Bereitstellung.

Bereinigen von Ressourcen

Wenn Sie die Azure-Ressourcen nicht mehr benötigen, löschen Sie die Ressourcengruppe, um die bereitgestellten Ressourcen zu bereinigen.

Wählen Sie im Azure-Portal im linken Menü die Ressourcengruppe aus.
Geben Sie den Ressourcengruppennamen im Feld "Filter nach Name " ein.
Klicken Sie auf den Namen der Ressourcengruppe.
Wählen Sie im oberen Menü die Option "Ressourcengruppe löschen " aus.

Möglicherweise möchten Sie auch das GitHub-Repository und das Azure DevOps-Projekt löschen.

Nächste Schritte

Herzlichen Glückwunsch, Sie haben dieses Tutorial zur Bereitstellung von Resource-Manager-Vorlagen abgeschlossen. Lassen Sie uns wissen, ob Sie im Feedbackabschnitt Kommentare und Vorschläge haben. Danke! Sie sind bereit, zu erweiterten Konzepten zu Vorlagen zu springen. Das nächste Lernprogramm enthält ausführlichere Informationen zur Verwendung der Vorlagenreferenzdokumentation, um beim Definieren der bereitzustellenden Ressourcen zu helfen.

Verwenden der Vorlagenreferenz