Übung: Einrichten der Azure DevOps-Umgebung

In diesem Abschnitt stellen Sie sicher, dass Ihre Azure DevOps-Organisation eingerichtet ist, um den Rest dieses Moduls abzuschließen. Außerdem erstellen Sie die Azure App Service-Umgebungen, in denen die Bereitstellung erfolgt.

Um Ihr System einzurichten, führen Sie folgende Aktionen aus:

Hinzufügen eines Benutzers zu Azure DevOps

Um dieses Modul abzuschließen, benötigen Sie Ihr eigenes Azure-Abonnement. Sie können kostenlos mit Azure beginnen.

Obwohl Sie kein Azure-Abonnement benötigen, um mit Azure DevOps zu arbeiten, verwenden Sie in diesem Modul Azure DevOps, um Ressourcen bereitzustellen, die in Ihrem Azure-Abonnement vorhanden sind. Um den Vorgang zu vereinfachen, sollten Sie dasselbe Microsoft-Konto verwenden, um sich sowohl bei Ihrem Azure-Abonnement als auch bei Ihrer Azure DevOps-Organisation anzumelden.

Wenn Sie unterschiedliche Microsoft-Konten verwenden, um sich bei Azure und Azure DevOps anzumelden, fügen Sie Ihrem DevOps-Unternehmen unter dem Microsoft-Konto, das Sie für die Anmeldung bei Azure verwenden, einen Benutzer hinzu. Weitere Informationen finden Sie unter Hinzufügen von Benutzern zu Ihrer Organisation oder Ihrem Projekt. Wenn Sie den Benutzer hinzufügen, wählen Sie die Standardzugriffsebene aus.

Melden Sie sich dann bei Azure DevOps ab, und melden Sie sich erneut unter dem Microsoft-Konto an, mit dem Sie sich bei Ihrem Azure-Abonnement anmelden.

Azure DevOps-Projekt abrufen

Hier stellen Sie sicher, dass Sie Ihre Azure DevOps-Organisation so eingerichtet haben, dass Sie den Rest dieses Moduls absolvieren können. Sie beginnen mit der Ausführung einer Vorlage, die Ihr Projekt in Azure DevOps erstellt.

Die Module in diesem Lernpfad sind Teil einer Entwicklung, die dem Tailspin-Webteam durch ihre DevOps-Reise folgt. Zu Lernzwecken ist jedem Modul ein Azure DevOps-Projekt zugeordnet.

Ausführen der Vorlage

Führen Sie eine Vorlage aus, die Ihre Azure DevOps-Organisation einrichtet.

1. Rufen Sie das ADOGenerator-Projekt in Visual Studio oder der IDE Ihrer Wahl ab, und führen Sie es aus.

2. Wenn Sie aufgefordert werden, die Vorlagennummer aus der Liste der Vorlagen einzugeben, geben Sie 33 für nicht funktionsfähige Tests in Azure Pipelines ein, und drücken Sie dann die EINGABETASTE.

3. Wählen Sie Ihre Authentifizierungsmethode aus. Sie können ein persönliches Zugriffstoken (PERSONAL Access Token, PAT) einrichten und verwenden oder die Geräteanmeldung verwenden.

   Hinweis

   Wenn Sie einen PAT einrichten, müssen Sie die erforderlichen Bereiche autorisieren. Für dieses Modul können Sie vollzugriff verwenden, aber in einer realen Situation sollten Sie sicherstellen, dass Sie nur die erforderlichen Bereiche gewähren.

4. Geben Sie Den Namen Ihrer Azure DevOps-Organisation ein, und drücken Sie dann die EINGABETASTE.

5. Wenn Sie dazu aufgefordert werden, geben Sie Ihren Azure DevOps PAT ein, und drücken Sie dann die EINGABETASTE.

6. Geben Sie einen Projektnamen wie Space Game - Web - Nicht-funktionale Tests ein, und drücken Sie dann die EINGABETASTE.

