Schnellstart: Erstellen einer Dev-Box mithilfe von Teamanpassungen

In diesem Schnellstart erstellen Sie eine Dev-Box mit Microsoft Dev Box-Teamanpassungen. Das Feature verwendet eine Imagedefinitionsdatei, sodass Sie konsistent angepasste Dev-Boxen für Ihr Entwicklungsteam erstellen und eine maßgeschneiderte Umgebung für Ihre Projekte bereitstellen können.

Wichtig

Das Feature für Dev Box-Teamanpassungen befindet sich derzeit in der Vorschau. Weitere Informationen zu der Vorschauversion finden Sie unter Zusätzliche Nutzungsbestimmungen für Microsoft Azure-Vorschauen. Das Dokument definiert rechtliche Bedingungen, die für Azure-Features gelten, die sich in der Beta- oder Vorschauphase befinden oder anderweitig noch nicht allgemein verfügbar sind.

Voraussetzungen

Um die Schritte in diesem Schnellstart auszuführen, müssen Sie eine Dev Center-Instanz mit einem Dev-Box-Projekt konfiguriert haben.

Erforderliche Berechtigungen zum Konfigurieren von Anpassungen

Um die erforderlichen Aktionen zum Erstellen und Anwenden von Anpassungen für eine Dev-Box auszuführen, benötigen Sie die folgenden Berechtigungen:

Aktion	Berechtigung/Rolle
Aktivieren von Katalogen auf Projektebene für ein Dev Center.	Plattformtechniker mit Schreibzugriff auf das Abonnement.
Aktivieren von Katalogsynchronisierungseinstellungen für ein Projekt.	Plattformtechniker mit Schreibzugriff auf das Abonnement.
Anfügen eines Katalogs an ein Projekt.	Berechtigungen als Projektadministrator oder Mitwirkender für das Projekt
Erstellen einer Anpassungsdatei.	Keine angegeben. Jeder kann eine Anpassungsdatei erstellen.
Verwenden des Entwicklerportals zum Hochladen und Anwenden einer YAML-Datei während der Erstellung von Dev-Boxen.	Dev Box-Benutzer.
Hinzufügen von Aufgaben zu einem Katalog.	Berechtigung zum Hinzufügen zum Repository, das den Katalog hostet.

Erstellen einer Imagedefinition

1. Laden Sie die Beispiel-YAML-Anpassungsdatei herunter.
2. Öffnen Sie die Datei, und überprüfen Sie die Aufgaben.

Die Imagedefinitionsdatei gibt einen Namen für die Imagedefinition mithilfe eines name-Felds an. Verwenden Sie diesen Namen, um die Imagedefinition im Dev-Box-Pool zu identifizieren.

Aktivieren von Katalogen auf Projektebene

Sie müssen Kataloge auf Projektebene auf Dev Center-Ebene aktivieren, bevor Sie einem Projekt einen Katalog hinzufügen können.

1. Navigieren Sie im Azure-Portal zu Ihrem Dev Center.

2. Wählen Sie im Dienstmenü unter Einstellungen die Option Konfiguration aus.

   

3. Wählen Sie im Bereich Kataloge auf Projektebene die Option Kataloge pro Projekt aktivieren aus, und wählen Sie dann Anwenden aus.

   

Hinzufügen eines Katalogs zu Ihrem Projekt

Die folgenden Abschnitte führen Sie durch die folgenden Aufgaben:

1. Forken Sie das Beispielkatalogrepository in Ihre GitHub-Organisation.
2. Installieren und Konfigurieren der Microsoft Dev Center-App.
3. Weisen Sie in GitHub Berechtigungen für die Repositorys zu.
4. Hinzufügen des Repositorys als Katalog

Forken des Beispielkatalogrepositorys

1. Öffnen Sie das Beispielkatalogrepository.
2. Wählen Sie Forken aus, um das Repository in Ihrer GitHub-Organisation zu forken.

Installieren der Microsoft Dev Center-App

1. Melden Sie sich beim Azure-Portal an.

2. Navigieren Sie zu Ihrem Dev Center oder Projekt.

3. Wählen Sie im Dienstmenü unter Umgebungskonfiguration die Option Kataloge und dann Hinzufügen aus.

