Erweitern einer Pipeline für die Verwendung mehrerer Vorlagen

In diesem Lab lernen Sie, wie wichtig es ist, eine Pipeline auf mehrere Vorlagen zu erweitern und wie Sie Azure DevOps dafür verwenden. Dieses Lab behandelt grundlegende Konzepte und Best Practices für das Erstellen einer mehrstufigen Pipeline, einer Variablenvorlage, einer Auftragsvorlage und einer Phasenvorlage.

Diese Übung dauert ca. 20 Minuten.

Vorbereitung

Sie benötigen ein Azure-Abonnement, eine Azure DevOps-Organisation und die eShopOnWeb-Anwendung, um den Labs zu folgen.

Folgen Sie den Schritten, um Ihre Lab-Umgebung zu überprüfen.

Anweisungen

Übung 1: Erstellen einer mehrstufigen YAML-Pipeline

Aufgabe 1: Erstellen einer mehrstufigen YAML-Hauptpipeline

Navigieren Sie zum Azure DevOps-Portal unter https://dev.azure.com und öffnen Sie Ihre Organisation.
Öffnen Sie das Projekt eShopOnWeb.
Navigieren Sie zu Pipelines > Pipelines.
Wählen Sie Pipeline erstellen aus.
Wählen Sie Azure Repos Git (Yaml).
Wählen Sie das Repository eShopOnWeb aus.
Wählen Sie Starterpipeline aus.

Ersetzen Sie den Inhalt der Datei azure-pipelines.yml durch folgenden Code:

trigger:
- main

pool:
  vmImage: 'windows-latest'

stages:
- stage: Dev
  jobs:
  - job: Build
    steps:
    - script: echo Build
- stage: Test
  jobs:
  - job: Test
    steps:
    - script: echo Test
- stage: Production
  jobs:
  - job: Deploy
    steps:
    - script: echo Deploy

Klicken Sie auf Speichern und ausführen. Wählen Sie zunächst den direkten Commit zu Mainbranch und dann Speichern und ausführen aus.
Die Pipeline wird mit den drei Phasen (Entwicklung, Test und Produktion) und den entsprechenden Aufträgen ausgeführt. Warten Sie, bis die Pipeline abgeschlossen ist, und navigieren Sie zurück zur Seite Pipelines.
Wählen Sie … (Weitere Optionen) auf der rechten Seite der soeben erstellten Pipeline und anschließend Umbenennen/Verschieben aus.
Benennen Sie die Pipeline in eShopOnWeb-MultiStage-Main um, und wählen Sie Speichern aus.

Aufgabe 2: Erstellen einer Variablenvorlage

Wechseln Sie zu Repos > Dateien.
Erweitern Sie den Ordner .ado, und klicken Sie auf Neue Datei.
Geben Sie der Datei den Namen eshoponweb-variables.yml, und klicken Sie auf Erstellen.

Fügen Sie der Datei den folgenden Code hinzu:

variables:
  resource-group: 'YOUR-RESOURCE-GROUP-NAME'
  location: 'southcentralus' #name of the Azure region you want to deploy your resources
  templateFile: '.azure/bicep/webapp.bicep'
  subscriptionid: 'YOUR-SUBSCRIPTION-ID'
  azureserviceconnection: 'YOUR-AZURE-SERVICE-CONNECTION-NAME'
  webappname: 'YOUR-WEB-APP-NAME'

Ersetzen Sie die Werte der Variablen jeweils durch die Werte für Ihre Umgebung:
- Ersetzen Sie YOUR-RESOURCE-GROUP-NAME- durch den Namen der Ressourcengruppe, die Sie in diesem Lab verwenden möchten, z. B. rg-eshoponweb-multi.
- Legen Sie den Namen der Variable Standort auf den Namen der Azure-Region fest, in der Sie Ihre Ressourcen bereitstellen möchten, z. B. southcentralus.
- Ersetzen Sie YOUR-SUBSCRIPTION-ID durch Ihre Azure-Abonnement-ID.
- Ersetzen Sie YOUR-AZURE-SERVICE-CONNECTION-NAME durch azure subs.
- Ersetzen Sie YOUR-WEB-APP-NAME durch einen global eindeutigen Namen der Web-App, die bereitgestellt werden soll, z. B. die Zeichenfolge eshoponweb-lab-multi- gefolgt von einer sechsstelligen Zufallszahl.
Wählen Sie Commit aus, geben Sie im Textfeld „Commitkommentar“ [skip ci] ein, und wählen Sie dann Commit aus.

