Übung: Einrichten Ihrer Umgebung

  • 4 Minuten

Wichtig

Sie benötigen für diese Übung ein eigenes Azure-Abonnement. Außerdem fallen möglicherweise Gebühren für Sie an. Wenn Sie noch kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Bevor Sie mit der Arbeit an der Websitepipeline Ihres Spielzeugunternehmens beginnen, müssen Sie Ihre Umgebung konfigurieren. In diesem Abschnitt stellen Sie sicher, dass Ihre Azure- und Azure DevOps-Umgebungen so eingerichtet sind, dass Sie den Rest dieses Moduls absolvieren können.

So erreichen Sie diese Ziele:

  • Richten Sie ein Azure DevOps-Projekt für dieses Modul ein.
  • Klonen Sie das Repository des Projekts auf Ihren Computer.
  • Erstellen Sie eine Ressourcengruppe in Azure.
  • Erstellen Sie eine Dienstverbindung in Azure Pipelines.

Einrichten des Azure DevOps-Projekts

Hier stellen Sie sicher, dass Sie Ihre Azure DevOps-Organisation so eingerichtet haben, dass Sie den Rest dieses Moduls absolvieren können. Sie richten sie ein, indem Sie eine Vorlage ausführen, mit der in Azure DevOps ein Projekt erstellt wird.

Die Module in diesem Lernpfad sind fortschreitend angeordnet. Zu Lernzwecken ist jedem Modul ein Azure DevOps-Projekt zugeordnet.

Tipp

Auch wenn Sie das vorherige Modul im Lernpfad abgeschlossen haben, befolgen Sie diese Anweisungen, um ein neues Projekt zu erstellen. Stellen Sie dabei sicher, dass Sie ihm einen neuen Namen geben.

Ausführen der Vorlage

Führen Sie eine Vorlage aus, mit der Ihr Azure DevOps-Projekt eingerichtet wird.

Ausführen der Vorlage

Führen Sie die folgenden Schritte auf der Website „Azure DevOps Demo Generator“ durch, um die Vorlage auszuführen.

  1. Wählen Sie Sign In (Anmelden) aus, und akzeptieren Sie die Nutzungsbedingungen.

  2. Wählen Sie auf der Seite Create New Project (Neues Projekt erstellen) Ihre Azure DevOps-Organisation aus. Geben Sie dann einen Projektnamen ein, z. B. toy-website-test.

    Screenshot: Erstellen eines Projekts über den Azure DevOps-Demo-Generator

  3. Wählen Sie Create Project (Projekt erstellen) aus.

    Die Ausführung der Vorlage dauert einige Zeit. Es erstellt automatisch eine Pipeline und eine Bicep-Datei, mit der Sie in den nachfolgenden Übungen arbeiten können.

  4. Klicken Sie auf Zu Projekt navigieren, um zu Ihrem Projekt in Azure DevOps zu wechseln.

Wichtig

Die letzte Übung in diesem Modul enthält wichtige Schritte zur Bereinigung. Führen Sie unbedingt die Bereinigungsschritte durch, auch wenn Sie dieses Modul nicht absolvieren.

Klonen des Repositorys

  1. Wählen Sie Repos>Dateien aus.

    Screenshot von Azure DevOps mit Menü „Repos“ und hervorgehobenem Element „Dateien“

  2. Wählen Sie Klonen aus.

    Screenshot: Azure DevOps mit dem Repository und hervorgehobener Schaltfläche „Klonen“

  3. Wenn Sie macOS verwenden, benötigen Sie ein spezielles Kennwort, um das Git-Repository zu klonen. Wählen Sie Git-Anmeldeinformationen generieren aus, und kopieren Sie den angezeigten Benutzernamen und das Kennwort an einen sicheren Ort.

  4. Wählen Sie In VS Code klonen aus. Wenn Sie aufgefordert werden, das Öffnen von Visual Studio Code zuzulassen, wählen Sie Öffnen aus.

    Screenshot: Azure DevOps mit Repositoryeinstellungen und hervorgehobener Schaltfläche zum Klonen in Visual Studio Code

  5. Wenn Sie in einem Dialogfeld aufgefordert werden, einer Erweiterung des Öffnen des Repository-URI zu genehmigen, wählen Sie Öffnen aus.

  6. Erstellen Sie einen Ordner, der für das Repository verwendet werden soll, und wählen Sie dann Repositoryspeicherort auswählen aus.

  7. Da Sie dieses Repository zum ersten Mal verwenden, werden Sie aufgefordert sich anzumelden.

    • Wenn Sie Windows verwenden, geben Sie dieselben Anmeldeinformationen ein, die Sie zuvor in dieser Übung für die Anmeldung bei Azure DevOps verwendet haben.

    • Wenn Sie macOS verwenden, geben Sie den Git-Benutzernamen und das Kennwort ein, den bzw. das Sie zuvor generiert haben.

  8. Sie werden von Visual Studio Code aufgefordert, den Repositoryspeicherort zu öffnen. Klicken Sie auf Öffnen.

    Screenshot von Visual Studio Code mit einer Aufforderung zum Öffnen des geklonten Repositorys und hervorgehobener Schaltfläche „Öffnen“

Anmelden bei Azure