4. Geben Sie im Bereich Katalog hinzufügen die folgenden Werte ein, oder wählen Sie sie aus:

   Feld	Wert
   Name	Geben Sie einen Namen für den Katalog ein.
   Katalogquelle	Wählen Sie GitHub aus.
   Authentifizierungstyp	Wählen Sie GitHub-App aus.

5. Wählen Sie den Link Ihre Repositorys konfigurieren aus.

   

6. Wenn Sie aufgefordert werden, sich bei GitHub zu authentifizieren, führen Sie die Authentifizierung durch.

7. Wählen Sie auf der Seite Microsoft DevCenter die Option Konfigurieren aus.

   

8. Wählen Sie die GitHub-Organisation aus, die das Repository enthält, das Sie als Katalog hinzufügen möchten. Sie müssen ein Besitzer der Organisation sein, um diese App installieren zu können.

   

9. Wählen Sie auf der Seite Microsoft DevCenter installieren die Option Nur ausgewählte Repositorys aus, wählen Sie das Repository aus, das Sie als Katalog hinzufügen möchten, und wählen Sie anschließend Installieren aus.

   

   Sie können mehrere Repositorys auswählen, um sie als Kataloge hinzuzufügen. Sie müssen jedes Repository als separaten Katalog hinzufügen, wie im nächsten Abschnitt dieses Schnellstarts beschrieben.

10. Überprüfen Sie auf der Seite Microsoft DevCenter von Microsoft benötigt Berechtigung für Folgendes die erforderlichen Berechtigungen, und wählen Sie dann Microsoft DevCenter autorisieren aus.

    

Hinzufügen des Repositorys als Katalog

1. Kehren Sie zum Azure-Portal zurück.

2. Geben Sie im Bereich Katalog hinzufügen die folgenden Informationen ein, und wählen Sie dann Hinzufügen aus:

   Feld	Wert
   Repository	Wählen Sie das Repository aus, das Sie als Katalog hinzufügen möchten.
   Branch	Wählen Sie den Branch aus.
   Ordnerpfad	Wählen Sie den Ordner aus, der Unterordner mit Ihren Umgebungsdefinitionen enthält.

   

3. Vergewissern Sie sich im Bereich Kataloge, dass Ihr Katalog angezeigt wird. Wenn die Verbindung erfolgreich hergestellt wurde, wird in der Spalte Status der Wert Synchronisierung erfolgreich angezeigt.

   

Erstellen eines Dev-Box-Pools für die Imagedefinition

Damit beim Erstellen von Dev-Boxen auf die Anpassungsdatei „imagedefintion.yaml“ zugegriffen werden kann, geben Sie sie als Imagedefintion für einen Pool an.

So erstellen Sie einen Dev-Box-Pool, der einem Projekt zugeordnet ist

1. Melden Sie sich beim Azure-Portal an.

2. Geben Sie im Suchfeld Projekte ein. Wählen Sie in der Ergebnisliste Projekte aus.

3. Öffnen Sie das Projekt, in dem Sie den Dev-Box-Pool erstellen möchten.

4. Wählen Sie Dev-Box-Pools und dann Erstellen aus.

5. Geben Sie im Bereich Dev-Box-Pool erstellen die folgenden Werte ein:

   Einstellung	Wert
   Name	Geben Sie einen Namen für den Pool ein. Der Poolname kann von den Entwicklern bei der Erstellung von Dev-Boxen ausgewählt werden. Der Name muss innerhalb eines Projekts eindeutig sein.
   Definition	Wählen Sie die Definition aus, die in der Imagedefinitionsdatei benannt ist.
   Netzwerkverbindung	1. Wählen Sie In einem von Microsoft gehosteten Netzwerk bereitstellen aus. 2. Wählen Sie Ihre gewünschte Bereitstellungsregion für die Dev-Boxes aus. Wählen Sie eine Region in der Nähe der Dev-Box-Benutzer aus, um eine optimale Benutzererfahrung zu erzielen.
   Erstellerberechtigungen für Dev Box	Wählen Sie Lokaler Administrator oder Standardbenutzer aus.
   Automatisches Beenden aktivieren	Ja ist die Standardeinstellung. Wählen Sie Nein aus, um einen Zeitplan für automatische Beendigung zu deaktivieren. Sie können einen Zeitplan für automatisches Beenden konfigurieren, nachdem der Pool erstellt wurde.
   Endzeit	Wählen Sie einen Zeitpunkt aus, zu dem alle Dev-Boxen im Pool heruntergefahren werden sollen. Alle Dev-Boxen in diesem Pool werden zu diesem Zeitpunkt täglich heruntergefahren.
   Zeitzone	Wählen Sie die Zeitzone für den Zeitpunkt der Beendigung aus.
   Lizenzierung	Aktivieren Sie dieses Kontrollkästchen, um zu bestätigen, dass Ihre Organisation über Azure-Hybridvorteil-Lizenzen verfügt, die Sie auf die Dev-Boxen in diesem Pool anwenden möchten.

   