[!NOTE] Durch Hinzufügen des Kommentars [skip ci] zum Commit verhindern Sie die automatische Pipelineausführung, die zu diesem Zeitpunkt standardmäßig nach jeder Änderung am Repository ausgeführt wird.

Aufgabe 3: Vorbereiten der Pipeline für die Verwendung von Vorlagen

Wechseln Sie im Azure DevOps-Portal auf der Projektseite eShopOnWeb zu Pipelines > Pipelines.
Wählen Sie im Stammverzeichnis des Repositorys die Datei azure-pipelines.yml aus, die die Definition der Pipeline eShopOnWeb-MultiStage-Main enthält.
Wählen Sie Bearbeiten aus.

Ersetzen Sie den Inhalt der Datei azure-pipelines.yml durch folgenden Code:

trigger:
- main
variables:
- template: .ado/eshoponweb-variables.yml
   
stages:
- stage: Dev
  jobs:
  - template: .ado/eshoponweb-ci.yml
- stage: Test
  jobs:
  - template: .ado/eshoponweb-cd-webapp-code.yml
- stage: Production
  jobs:
  - job: Deploy
    steps:
    - script: echo Deploy to Production or Swap

Wählen Sie Commit aus, geben Sie im Textfeld „Commitkommentar“ [skip ci] ein, und wählen Sie dann Commit aus.

Aufgabe 4: Aktualisieren von CI/CD-Vorlagen

Wählen Sie im Abschnitt Repos des Projekts eShopOnWeb das Verzeichnis .ado und anschließend die Datei eshoponweb-ci.yml aus.

Entfernen Sie den gesamten Text über dem Abschnitt Aufträge.

#NAME THE PIPELINE SAME AS FILE (WITHOUT ".yml")
# trigger:
# - main
   
resources:
  repositories:
    - repository: self
      trigger: none
   
stages:
- stage: Build
  displayName: Build .Net Core Solution

Wählen Sie Commit aus, geben Sie im Textfeld „Commitkommentar“ [skip ci] ein, und wählen Sie dann Commit aus.
Wählen Sie im Abschnitt Repos des Projekts eShopOnWeb das Verzeichnis .ado und anschließend die Datei eshoponweb-cd-webapp-code.yml aus.

Entfernen Sie den gesamten Text über dem Abschnitt Aufträge.

#NAME THE PIPELINE SAME AS FILE (WITHOUT ".yml")
   
# Trigger CD when CI executed successfully
resources:
  pipelines:
    - pipeline: eshoponweb-ci
      source: eshoponweb-ci # given pipeline name
      trigger: true

variables:
  resource-group: 'rg-eshoponweb'
  location: 'southcentralus'
  templateFile: '.azure/bicep/webapp.bicep'
  subscriptionid: ''
  azureserviceconnection: 'azure subs'
  webappname: 'eshoponweb-lab'
  # webappname: 'webapp-windows-eshop'
   
