Ü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 den wiederverwendbaren Bicep-Code Ihres Spielzeugunternehmens veröffentlichen, 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

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

Auf der Azure DevOps Demo Generator-Website:

  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-reusable.

    Screenshot: Bereich „Azure DevOps Demo Generator“ zum Erstellen eines neuen Projekts

  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 von Azure DevOps mit Menü „Repos“ und hervorgehobenem Element „Dateien“

  2. Wählen Sie Klonen aus.

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

  3. Klicken Sie auf Git-Anmeldeinformationen generieren. Kopieren Sie Ihr Kennwort, und speichern Sie es. Sie benötigen diese Anmeldeinformationen beim Authentifizieren für Ihr Repository, wenn Sie später die Aktualisierungen für Ihre YAML Dateien übernehmen.

    Screenshot von Azure DevOps mit den Repositoryeinstellungen, wobei die Schaltfläche

  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-Repositoryeinstellungen mit hervorgehobener Schaltfläche „Clone in VS Code“ (In VS Code klonen)

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

  6. Da Sie dieses Repository zum ersten Mal verwenden, werden Sie möglicherweise 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.

  7. 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 schon 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.

    Die Standardshell ist in der Regel pwsh, wie auf der rechten Seite des Terminalfensters dargestellt.

    Screenshot des Visual Studio Code-Terminalfensters, in dem pwsh als Shelloption angezeigt wird.

  2. Wählen Sie die Dropdownliste Startprofil und dann Azure Cloud Shell (Bash) aus.

    Screenshot des Visual Studio Code-Terminalfensters. Die Dropdownliste der Terminalshell und das Menüelement Azure Cloud Shell (Bash) werden angezeigt.

    Eine neue Shell wird geöffnet.

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 schon 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.

    Die Standardshell ist in der Regel pwsh, wie auf der rechten Seite des Terminalfensters dargestellt.

    Screenshot des Visual Studio Code-Terminalfensters, in dem pwsh als Shelloption angezeigt wird.

  2. Wählen Sie die Dropdownliste Startprofil und dann Azure Cloud Shell (PowerShell) aus.

    Screenshot des Visual Studio Code-Terminalfensters. Die Dropdownliste der Terminalshell und das Menüelement Azure Cloud Shell (PowerShell) werden angezeigt.

    Eine neue Shell wird geöffnet.

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 ToyReusable --location westus3

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

New-AzResourceGroup -Name ToyReusable -Location westus3

Erstellen einer Dienstverbindung in Azure Pipelines

Als Nächstes erstellen Sie eine Dienstverbindung in Azure Pipelines. 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: Azure DevOps-Menü mit hervorgehobenem Element „Projekteinstellungen“

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

    Screenshot: Azure DevOps mit dem Bereich „Dienstverbindungen“ und hervorgehobener Schaltfläche „Dienstverbindung erstellen“

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

    Screenshot: Azure DevOps mit dem Bereich „Dienstverbindung erstellen“ und hervorgehobenem Dienstverbindungstyp „Azure Resource Manager“

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

    Screenshot: Azure DevOps-Bereich „Neue Azure-Dienstverbindung“ mit hervorgehobener Option „Dienstprinzipal (automatisch)“.

  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 ToyReusable aus.

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

    Screenshot des Azure DevOps-Bereichs „Neue Azure-Dienstverbindung“ mit eingetragenen Details und hervorgehobener Schaltfläche „Speichern“.

    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.