6. Klicken Sie auf Erstellen.

7. Überprüfen Sie, ob der neue Dev-Box-Pool in der Liste angezeigt wird. Möglicherweise müssen Sie den Bildschirm aktualisieren.

Das Azure-Portal stellt den Dev-Box-Pool bereit und führt Integritätsprüfungen aus, um sicherzustellen, dass das Image und das Netzwerk die Überprüfungskriterien für Dev-Boxen erfüllen.

Erstellen einer Dev-Box aus dem Dev-Box-Pool

Wenn Sie eine Dev-Box aus einem Dev-Box-Pool erstellen, wird die Imagedefinition auf die Dev-Box angewendet. Die Dev-Box wird mit den in der Imagedefinitionsdatei angegebenen Anpassungen erstellt.

So erstellen Sie eine Dev-Box im Microsoft Dev Box-Entwicklerportal:

1. Melden Sie sich beim Microsoft Dev Box-Entwicklerportal an.

2. Wählen Sie Neues>Neue Dev-Box aus.

3. Geben Sie unter Dev-Box hinzufügen die folgenden Werte ein:

   Einstellung	Wert
   Name	Geben Sie einen Namen für die Dev-Box ein. Dev-Box-Namen müssen innerhalb eines Projekts eindeutig sein.
   Projekt	Wählen Sie ein Projekt aus der Dropdownliste aus.
   Dev-Box-Pool	Wählen Sie einen Pool in der Dropdownliste aus, die alle Dev-Box-Pools für dieses Projekt enthält. Wählen Sie für die geringste Latenz einen Dev-Box-Pool in der Nähe aus.

   Nachdem Sie Ihre Auswahl getroffen haben, werden auf der Seite die folgenden Informationen angezeigt:

   • Anzahl der Dev-Boxes, die Sie im ausgewählten Projekt erstellen können, wenn für das Projekt Grenzwerte konfiguriert sind
   • Angabe dazu, ob der Ruhezustand unterstützt wird oder nicht
   • Ob Anpassungen aktiviert sind oder nicht.
   • Ein Zeitpunkt zum Herunterfahren, wenn für den Pool, in dem Sie die Dev-Box erstellen, ein Zeitplan für das Herunterfahren konfiguriert wurde
   • Eine Benachrichtigung darüber, dass der Erstellungsprozess der Dev-Box 25 Minuten oder länger dauern kann.

4. Wählen Sie Erstellen aus, um mit der Erstellung Ihrer Dev-Box zu beginnen.

5. Verwenden Sie die Kachel „Dev-Box“ im Entwicklerportal, um den Fortschritt der Erstellung nachzuverfolgen.

Überprüfen, ob die Anpassung angewendet wird

Dev Box wendet Anpassungen als letzte Phase des Erstellungsprozesses an. Dev Box informiert Sie per E-Mail, wenn die Dev-Box bereit ist. Anschließend können Sie überprüfen, ob Ihre Anpassungen angewendet werden.

1. Warten Sie auf die E-Mail-Bestätigung, dass die Dev-Box erstellt wurde.

2. Wählen Sie im Entwicklerportal auf der Kachel „Dev-Box“ die Option Aktionen>Anpassungen aus.

   

3. Überprüfen Sie im Bereich Anpassungsdetails die Anpassungen, die auf die Dev-Box angewendet wurden.

   

Bereinigen von Ressourcen

1. Melden Sie sich beim Entwicklerportal an.

2. Wählen Sie im Menü Aktionen der Dev-Box, die Sie löschen möchten, die Option Löschen aus.

   

3. Um das Löschen zu bestätigen, wählen Sie Löschen aus.

   

Zugehöriger Inhalt

• Microsoft Dev Box-Teamanpassungen
• Schreiben einer Anpassungsdatei für eine Dev-Box