7. Nachdem Ihr Projekt erstellt wurde, wechseln Sie in Ihrem Browser (at https://dev.azure.com/<your-organization-name>/) zu Ihrer Azure DevOps-Organisation, und wählen Sie das Projekt aus.

Forken des Repositorys

Falls noch nicht geschehen, erstellen Sie einen Fork des Repositorys "mslearn-tailspin-spacegame-web-deploy".

1. Öffnen Sie auf GitHub das mslearn-tailspin-spacegame-web-deploy Repository.

2. Wählen Sie Fork oben rechts auf dem Bildschirm aus.

3. Wählen Sie Ihr GitHub-Konto als Besitzer und dann Fork erstellen aus.

Festlegen der Sichtbarkeit Ihres Projekts

Zunächst ist Ihr Fork des Repositorys „Space Game“ auf GitHub auf „Public“ (Öffentlich) festgelegt, während das mit der Azure DevOps-Vorlage erstellte Projekt auf „Private“ (Privat) festgelegt ist. Auf eine öffentliches Repository auf GitHub kann jeder zugreifen, während ein privates Repository nur für Sie und die Personen zugänglich ist, für die Sie es freigeben möchten. Auf ähnliche Weise bieten öffentliche Projekte in Azure DevOps schreibgeschützten Zugriff für nicht authentifizierte Benutzer, während private Projekte erfordern, dass Benutzern Zugriff gewährt wird und sie authentifiziert werden, um auf die Dienste zuzugreifen.

Derzeit ist es nicht erforderlich, diese Einstellungen für die Zwecke dieses Moduls zu ändern. Für Ihre persönlichen Projekte müssen Sie jedoch die Sichtbarkeit und den Zugriff bestimmen, den Sie anderen gewähren möchten. Bei einem Open-Source-Projekt können Sie z. B. sowohl Ihr GitHub-Repository als auch das Azure DevOps-Projekt öffentlich machen. Wenn Ihr Projekt geschützt ist, sollten Sie sowohl Ihr GitHub-Repository als auch das Azure DevOps-Projekt als privat festlegen.

Später können die folgenden Ressourcen hilfreich sein, um zu bestimmen, welche Option für Ihr Projekt am besten geeignet ist:

• Private und öffentliche Projekte verwenden
• Ändern der Projektsichtbarkeit in öffentliche oder private
• Sichtbarkeit eines Repositorys festlegen

Lokales Einrichten des Projekts

Hier laden Sie das Space Game-Projekt in Visual Studio Code, konfigurieren Git, klonen Sie Ihr Repository lokal, und legen Sie die Upstream-Remote so fest, dass Sie Startcode herunterladen können.

Öffnen des integrierten Terminals

Visual Studio Code verfügt über ein integriertes Terminal. Hier bearbeiten Sie Dateien und arbeiten über die Befehlszeile.

1. Starten Sie Visual Studio Code.

2. Wählen Sie im Menü Ansicht die Option Terminal aus.

3. Wählen Sie in der Dropdownliste Git Bash aus. Wenn Sie mit einer anderen Unix-Shell vertraut sind, die Sie verwenden möchten, wählen Sie stattdessen diese Shell aus.

   

   Im Terminalfenster können Sie eine beliebige Shell auswählen, die auf Ihrem System installiert ist. Sie können z. B. Git Bash oder PowerShell oder eine andere Shell auswählen.

   Hier verwenden Sie Git Bash, Teil von Git für Windows, was die Ausführung von Git-Befehlen erleichtert.

   Hinweis

   Wenn Git Bash unter Windows nicht als Option aufgeführt ist, stellen Sie sicher, dass Sie Git installiert haben, und starten Sie Visual Studio Code dann neu.

4. Führen Sie den cd Befehl aus, um zum Verzeichnis zu wechseln, in dem Sie arbeiten möchten. Wählen Sie bei Bedarf Ihr Startverzeichnis (~) oder ein anderes Verzeichnis aus.

   cd ~
   

Konfigurieren von Git

Wenn Sie mit Git und GitHub noch nicht vertraut sind, führen Sie zunächst einige Befehle aus, um Ihre Identität mit Git zu verknüpfen und sich mit GitHub zu authentifizieren. Weitere Informationen finden Sie unter Einrichten von Git.

Sie müssen mindestens die folgenden Schritte ausführen. Führen Sie die Befehle über das integrierte Terminal aus.

1. Legen Sie Ihren Benutzernamen fest.
2. Legen Sie Ihre Commit-E-Mail-Adresse fest.
3. Speichern Sie Ihr GitHub-Kennwort zwischen.

Einrichten Ihres Projekts in Visual Studio Code

Im Lernpfad "Erstellen von Anwendungen mit Azure DevOps" haben Sie ein Git-Repository geforkt und dann geklont. Das Repository enthält den Quellcode für die Space Game-Website . Ihr Fork wurde mit Ihren Projekten in Azure DevOps verbunden, sodass der Build ausgeführt wird, wenn Sie Änderungen in GitHub pushen.

In diesem Teil klonen Sie Ihren Fork lokal, sodass Sie Ihre Pipelinekonfiguration ändern und weiterentwickeln können.

Lokales Klonen des Forks

Sie haben nun in Ihrem GitHub-Konto eine Kopie des Space Game-Webprojekts erstellt. Jetzt laden Sie eine Kopie auf Ihren Computer herunter, oder klonen sie, damit Sie damit arbeiten können.

Ein Klon ist genau wie ein Fork eine Kopie eines Repositorys. Wenn Sie ein Repository klonen, können Sie Änderungen vornehmen, überprüfen, ob sie wie erwartet funktionieren, und dann diese Änderungen auf GitHub hochladen. Sie können Ihre lokale Kopie auch mit Änderungen synchronisieren, die andere authentifizierte Benutzer an der GitHub-Kopie Ihres Repositorys vorgenommen haben.

So klonen Sie das Space Game-Webprojekt auf Ihren Computer:

1. Wechseln Sie zu Ihrem Fork des Space Game-Webprojekts (mslearn-tailspin-spacegame-web-deploy) auf GitHub.

2. Wählen Sie Code aus. Klicken Sie dann auf der Registerkarte HTTPS auf die Schaltfläche neben der URL, um die URL in die Zwischenablage zu kopieren.

   

3. Rufen Sie in Visual Studio Code das Terminalfenster auf.

4. Wechseln Sie im Terminal zu dem Verzeichnis, in dem Sie arbeiten möchten. Wählen Sie bei Bedarf Ihr Startverzeichnis (~) oder ein anderes Verzeichnis aus.

   cd ~
   

5. Führen Sie den Befehl git clone aus. Ersetzen Sie die hier angezeigte URL durch den Inhalt Ihrer Zwischenablage:

   git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-deploy.git
   

6. Wechseln Sie zum Verzeichnis mslearn-tailspin-spacegame-web-deploy. Dies ist das Basisverzeichnis Ihres Repositorys.

   cd mslearn-tailspin-spacegame-web-deploy
   

Einrichten des Remoterepositorys für den Upstream

Ein Remote-Repository ist ein Git-Repository, in dem Teammitglieder zusammenarbeiten (z. B. ein Repository auf GitHub). Hier listen Sie Ihre Remoterepositorys auf und fügen ein Remoterepository hinzu, das auf die Kopie des Repositorys von Microsoft verweist, damit Sie den neuesten Beispielcode erhalten.

1. Führen Sie diesen Befehl git remote aus, um Ihre Remotes aufzulisten.

   git remote -v
   

   Wie Sie sehen, umfassen Ihre Zugriffsmöglichkeiten auf Ihr Repository sowohl das Fetchen (Herunterladen) als auch das Pushen (Hochladen):

   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
   

   Die Angabe Origin bezieht sich hier auf Ihr Repository auf GitHub. Wenn Sie Code aus einem anderen Repository forken, wird die ursprüngliche Remote (von der Sie geforkt haben) häufig upstream genannt.

2. Führen Sie diesen git remote add Befehl aus, um ein Remote mit dem Namen upstream zu erstellen, das auf das Microsoft-Repository verweist:

   git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git
   

3. Führen Sie den Vorgang git remote erneut aus, um die Änderungen anzuzeigen:

   git remote -v
   

   Sie sehen, dass Sie weiterhin sowohl Zugriff auf Abruf (Download) als auch Pushzugriff (Upload) auf Ihr Repository haben. Sie haben jetzt auch Zugriff auf das Microsoft-Repository:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web-deploy.git (push)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web-deploy.git (fetch)
   

Öffnen des Projekts im Datei-Explorer

In Visual Studio Code zeigt Ihr Terminalfenster auf das Stammverzeichnis des Webprojekts Space Game. Um die Struktur des Projekts anzuzeigen und mit Dateien zu arbeiten, öffnen Sie nun im Datei-Explorer das Projekt.

1. Die einfachste Möglichkeit zum Öffnen des Projekts besteht darin, Visual Studio Code im aktuellen Verzeichnis erneut zu öffnen. Führen Sie dazu im integrierten Terminal den folgenden Befehl aus:

   code -r .
   

   Das Verzeichnis und die Dateistruktur werden im Datei-Explorer angezeigt.

2. Öffnen Sie das integrierte Terminal erneut. Das Terminal leitet Sie zum Stammverzeichnis Ihres Webprojekts weiter.

Wenn der code-Befehl fehlschlägt, müssen Sie Ihrem Systempfad (PATH) Visual Studio Code hinzufügen. Gehen Sie folgendermaßen vor:

1. Wählen Sie in Visual Studio Code F1 oder Ansicht>Befehlspalette aus, um die Befehlspalette aufzurufen.
2. Geben Sie in der Befehlspalette Shell Command: Install 'code' command in PATH (Shellbefehl: Befehl „code“ in PATH installieren) ein.
3. Wiederholen Sie den vorherigen Vorgang, um das Projekt im Datei-Explorer zu öffnen.

Sie können jetzt mit dem Quellcode von Space Game und Ihrer Azure Pipelines-Konfiguration in der lokalen Entwicklungsumgebung arbeiten.

Erstellen der Azure App Service-Umgebungen

Hier erstellen Sie die Umgebungen, die die Pipelinephasen definieren. Sie erstellen eine App Service-Instanz, die jeder Phase entspricht: Dev, Test und Staging.

In früheren Modulen haben Sie die Azure CLI zum Erstellen Ihrer App Service-Instanzen verwendet. Hier führen Sie die gleichen Schritte aus.

Aufrufen von Cloud Shell über das Azure-Portal

1. Wechseln Sie zum Azure-Portal, und melden Sie sich an.
2. Wählen Sie auf der Menüleiste Cloud Shell aus. Wenn Sie dazu aufgefordert werden, wählen Sie die Bash-Experience aus.

Auswählen einer Azure-Region

Hier geben Sie die Standardregion oder den geografischen Standort an, an dem Ihre Azure-Ressourcen erstellt werden sollen.

1. Führen Sie in Cloud Shell den folgenden az account list-locations Befehl aus, um die Regionen auflisten, die in Ihrem Azure-Abonnement verfügbar sind.

   az account list-locations \
     --query "[].{Name: name, DisplayName: displayName}" \
     --output table
   

2. Wählen Sie in der Spalte Name in der Ausgabe eine Region aus, die Ihnen nahe liegt. Wählen Sie z. B. "Ostasien " oder "Westus2" aus.

3. Führen Sie az configure aus, um Ihre Standardregion festzulegen. Ersetzen Sie <REGION> durch den Namen der region, die Sie ausgewählt haben.

   az configure --defaults location=<REGION>
   

   Hier ist ein Beispiel, das westus2 als Standardregion festlegt:

   az configure --defaults location=westus2
   

Erstellen der App Service-Instanzen

Hier erstellen Sie die App Service-Instanzen für die drei Phasen, für die Sie bereitstellen werden: Dev, Test und Staging.

1. Generieren Sie in Cloud Shell eine Zufallszahl, die den Domänennamen Ihrer Web-App eindeutig macht.

   webappsuffix=$RANDOM
   

2. Führen Sie den folgenden az group create Befehl aus, um eine Ressourcengruppe mit dem Namen "tailspin-space-game-rg" zu erstellen.

   az group create --name tailspin-space-game-rg
   

3. Führen Sie den folgenden az appservice plan create Befehl aus, um einen App Service-Plan zu erstellen, der als tailspin-space-game-asp bezeichnet wird.

   az appservice plan create \
     --name tailspin-space-game-asp \
     --resource-group tailspin-space-game-rg \
     --sku B1 \
     --is-linux
   

   Das --sku Argument gibt den B1-Plan an, der auf der Ebene "Einfach " ausgeführt wird. Das --is-linux-Argument gibt an, dass Linux-Worker verwendet werden sollen.

   Von Bedeutung

   Wenn die B1-SKU nicht als Teil Ihres Azure-Abonnements verfügbar ist, wählen Sie einen anderen Plan aus, z. B. S1 (Standard).

4. Führen Sie die folgenden az webapp create Befehle aus, um die drei App Service-Instanzen zu erstellen, eine für jede der Entwicklungs-, Test- und Stagingumgebungen.

   az webapp create \
     --name tailspin-space-game-web-dev-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   
   az webapp create \
     --name tailspin-space-game-web-test-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   
   az webapp create \
     --name tailspin-space-game-web-staging-$webappsuffix \
     --resource-group tailspin-space-game-rg \
     --plan tailspin-space-game-asp \
     --runtime "DOTNET|6.0"
   

   Für Lernzwecke wenden Sie hier den gleichen App Service-Plan, B1 Basic, auf jede App Service-Instanz an. In der Praxis weisen Sie einen Plan zu, der Ihrer erwarteten Arbeitsauslastung entspricht.

5. Führen Sie den folgenden az webapp list Befehl aus, um den Hostnamen und den Status jeder App Service-Instanz auflisten zu können.

   az webapp list \
     --resource-group tailspin-space-game-rg \
     --query "[].{hostName: defaultHostName, state: state}" \
     --output table
   

   Beachten Sie den Hostnamen für jeden ausgeführten Dienst. Sie benötigen diese Hostnamen später, wenn Sie Ihre Arbeit überprüfen. Ein Beispiel:

   HostName                                                 State
   -------------------------------------------------------  -------
   tailspin-space-game-web-dev-21017.azurewebsites.net      Running
   tailspin-space-game-web-test-21017.azurewebsites.net     Running
   tailspin-space-game-web-staging-21017.azurewebsites.net  Running
   

6. Wechseln Sie als optionaler Schritt zu einem oder mehreren der aufgelisteten Namen, um zu überprüfen, ob sie ausgeführt werden und ob die Standardstartseite angezeigt wird.

   Diese Seite wird angezeigt:

   

Erstellen von Pipelinevariablen in Azure-Pipelines

In "Funktionstests in Azure Pipelines ausführen" haben Sie eine Variable für jede der App-Dienstinstanzen hinzugefügt. Die Instanzen entsprechen den Entwicklungs-, Test- und Stagingphasen in Ihrer Pipeline. Hier folgen Sie demselben Muster.

Jede Phase in Ihrer Pipelinekonfiguration verwendet die Variablen, um zu identifizieren, für welche App Service-Instanz bereitgestellt werden soll.

So fügen Sie die Variablen hinzu:

1. Wechseln Sie in Azure DevOps zu Ihrem Space Game - Web - Nonfunctional Tests-Projekt .

2. Wählen Sie unter Pipelines die Option Libraryaus.

3. Wählen Sie + Variablengruppe.

4. Geben Sie für den Variablengruppennamen unter EigenschaftenRelease ein.

5. Wählen Sie unter Variables die Option + Add aus.

6. Geben Sie für den Namen der Variablen WebAppNameDev ein. Geben Sie für den Wert den Namen der App Service-Instanz ein, die Ihrer Dev-Umgebung entspricht, z. B. tailspin-space-game-web-dev-1234.

7. Wiederholen Sie die Schritte 5 und 6 zweimal, um Variablen für Ihre Test - und Stagingumgebungen zu erstellen, wie in dieser Tabelle gezeigt:

   Variablenname	Beispielwert
   WebAppNameTest	tailspin-space-game-web-test-1234
   WebAppNameStaging	tailspin-space-game-web-staging-1234

   Achten Sie darauf, jeden Beispielwert durch die App Service-Instanz zu ersetzen, die Ihrer Umgebung entspricht.

   Von Bedeutung

   Stellen Sie sicher, dass Sie den Namen der App Service-Instanz und nicht den Hostnamen festlegen. In diesem Beispiel würden Sie tailspin-space-game-web-dev-1234 eingeben und nicht tailspin-space-game-web-dev-1234.azurewebsites.net.

8. Um Die Variable in der Pipeline zu speichern, wählen Sie "Speichern " am oberen Rand der Seite aus.

   Ihre Variablengruppe ähnelt dieser.

   

Erstellen der Entwicklungs-, Test- und Stagingumgebungen

In "Funktionstests in Azure Pipelines ausführen" haben Sie Umgebungen für die Entwicklungs-, Test- und Stagingumgebungen erstellt. Hier wiederholen Sie den Vorgang.

So erstellen Sie die Entwicklungs-, Test- und Stagingumgebungen:

1. Wählen Sie in Azure-Pipelines "Umgebungen" aus.

   

2. So erstellen Sie die Entwicklungsumgebung :

   1. Klicken Sie auf Umgebung erstellen.
   2. Geben Sie unter "Name" "Dev" ein.
   3. Behalten Sie die verbleibenden Felder bei ihren Standardwerten bei.
   4. Wählen Sie "Erstellen" aus.

3. So erstellen Sie die Testumgebung :

   1. Kehren Sie zur Seite "Umgebungen" zurück.
   2. Wählen Sie "Neue Umgebung" aus.
   3. Geben Sie unter Nametest ein.
   4. Wählen Sie "Erstellen" aus.

4. So erstellen Sie die Stagingumgebung

   1. Kehren Sie zur Seite "Umgebungen" zurück.
   2. Wählen Sie "Neue Umgebung" aus.
   3. Geben Sie unter Namestaging ein.
   4. Wählen Sie "Erstellen" aus.

Erstellen einer Dienstverbindung

Hier erstellen Sie eine Dienstverbindung, mit der Azure Pipelines auf Ihr Azure-Abonnement zugreifen können. Azure Pipelines verwendet diese Dienstverbindung, um die Website für App Service bereitzustellen. Sie haben eine ähnliche Dienstverbindung im vorherigen Modul erstellt.

1. Wechseln Sie in Azure DevOps zu Ihrem Space Game - Web - Nonfunctional Tests-Projekt .

2. Wählen Sie in der unteren Ecke der Seite die Projekteinstellungen aus.

3. Klicken Sie unter Pipelines auf Dienstverbindungen.

4. Wählen Sie "Neue Dienstverbindung" und dann "Azure Resource Manager" und dann "Weiter" aus.

5. Wählen Sie oben auf der Seite Dienstprinzipal (automatisch) aus. Wählen Sie dann Weiter aus.

6. Füllen Sie die folgenden Felder aus:

   Feld	Wert
   Bereichsebene	Abonnement
   Abonnement	Ihr Azure-Abonnement
   Ressourcengruppe	tailspin-space-game-rg
   Name der Dienstverbindung	Resource Manager – Tailspin – Space Game

   Während des Vorgangs werden Sie möglicherweise aufgefordert, sich bei Ihrem Microsoft-Konto anzumelden.

7. Stellen Sie sicher, dass die Berechtigung "Zugriff für alle Pipelines gewähren" ausgewählt ist.

8. Wählen Sie Speichern aus.

   Azure DevOps führt eine Testverbindung aus, um zu überprüfen, ob sie eine Verbindung mit Ihrem Azure-Abonnement herstellen kann. Wenn Azure DevOps keine Verbindung herstellen kann, haben Sie die Möglichkeit, sich ein zweites Mal anzumelden.