Übung: Einrichten Ihrer Umgebung

Abgeschlossen

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.

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 zwei Ressourcengruppen in Azure.
• Erstellen Sie zwei Dienstverbindungen und Umgebungen in Azure Pipelines.
• Entfernen Sie die Ressourcen, die Sie im vorab erstellten Azure DevOps-Projekt nicht benötigen.

Abrufen des Azure DevOps-Projekts

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. Achten Sie darauf, 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 auf der Website „Azure DevOps Demo Generator“ die folgenden Schritte aus:

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

   

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.

   

2. Wählen Sie Klonen aus.

   

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.

   

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.

   

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.

   

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.

   

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.

   

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.

   

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

   

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.

   

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.

   

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

   

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

   

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

   

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 anmelden. 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 Allen Pipelines die Zugriffsberechtigung gewähren aktiviert ist, und wählen Sie dann Speichern aus.

   

   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. Wiederholen Sie den vorherigen Prozess, um eine weitere neue Dienstverbindung mit dem Namen ToyWebsiteProduction zu erstellen, die für die Ressourcengruppe mit dem Namen ToyWebsiteProduction bereitgestellt wird.

   

   Wenn die Ressourcengruppenliste nicht aktualisiert wird, aktualisieren Sie die Seite in Ihrem Browser, und wiederholen Sie den Vorgang.

Erstellen von Umgebungen in Azure Pipelines

1. Navigieren Sie im Browser zu Pipelines>Umgebungen.

   

2. Wählen Sie Neue Umgebung aus.

   

3. Geben Sie als Umgebungsnamen Test ein.

   Lassen Sie die Beschreibung leer. Wählen Sie für Ressource die Option Keine aus. Klicken Sie anschließend auf Erstellen.

   Hinweis

   In Azure Pipelines werden Bereitstellungsfeatures mithilfe von Umgebungen aktiviert. Einige dieser Features gelten nur für Bereitstellungen in Kubernetes oder auf VMs. In diesem Modul werden diese Features nicht verwendet, und Sie können sie ignorieren.

   

   Bevor eine Pipeline die Umgebung verwenden kann, müssen Sie ihr die Berechtigung erteilen. Der Einfachheit halber erlauben Sie allen Pipelines den Zugriff auf die Umgebung. In Ihren eigenen Pipelines sollten Sie den Zugriff auf Umgebungen auf die Pipelines beschränken, die dies erfordern.

4. Wählen Sie die Schaltfläche mit drei Punkten und dann Sicherheit aus.

   

5. Wenn im Abschnitt Pipelineberechtigungen eine Schaltfläche mit der Bezeichnung Berechtigung einschränken vorhanden ist, wählen Sie diese aus.

6. Wählen Sie die Schaltfläche mit den drei Punkten aus. Wählen Sie Offener Zugriff aus.

   

7. Wählen Sie den Pfeil nach links zweimal aus, um zur Umgebungsliste zurückzukehren.

   

8. Wiederholen Sie den Vorgang, um eine weitere Umgebung mit dem Namen Produktion zu erstellen. Denken Sie daran, für sie „Offener Zugriff“ festzulegen.

   

   Lassen Sie die Seite für die Produktionsumgebung geöffnet.

Hinzufügen einer Genehmigungsprüfung zur Produktionsumgebung

1. Wählen Sie oben rechts auf der Seite die Schaltfläche mit den drei Punkten und dann im Popupmenü Genehmigungen und Überprüfungen aus.

   

2. Wählen Sie Genehmigungen aus.

   

3. Geben Sie in das Textfeld Genehmigende Personen Ihren eigenen Namen ein, und wählen Sie sich selbst aus.

4. Wählen Sie neben Erweitert den Pfeil aus.

   Beachten Sie, dass genehmigende Personen standardmäßig berechtigt sind, die von ihnen ausgelösten Ausführungen zu genehmigen. Da Sie die einzige Person sind, die diese Pipeline verwendet, lassen Sie dieses Kontrollkästchen aktiviert. In anderen Organisationen müssen Sie möglicherweise eine andere genehmigende Person angeben, um die Konformitätsanforderungen zu erfüllen.

5. Klicken Sie auf Erstellen.

   

Löschen der alten Umgebung

In den vorherigen Versionen der Pipeline haben Sie eine einzelne Umgebung namens Website verwendet. Nachdem Sie nun Pipelineumgebungen erstellt haben, die Ihre neuen Umgebungen darstellen, können Sie die alte Pipelineumgebung löschen.

1. Navigieren Sie zu Pipelines>Umgebungen.

2. Wählen Sie die Umgebung Website aus.

   

3. Wählen Sie oben rechts auf der Seite die Schaltfläche mit den drei Punkten und dann im Popupmenü Löschen aus.

   

4. Klicken Sie auf Löschen, um den Löschvorgang zu bestätigen.

Löschen der alten Variablen

In den vorherigen Versionen der Pipeline haben Sie eine einzelne Gruppe von Variablen verwendet, um die Parameter und die Bereitstellungskonfiguration zu definieren. Nachdem Sie nun die Bereitstellung in mehreren Umgebungen durchführen, können Sie diese Variablen löschen und bald durch umgebungsspezifische Variablensätze ersetzen.

1. Navigieren Sie zu Pipelines>Pipelines.

2. Wählen Sie die Pipeline toy-website-environments aus.

3. Wählen Sie die Schaltfläche Bearbeiten aus.

   

4. Wählen Sie die Schaltfläche Variablen aus.

   

5. Wählen Sie für jede der drei Variablen die Schaltfläche Variable löschen aus.

   

6. Wählen Sie Speichern aus.