stages:
- stage: Deploy
  displayName: Deploy to WebApp`

Ersetzen Sie den vorhandenen Inhalt des Schritts #download artefacts durch folgenden Inhalt:

    - download: current
      artifact: Website
    - download: current
      artifact: Bicep

Wählen Sie Commit aus, geben Sie im Textfeld „Commitkommentar“ [skip ci] ein, und wählen Sie dann Commit aus.

Aufgabe 5: Ausführen der Hauptpipeline

Navigieren Sie zu Pipelines > Pipelines.
Öffnen Sie die Pipeline eShopOnWeb-MultiStage-Main.
Klicken Sie auf Pipeline ausführen.
Sobald die Pipeline die Phase Bereitstellen in der UmgebungTest erreicht hat, öffnen Sie die Pipeline, und beachten Sie die Meldung „Diese Pipeline benötigt die Berechtigung zum Zugriff auf eine Ressource, bevor diese Ausführung mit dem Test fortgesetzt werden kann“. Wählen Sie zunächst Anzeigen und dann Zulassen aus, damit die Pipeline ausgeführt werden kann.

[!NOTE] Wenn Aufträge in der Bereitstellungsphase fehlschlagen, navigieren Sie zur Seite mit der Pipelineausführung, und wählen Sie Fehlgeschlagene Aufträge erneut ausführen* aus.
Sobald die Pipeline die Phase Bereitstellen in der UmgebungProduktion erreicht hat, öffnen Sie die Pipeline, und beachten Sie die Meldung „Diese Pipeline benötigt die Berechtigung zum Zugriff auf eine Ressource, bevor diese Ausführung mit der Produktion fortgesetzt werden kann“. Wählen Sie zunächst Anzeigen und dann Zulassen aus, damit die Pipeline ausgeführt werden kann.
Warten Sie, bis die Pipeline abgeschlossen ist, und überprüfen Sie die Ergebnisse.

Übung 2: Bereinigung von Azure- und Azure DevOps-Ressourcen

In dieser Übung entfernen Sie Azure- und Azure DevOps-Ressourcen, die in diesem Lab erstellt wurden.

Aufgabe 1: Entfernen Sie Azure-Ressourcen,

Navigieren Sie im Azure-Portal zur Ressourcengruppe rg-eshoponweb-multi mit bereitgestellten Ressourcen, und wählen Sie Ressourcengruppe löschen aus, um alle in diesem Lab erstellten Ressourcen zu löschen.

Aufgabe 2: Entfernen von Azure DevOps-Pipelines

Navigieren Sie zum Azure DevOps-Portal unter https://dev.azure.com und öffnen Sie Ihre Organisation.
Öffnen Sie das Projekt eShopOnWeb.
Navigieren Sie zu Pipelines > Pipelines.
Wechseln Sie zu Pipelines > Pipelines, und löschen Sie die vorhandenen Pipelines.

Aufgabe 3: Neuerstellen des Azure DevOps-Repositorys

Wählen Sie im Azure DevOps-Portal im Projekt eShopOnWeb- in der unteren linken Ecke die Option Projekteinstellungen aus.
Wählen Sie im vertikalen Menü Projekteinstellungen auf der linken Seite im Abschnitt Repos die Option Repositorys aus.
Zeigen Sie im Bereich Alle Repositorys mit der Maus auf das rechte Ende des Repositoryeintrags eShopOnWeb, bis das Symbol mit den Auslassungszeichen Weitere Optionen angezeigt wird, wählen Sie es aus, und wählen Sie im Menü Weitere Option die Option Umbenennen aus.
Geben Sie im Fenster eShopOnWeb-Repository umbenennen im Textfeld Repositoryname den Text eShopOnWeb_old ein, und wählen Sie Umbenennen aus.
Wählen Sie im Bereich Alle Repositorys die Option + Erstellen aus.
Geben Sie im Bereich Repository erstellen im Textfeld Repositoryname den Text eShopOnWeb ein, deaktivieren Sie das Kontrollkästchen README hinzufügen, und wählen Sie Erstellen aus.
Zeigen Sie im Bereich Alle Repositorys mit der Maus auf des rechte Ende des eShopOnWeb_old-Repositoryeintrags, bis das Symbol mit den Auslassungszeichen Weitere Optionen angezeigt wird, wählen Sie es aus, und wählen Sie im Menü Weitere Option die Option Umbenennen aus.
Geben Sie im Fenster eShopOnWeb_old-Repository löschen den Text eShopOnWeb_old ein, und wählen Sie Löschen aus.
Wählen Sie im linken Navigationsmenü des Azure DevOps-Portals die Option Repositorys aus.
Wählen Sie im Bereich eShopOnWeb ist leer. Code hinzufügen! die Option Repository importieren aus.
Fügen Sie im Fenster Git-Repository importieren die folgende URL https://github.com/MicrosoftLearning/eShopOnWeb ein, und wählen Sie Importieren aus:

Überprüfung

In diesem Lab haben Sie gelernt, wie Sie eine Pipeline mithilfe von Azure DevOps auf mehrere Vorlagen erweitern. Dieses Lab wurden grundlegende Konzepte und Best Practices für das Erstellen einer mehrstufigen Pipeline, einer Variablenvorlage, einer Auftragsvorlage und einer Phasenvorlage behandelt.