Übung: Einrichten der Azure DevOps-Umgebung

In dieser Lerneinheit stellen Sie sicher, dass Ihre Microsoft Azure DevOps-Organisation so eingerichtet ist, dass Sie den Rest dieses Moduls durchführen können.

Gehen Sie dazu wie folgt vor:

Abrufen des Azure DevOps-Projekts

Hier stellen Sie sicher, dass Ihre Azure DevOps-Organisation eingerichtet ist, den Rest dieses Moduls zu absolvieren. Dazu führen Sie eine Vorlage aus, die für Sie ein Projekt in Azure DevOps erstellt.

Die Module in diesem Lernpfad sind fortschreitend angeordnet, sodass Sie das Tailspin-Webteam bei seiner DevOps-Reise begleiten. 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 23 für die Implementierung eines Codeworkflows in Ihrer Buildpipeline mithilfe von Git und GitHub 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 - Workflow 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, forken Sie das Repository mslearn-tailspin-spacegame-web.

1. Auf GitHub wechseln Sie zum mslearn-tailspin-spacegame-web-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
• Festlegen der Sichtbarkeit des Repositorys

Versetzen des Arbeitselements in die Ausführung

In diesem Abschnitt weisen Sie sich in Azure Boards selbst ein Arbeitselement für dieses Modul zu. Außerdem verschieben Sie die Arbeitsaufgabe in den Zustand " Ausführen ". In der Praxis würden Sie und Ihr Team Arbeitsaufgaben am Anfang jedes Sprints oder jeder Arbeitsiteration erstellen.

Wenn Sie Arbeit auf diese Weise zuweisen, erhalten Sie eine Checkliste, nach der Sie arbeiten können. So können andere Teammitglieder einsehen, woran Sie gerade arbeiten und wie viel Arbeit noch übrig ist. Außerdem kann das Team so Beschränkungen für die aktuell bearbeiteten Aufgaben (Work In Process, WIP) erzwingen, damit es nicht zu viel Arbeit auf einmal übernimmt.

Erinnern Sie sich daran, dass das Team die folgenden sieben wichtigsten Aufgaben festgelegt hat:

Hier verschieben Sie das zweite Element, Erstellen eines gitbasierten Workflows, in die Spalte " Ausführen ", und weisen Sie sich selbst der Arbeitsaufgabe zu.

Erinnern Sie sich daran, dass das Erstellen eines Git-basierten Workflows sich auf einen Codeworkflow bezieht, der eine bessere Zusammenarbeit zwischen Teammitgliedern ermöglicht.

So richten Sie das Arbeitselement ein:

1. Wählen Sie in Azure DevOps im linken Bereich " Boards" und dann " Boards" aus.

   

2. Wählen Sie im Arbeitselement 'Git-basierter Workflow' den Dropdown-Pfeil To Do aus, und weisen Sie das Arbeitselement dann sich selbst zu.

   

3. Ziehen Sie die Arbeitsaufgabe aus der Spalte "Zu Erledigen" in die Spalte "In Bearbeitung".

   

Am Ende dieses Moduls verschieben Sie das Element nach Abschluss der Aufgabe in die Spalte "Fertig ".

Lokales Einrichten des Projekts

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

Öffnen des integrierten Terminals

Visual Studio Code enthält ein integriertes Terminal, in dem Sie zentral Dateien bearbeiten und über die Befehlszeile arbeiten können.

1. Starten Sie Visual Studio Code.

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

3. Wählen Sie in der Dropdownliste bash aus. Wenn Sie mit einer anderen Unix-Shell vertraut sind, deren Verwendung Sie bevorzugen, z. B. Zsh, wählen Sie stattdessen diese Shell aus.

   

   Im Terminalfenster können Sie jede auf Ihrem System installierte Shell auswählen, z. B. Bash, Zsh und PowerShell.

   In diesem Beispiel wird Bash verwendet. Git für Windows enthält Git Bash, mit dem Git-Befehle einfach ausgeführt werden können.

   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 Befehl cd aus, um zu dem Verzeichnis zu navigieren, in dem Sie arbeiten möchten, z. B. Ihr Basisverzeichnis (~). Sie können auch ein beliebiges anderes Verzeichnis auswählen.

   cd ~
   

Konfigurieren von Git

Wenn Sie noch nicht mit Git und GitHub gearbeitet haben, müssen Sie zunächst einige Befehle ausführen, um Ihre Identität mit Git zu verknüpfen und sich bei GitHub zu authentifizieren.

Das Einrichten von Git erläutert den Prozess ausführlicher.

Sie müssen mindestens die folgenden Schritte ausführen. Führen Sie die folgenden Befehle im integrierten 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

In diesem Teil klonen Sie Ihren Fork lokal, damit Sie Änderungen vornehmen und Ihre Pipelinekonfiguration ausbauen können.

Lokales Klonen des Forks

Sie verfügen jetzt über eine Kopie des Space Game-Webprojekts in Ihrem GitHub-Konto. 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. Mit einem geklonten Repository können Sie Änderungen vornehmen, deren korrekte Funktion überprüfen und sie anschließend wieder zu GitHub hochladen. Außerdem können Sie Ihre lokale Kopie mit Änderungen synchronisieren, die andere authentifizierte Benutzer an der Kopie Ihres Repositorys auf GitHub 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) auf GitHub.

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

   

3. Gehen Sie in Visual Studio Code zum Terminalfenster.

4. Wechseln Sie im Terminal zu dem Verzeichnis, in dem Sie arbeiten möchten, z. B. Ihr Basisverzeichnis (~). Sie können auch ein beliebiges anderes Verzeichnis auswählen.

   cd ~
   

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

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

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

   cd mslearn-tailspin-spacegame-web
   

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 den Befehl git remote aus, um Ihre Remoterepositorys aufzulisten:

   git remote -v
   

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

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

   Origin gibt Ihr Repository auf GitHub an. Beim Forken von Code aus einem anderen Repository wird das ursprüngliche Remoterepository (aus dem der Fork erstellt wurde) üblicherweise als Upstream bezeichnet.

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

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

3. Führen Sie git remote ein zweites Mal aus, um die Änderungen anzuzeigen:

   git remote -v
   

   Wie Sie sehen umfassen Ihre Zugriffsmöglichkeiten auf das Repository weiterhin sowohl das Abrufen (Herunterladen) als auch das Pushen (Hochladen). Zudem verfügen Sie jetzt über Fetch- und Pushzugriff auf das Microsoft-Repository:

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

Öffnen des Projekts im Datei-Explorer

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

1. Die einfachste Möglichkeit, das Projekt zu öffnen, besteht darin, Visual Studio Code im aktuellen Verzeichnis neu 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. Dazu gehen Sie wie folgt vor:

1. Wählen Sie in Visual Studio Code F1 aus, oder wählen Sie"Befehlspalette>" aus, um auf die Befehlspalette zuzugreifen.
2. Geben Sie in der Befehlspalette den Shellbefehl ein: Befehl 'Code' in PATH installieren.
3. Wiederholen Sie den Vorgang, um das Projekt im Datei-Explorer zu öffnen.

Sie sind jetzt für die Arbeit mit dem Quellcode für Space Game und Ihrer Azure Pipelines-Konfiguration aus Ihrer lokalen Entwicklungsumgebung eingerichtet.