Sie müssen sich über das Visual Studio Code-Terminal bei Ihrem Azure-Konto anmelden, um Ressourcengruppen in Azure verwenden zu können. Stellen Sie sicher, dass Sie die Azure CLI-Tools installiert haben.

  1. Wählen Sie im Menü Terminal die Option New Terminal (Neues Terminal) aus. Das Terminalfenster wird in der Regel in der unteren Hälfte des Bildschirms geöffnet.

  2. Wenn die auf der rechten Seite des Terminalfensters angezeigte Shell bash ist, ist die richtige Shell geöffnet, und Sie können mit dem nächsten Abschnitt fortfahren.

    Screenshot des Visual Studio Code-Terminalfensters mit Option „bash“

  3. Wenn eine andere Shell als bash angezeigt wird, öffnen Sie die Shell-Dropdownliste, und wählen Sie Git Bash (Default) (Git Bash (Standard)) aus.

    Screenshot des Visual Studio Code-Terminalfensters mit dem Dropdownmenü für die Terminalshell und Auswahl von „Git Bash (Standard)“

  4. Wählen Sie in der Liste der Terminalshells bash und dann das Pluszeichen aus, um ein neues Terminal zu öffnen, das die Bash-Shell verwendet.

    Screenshot des Visual Studio Code-Terminalfensters mit Bash-Terminal und ausgewähltem Pluszeichen

Anmelden bei Azure über die Azure CLI

  1. Führen Sie im Visual Studio Code-Terminal den folgenden Befehl aus, um sich bei Azure anzumelden:

    az login

  2. Melden Sie sich im Browserfenster, das daraufhin geöffnet wird, in Ihrem Azure-Konto an.

Sie müssen sich über das Visual Studio Code-Terminal bei Ihrem Azure-Konto anmelden, um Ressourcengruppen in Azure verwenden zu können. Stellen Sie sicher, dass Azure PowerShell installiert ist.

  1. Wählen Sie im Menü Terminal die Option New Terminal (Neues Terminal) aus. Das Terminalfenster wird in der Regel in der unteren Hälfte des Bildschirms geöffnet.

  2. Wenn die auf der rechten Seite des Terminalfensters angezeigte Shell powershell oder pwsh ist, ist die richtige Shell geöffnet, und Sie können mit dem nächsten Abschnitt fortfahren.

    Screenshot des Visual Studio Code-Terminalfensters mit „pwsh“ im Dropdownmenü für die Shell

  3. Wenn eine andere Shell als powershell oder pwsh angezeigt wird, öffnen Sie die Shell-Dropdownliste, und wählen Sie PowerShell aus.

    Screenshot des Visual Studio Code-Terminalfensters mit dem Dropdownmenü für die Terminalshell und ausgewählter Option „PowerShell“

  4. Wählen Sie in der Liste der Terminalshells powershell oder pwsh aus, und wählen Sie dann das Pluszeichen aus, um ein neues Terminal zu öffnen, das die Powershell- oder Pwsh-Shell verwendet.

    Screenshot des Visual Studio Code-Terminalfensters mit PowerShell-Terminal und ausgewähltem Pluszeichen

Anmelden bei Azure mithilfe von Azure PowerShell

  1. Führen Sie im Visual Studio Code-Terminal den folgenden Befehl aus, um sich bei Azure anzumelden:

    Connect-AzAccount

  2. Melden Sie sich im Browserfenster, das daraufhin geöffnet wird, in Ihrem Azure-Konto an.

Erstellen einer Ressourcengruppe in Azure

Führen Sie diesen Azure CLI-Befehl im Visual Studio Code-Terminal aus, um eine neue Ressourcengruppe zu erstellen:

az group create --name ToyWebsiteTest --location westus3

Führen Sie diesen Azure PowerShell-Befehl im Visual Studio Code-Terminal aus, um eine Ressourcengruppe zu erstellen:

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3

Erstellen einer Dienstverbindung in Azure Pipelines

Als Nächstes erstellen Sie eine Dienstverbindung in Azure Pipelines. Diese Verbindung erstellt automatisch einen Dienstprinzipal in Azure. Außerdem wird dem Dienstprinzipal die Rolle „Mitwirkender“ für Ihre Ressourcengruppe gewährt, damit Ihre Pipeline in der Ressourcengruppe bereitgestellt werden kann.

  1. Wählen Sie in Ihrem Browser Projekteinstellungen aus.

    Screenshot: Azure DevOps mit hervorgehobenem Menüelement „Projekteinstellungen“

  2. Wählen Sie Dienstverbindungen>Dienstverbindung erstellen aus.

    Screenshot: Azure DevOps mit Auswahlmöglichkeiten für die Erstellung einer Dienstverbindung

  3. Wählen Sie Azure Resource Manager>Weiter aus.

    Screenshot: Azure DevOps mit hervorgehobenem Dienstverbindungstyp „Azure Resource Manager“

  4. Wählen Sie Dienstprinzipal (automatisch)>Weiter aus.

    Screenshot: Azure DevOps mit hervorgehobener Option „Dienstprinzipal“

  5. Wählen Sie in der Dropdownliste Abonnement Ihr Azure-Abonnement aus.

    Möglicherweise wird ein Popupfenster angezeigt, in dem Sie aufgefordert werden, sich bei Azure anzumelden. Geben Sie in diesem Bereich Ihre Anmeldeinformationen ein, und melden Sie sich an.

  6. Wählen Sie in der Dropdownliste Ressourcengruppe die Option ToyWebsiteTest aus.

  7. Geben Sie in Dienstverbindungsname den Wert ToyWebsiteTest ein. Achten Sie darauf, dass das Kontrollkästchen Zugriffsberechtigungen für alle Pipelines gewähren aktiviert ist.

    Screenshot: Azure DevOps mit ausgefüllten Angaben zum Erstellen einer Dienstverbindung und hervorgehobener Schaltfläche „Speichern“

    Tipp

    Der Einfachheit halber gewähren Sie jeder Pipeline Zugriff auf Ihre Dienstverbindung. Wenn Sie echte Dienstverbindungen erstellen, die mit Produktionsressourcen arbeiten, sollten Sie den Zugriff auf die Pipelines beschränken, die diese Ressourcen benötigen.

  8. Wählen Sie Speichern aus.