Freigeben über

Tutorial: Bereitstellen von Umgebungen in CI/CD mithilfe von Azure Pipelines

In diesem Tutorial erfahren Sie, wie Sie Azure Deployment Environments in Ihre Azure Pipelines CI/CD-Pipeline integrieren.

Continuous Integration und Continuous Delivery (CI/CD) ist ein Softwareentwicklungsansatz, mit dem Teams den Prozess zum Erstellen, Testen und Bereitstellen von Softwareänderungen automatisieren können. CI/CD ermöglicht es Ihnen, Softwareänderungen häufiger und mit größerer Sicherheit zu veröffentlichen.

Bevor Sie mit diesem Tutorial beginnen, machen Sie sich anhand des Artikels Schlüsselkonzepte für Azure Deployment Environments mit den Ressourcen und Konzepten von Bereitstellungsumgebungen vertraut.

In diesem Tutorial lernen Sie Folgendes:

  • Erstellen und Konfigurieren eines Azure Repos-Repositorys
  • Konfigurieren von Umgebungstypen
  • Konfigurieren einer Dienstverbindung
  • Erstellen einer Pipeline
  • Erstellen einer Umgebung

Voraussetzungen

Erstellen und Konfigurieren eines Azure Repos-Repositorys

  1. Melden Sie sich bei Ihrer Azure DevOps-Organisation (https://dev.azure.com/<your-organization>) an. Ersetzen Sie dies <your-organization> durch den Projektbezeichner.
  2. Wählen Sie Ihr Projekt aus.
  3. Wählen Sie Repos>Dateien aus.
  4. Wählen Sie in Repository importieren den Befehl Importieren aus.
  5. Wählen Sie in Git-Repository importierenFolgendes aus, oder geben Sie Folgendes ein:

Konfigurieren von Umgebungstypen

Umgebungstypen definieren die Typen von Umgebungen, die Ihre Entwicklungsteams bereitstellen können. Sie können auf jeden Umgebungstyp unterschiedliche Einstellungen anwenden. Sie können Umgebungstypen auf Dev Center-Ebene und auf Projektebene erstellen.

Zum Erstellen von Dev Center-Umgebungstypen:

  1. Melden Sie sich beim Azure-Portal an.

  2. Wählen Sie unter Dev Centers Ihr Dev Center aus.

  3. Wählen Sie im linken Menü unter "Umgebungskonfiguration" die Option "Umgebungstypen" und dann " Erstellen" aus.

  4. Führen Sie die folgenden Schritte aus, um drei Umgebungstypen zu erstellen: Sandbox, FunctionApp und WebApp.

    1. Geben Sie unter Umgebungstyp erstellen die folgenden Informationen ein, und wählen Sie dann Hinzufügen aus.

      Name Wert
      Name Geben Sie einen Namen für den Umgebungstyp ein.
      Stichwörter Geben Sie einen Tagnamen und -wert ein.

    2. Vergewissern Sie sich, dass der Umgebungstyp in der Liste angezeigt wird.

Zum Erstellen von Projektumgebungstypen:

  1. Wählen Sie im linken Menü unter VerwaltenProjekte aus, und wählen Sie dann das Projekt aus, das Sie verwenden möchten.
  2. Wählen Sie im linken Menü unter Umgebungskonfiguration die Option Umgebungstypen und dann Hinzufügen aus.
  3. Führen Sie die folgenden Schritte aus, um drei Umgebungstypen hinzuzufügen: Sandbox, FunctionApp und WebApp.

    1. Geben Sie in Umgebungstyp hinzufügen zu <Projektname> die folgenden Informationen ein, oder wählen Sie sie aus:

      Name Wert
      Typ Wählen Sie einen Umgebungstyp auf Dev Center-Ebene aus, der für das jeweilige Projekt aktiviert werden soll.
      Bereitstellungsabonnement Wählen Sie das Abonnement aus, in dem die Umgebung erstellt werden soll.
      Bereitstellungsidentität Wählen Sie eine systemseitig zugewiesene oder benutzerseitig zugewiesene verwaltete Identität aus, die verwendet wird, um Bereitstellungen im Auftrag des Benutzers auszuführen.
      Berechtigungen für Umgebungsressourcen>Rollen für die Umgebungserstellung Wählen Sie die Rollen aus, die Zugriff auf die Umgebungsressourcen erhalten.
      Berechtigungen für Umgebungsressourcen>Zusätzlicher Zugriff Wählen Sie die Benutzer*innen oder die Microsoft Entra-Gruppen aus, denen bestimmte Rollen für die Umgebungsressourcen zugewiesen werden.
      Stichwörter Geben Sie einen Tagnamen und -wert ein. Diese Tags gelten für alle Ressourcen, die als Teil der Umgebungen erstellt werden.

    2. Vergewissern Sie sich, dass der Umgebungstyp in der Liste angezeigt wird.

Konfigurieren einer Dienstverbindung

In Azure Pipelines erstellen Sie eine Dienstverbindung in Ihrem Azure DevOps-Projekt, um auf Ressourcen in Ihrem Azure-Abonnement zuzugreifen.

  1. Wenn Sie keine vom Benutzer zugewiesene verwaltete Identität für das Projekt haben, fügen Sie eine hinzu.

    Hinweis

    Sie können eine von drei Optionen für die Identität verwenden: App-Registrierung, benutzerseitig zugewiesene verwaltete Identität und systemseitig zugewiesene verwaltete Identität. Die App-Registrierung ist die sicherste Option. Um die App-Registrierung verwenden zu können, müssen Sie über die entsprechenden Berechtigungen verfügen. Weitere Informationen finden Sie unter Azure Resource Manager Sonderfällefür Dienstverbindungen.

  2. Melden Sie sich bei Ihrer Azure DevOps-Organisation (https://dev.azure.com/<your-organization>) an. Ersetzen Sie dies <your-organization> durch den Projektbezeichner.

  3. Wählen Sie Ihr Projekt aus.

  4. Wählen Sie Projekteinstellungen>Dienstverbindungen>Erstellen von Dienstverbindung aus.

  5. Wählen Sie im Bereich Neue Dienstverbindung die Option Azure Resource Manager aus, und klicken Sie dann auf Weiter.

  6. Geben Sie die folgenden Details zur Dienstverbindung ein, und wählen Sie dann Speichern aus, um die Dienstverbindung zu erstellen.

    Feld Wert
    identity / type Verwaltete Identität
    Abonnement für verwaltete Identität Geben Sie das Azure-Abonnement ein, das die verwaltete Identität enthält.
    Ressourcengruppe für verwaltete Identität Geben Sie die Ressourcengruppe ein, die die verwaltete Identität enthält.
    Verwaltete Identität Geben Sie den Namen der verwalteten Identität ein.
    Bereichsebene für die Dienstverbindung Abonnement
    Abonnement für Dienstverbindung Geben Sie die ID des Azure-Abonnements ein, das Ihre Dev Center-Ressource hosten soll.
    Name der Dienstverbindung Geben Sie für die Dienstverbindung einen eindeutigen Namen ein.
    Zugriffserlaubnis für alle Pipelines gewähren Aktivieren Sie dieses Kontrollkästchen.

  7. Wählen Sie Speichern aus.

Gewähren des Zugriffs auf das Bereitstellungsumgebungsprojekt für die Dienstverbindung

Bereitstellungsumgebungen verwenden die rollenbasierte Zugriffssteuerung, um Berechtigungen für die Ausführung bestimmter Aktivitäten für Die Ressource "Bereitstellungsumgebungen" zu erteilen. Um Änderungen an einer CI/CD-Pipeline vorzunehmen, gewähren Sie der Verwalteten Identität die Rolle "Deployment Environments User".

  1. Wechseln Sie im Azure-Portalzu Ihrem Bereitstellungsumgebungsprojekt.
  2. Klicken Sie auf Zugriffssteuerung (IAM)>Hinzufügen>Rollenzuweisung hinzufügen.
  3. Wählen Sie auf der Registerkarte Rolle in der Liste der Auftragsfunktionsrollen die Option Deployment Environments-Benutzer aus.
  4. Wählen Sie auf der Registerkarte Mitgliederverwaltete Identität und Mitgliederauswählen aus.
  5. Wählen Sie auf der Registerkarte "Verwaltete Identitäten auswählen " unter "Verwaltete Identität" die Projektidentität aus, wählen Sie den Projektnamen und dann "Auswählen" aus.
  6. Wählen Sie auf der Registerkarte Überprüfen + zuweisen die Option Überprüfen + zuweisen aus, um die Rollenzuweisung hinzuzufügen.

Sie können jetzt die Dienstverbindung in Ihrer Azure Pipelines-Workflowdefinition verwenden, um auf Ihre ADE-Umgebungen zuzugreifen.

Gewähren des Zugriffs auf das Bereitstellungsumgebungsprojekt für Ihr Konto

Um Umgebungen anzuzeigen, die von anderen Benutzern erstellt wurden, einschließlich der Dienstverbindung, müssen Sie Ihrem Konto Lesezugriff auf das Projekt "Deployment Environments" gewähren.

  1. Wechseln Sie im Azure-Portalzu Ihrem Bereitstellungsumgebungsprojekt.
  2. Klicken Sie auf Zugriffssteuerung (IAM)>Hinzufügen>Rollenzuweisung hinzufügen.
  3. Wählen Sie auf der Registerkarte Rolle in der Liste der Auftragsfunktionsrollen die Option Deployment Environments-Leser aus.
  4. Wählen Sie auf der Registerkarte MitgliederMitglieder auswählen aus, und suchen Sie dann nach Ihrem eigenen Konto.
  5. Wählen Sie Ihr Konto aus der Liste, und wählen Sie dann Auswählen aus.
  6. Wählen Sie auf der Registerkarte Überprüfen + zuweisen die Option Überprüfen + zuweisen aus, um die Rollenzuweisung hinzuzufügen.

Sie können jetzt die Umgebungen anzeigen, die von Ihrem Azure Pipelines-Workflow erstellt wurden.

Konfigurieren einer Pipeline

Bearbeiten Sie die azure-pipelines.yml-Datei in Ihrem Azure Repos-Repository, um Ihre Pipeline anzupassen.

In der Pipeline definieren Sie die Schritte zum Erstellen der Umgebung. In dieser Pipeline definieren Sie die Schritte zur Erstellung der Umgebung als Auftrag, d. h. eine Reihe von Schritten, die nacheinander als Einheit ablaufen.

So passen Sie die Pipeline an:

  • Geben Sie die zu verwendende Dienstverbindung an.
  • Verwenden Sie ein Inlineskript, um einen Azure CLI-Befehl auszuführen, der die Umgebung erstellt.

Azure CLI ist ein Befehlszeilentool, das eine Reihe von Befehlen zum Arbeiten mit Azure-Ressourcen bereitstellt. Weitere Informationen zu Azure CLI Befehlen finden Sie unter az devcenter.

  1. Wählen Sie in Ihrem Azure DevOps-Projekt Repos>Files aus.

  2. Wählen Sie im Bereich Dateien im Ordner ado die azure-pipelines.yml Datei aus.

  3. Bearbeiten Sie in der azure-pipelines.yml Datei den vorhandenen Inhalt:

    • Ersetzen Sie <AzureServiceConnectionName> durch den Namen der Dienstverbindung, die Sie zuvor erstellt haben.

    • Ersetzen Sie in der Inline script Eingabe jeden der folgenden Platzhalter durch Werte, die für Ihre Azure-Umgebung geeignet sind:

      Platzhalter Wert
      <DevCenterName> Der Name Ihres Dev Centers.
      <project-name> Der Name des Projekts.
      <catalog-name> Der Name Ihres Katalogs.
      <environment-definition-name> Nicht ändern. Definiert die verwendete Umgebungsdefinition.
      <environment-type> Der Umgebungstyp.
      <environment-name> Geben Sie einen Namen für Ihre neue Umgebung an.
      <parameters> Nicht ändern. Verweist auf die JSON-Datei, die Parameter für die Umgebung definiert.

  4. Wählen Sie Commitaus, um Ihre Änderungen zu speichern.

  5. Fügen Sie im Commit-Bereich Änderungen übernehmen eine Commit-Nachricht hinzu und wählen Sie dann Commit aus.

Erstellen einer Umgebung mithilfe einer Pipeline

Als Nächstes führen Sie die Pipeline aus, um die Umgebung für Bereitstellungsumgebungen zu erstellen.

  1. Wählen Sie in Ihrem Azure DevOps-Projekt Pipelines aus.
  2. Wählen Sie die zuvor erstellte Pipeline und dann Pipeline ausführen aus.
  3. Sie können den Fortschritt der Pipelineausführung überprüfen, indem Sie den Pipelinenamen und dann Ausführungen auswählen. Wählen Sie die Ausführung aus, um die Details der Pipelineausführung anzuzeigen.
  4. Sie können auch den Fortschritt der Erstellung der Umgebung im Azure-Portal überprüfen, indem Sie Ihr Dev Center auswählen, Ihr Projekt auswählen und dann "Umgebungen" auswählen.

Sie können diesen Auftrag an einer beliebigen Stelle in einer CI- und/oder CD-Pipeline einfügen. Weitere Informationen zum Erstellen und Verwalten von Pipelines finden Sie in der Dokumentation zu Azure Pipelines.

Bereinigen von Ressourcen

Wenn Sie mit den Ressourcen, die Sie in diesem Tutorial erstellt haben, fertig sind, können Sie sie löschen, um Kosten zu vermeiden.

Verwenden Sie den folgenden Befehl, um die Umgebung zu löschen, die Sie in diesem Lernprogramm erstellt haben:

az devcenter dev environment delete --dev-center <DevCenterName> --project-name <DevCenterProjectName> --name <DeploymentEnvironmentInstanceToCreateName> --yes

Verwandte Inhalte

  • Last updated on