Übung: Einrichten Ihrer Umgebung

  • 5 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 dieser Lerneinheit stellen Sie sicher, dass Ihre Azure- und Azure DevOps-Umgebungen so eingerichtet sind, dass Sie den Rest dieses Moduls absolvieren können.

Um diese Ziele zu erreichen, führen Sie die folgenden Aufgaben aus:

  • Richten Sie ein Azure DevOps-Projekt für dieses Modul ein.
  • Klonen Sie das Repository des Projekts auf Ihren Computer.
  • Erstellen Sie zwei Ressourcengruppen in Azure.
  • Erstellen Sie zwei Dienstverbindungen und Umgebungen in Azure Pipelines.

Abrufen des Azure DevOps-Projekts

In diesem Abschnitt stellen Sie sicher, dass Ihre Azure DevOps-Organisation so eingerichtet ist, 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. Achten Sie darauf, dass Sie dem Projekt 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 auf der Demo-Generator-Website von Azure DevOps die folgenden Schritte aus:

  1. Wählen Sie Anmelden aus, und stimmen Sie dann den Nutzungsbedingungen der Website zu, indem Sie Akzeptieren auswählen.

  2. Wählen Sie auf der Seite Neues Projekt erstellen Ihre Azure DevOps-Organisation aus, und geben Sie dann im Feld Neuer Projektname einen Projektnamen ein, z. B. toy-website-end-to-end.

    Screenshot of the Azure DevOps Demo Generator pane for creating a new project.

  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 nächsten Ü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 of Azure DevOps that shows the Repos menu, with Files highlighted.

  2. Wählen Sie Klonen aus.

    Screenshot of Azure DevOps showing the repository, with the Clone button highlighted.

  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 dann 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 of Azure DevOps that shows the repository settings, with the Clone in VS Code button highlighted.

  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 möglicherweise aufgefordert, sich anzumelden.

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

    • Geben Sie unter macOS 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 of Visual Studio Code that shows a prompt to open the cloned repository, with the Open button highlighted.

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 of the Visual Studio Code terminal window, with the bash option shown.

  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 of the Visual Studio Code terminal window, with the terminal shell dropdown shown and Git Bash Default selected.

  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 of the Visual Studio Code terminal window, with the bash terminal and the plus sign selected.

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 of the Visual Studio Code terminal window, with the p w s h option displayed in the shell dropdown.

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

    Screenshot of the Visual Studio Code terminal window, with the terminal shell dropdown shown and powershell selected.

  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 of the Visual Studio Code terminal window, with the powershell terminal and the plus sign selected.

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 von zwei Ressourcengruppen in Azure

Führen Sie die folgenden Azure CLI-Befehle im Visual Studio Code-Terminal aus, um die beiden neuen Ressourcengruppen zu erstellen:

az group create --name ToyWebsiteTest --location westus3
az group create --name ToyWebsiteProduction --location westus3

Führen Sie die folgenden Azure PowerShell-Befehle im Visual Studio Code-Terminal aus, um die beiden neuen Ressourcengruppen zu erstellen:

New-AzResourceGroup -Name ToyWebsiteTest -Location westus3
New-AzResourceGroup -Name ToyWebsiteProduction -Location westus3

Erstellen von Dienstverbindungen in Azure Pipelines

Erstellen Sie als Nächstes zwei Dienstverbindungen in Azure Pipelines: eine für Ihre Testumgebung und eine für Ihre Produktionsumgebung. Bei diesem Prozess wird automatisch ein Dienstprinzipal in Azure erstellt. 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 of Azure DevOps that shows the menu, with the Project settings item highlighted.

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

    Screenshot of Azure DevOps that shows the Service connections pane, with the Create service connection button highlighted.

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

    Screenshot of Azure DevOps that shows the Service connections pane, with the Azure Resource Manager service connection type highlighted.

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

    Screenshot of Azure DevOps that shows the New Azure service connection pane, with the Service principal (automatic) option highlighted.

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

    Wenn ein Popupfenster mit einer Meldung angezeigt wird, in der Sie aufgefordert werden, sich bei Azure anzumelden, geben Sie Ihre Anmeldeinformationen ein, und melden Sie sich an.

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

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

    Screenshot of Azure DevOps that shows the New Azure service connection pane for the test environment, with the details completed and the Save button highlighted.

    Tipp

    Der Einfachheit halber gewähren Sie in dieser Übung 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.

  9. Wiederholen Sie die Schritte 1 bis 8, um eine weitere neue Dienstverbindung mit dem Namen ToyWebsiteProduction zu erstellen, die für die Ressourcengruppe mit dem Namen ToyWebsiteProduction bereitgestellt wird:

    Screenshot of Azure DevOps that shows the New Azure service connection pane for the production environment, with the details completed and the Save button highlighted.

    Wenn die Ressourcengruppenliste nicht angezeigt wird, aktualisieren Sie die Seite in Ihrem Browser, geben Sie bei Aufforderung Ihre Anmeldeinformationen ein, und versuchen Sie es erneut.

Hinweis

In den vorherigen Modulen dieses Lernpfads haben Sie Ihrer Produktionsumgebung eine Genehmigungsprüfung hinzugefügt. In diesem Modul überspringen Sie der Einfachheit halber die Genehmigungsprüfung. Wenn Sie möchten, können Sie die Genehmigungsprüfung jedoch selbst hinzufügen.