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.

Voraussetzungen

Erstellen einer Imagedefinition

Um ein Entwicklerfeld mit Anpassungen zu erstellen, müssen Sie eine Bilddefinitionsdatei erstellen. Die Bilddefinitionsdatei ist eine YAML-Datei, die die Anpassungen enthält, die Sie auf das Entwicklerfeld anwenden möchten. Sie können die Beispielbilddefinitionsdatei in dieser Schnellstartanleitung als Ausgangspunkt verwenden.

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 Dev Center-Einstellungen aus.

3. Wählen Sie unter 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. Konfigurieren Sie Synchronisierungseinstellungen, um den Katalog mit Ihrem Projekt zu synchronisieren.
3. Hinzufügen des Repositorys als Katalog

Forken des Beispielkatalogrepositorys

1. Öffnen Sie das Beispielkatalogrepository.

2. Wählen Sie "Verzweigung>erstellen" aus , um das Repository in Ihre GitHub-Organisation zu verzweigen.

   

Konfigurieren von Katalogsynchronisierungseinstellungen

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

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

3. Wählen Sie das Projekt aus, dem Sie den Katalog hinzufügen möchten.

4. Wählen Sie im linken Menü "Einstellungenkataloge"> aus.

5. Wählen Sie Synchronisierungseinstellungen aus.

   

6. Im Bereich "Synchronisierungseinstellungen ":

   • Wenn Bilddefinitionen deaktiviert sind, wählen Sie sie aus, und wählen Sie " Speichern" aus.
   • Wenn Bilddefinitionen bereits ausgewählt sind, wählen Sie "Abbrechen" aus.

   

Hinzufügen des Repositorys als Katalog

1. Wählen Sie auf der Seite "Kataloge " die Option "Hinzufügen" aus.

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

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

   

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

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

   

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

   

7. Wählen Sie auf der Seite "Microsoft DevCenter installieren " nur Repositorys aus, wählen Sie das Repository aus, das Sie als Katalog hinzufügen möchten, und wählen Sie dann " Speichern" 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.

8. Wechseln Sie zurück zum Azure-Portal.

9. Wählen Sie im Bereich "Katalog hinzufügen " die Option "Mit GitHub anmelden" aus.

10. 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 Ihre Bilddefinition enthält. Beispiel: eShop
    Abteilung	Wählen Sie die Verzweigung aus. Beispiel: Haupt
    Ordnerpfad	Wählen Sie den Ordner aus, der Unterordner enthält, die Ihre Bilddefinitionen enthalten. Beispiel: .devcenter/catalog/image-definitions

11. Überprüfen Sie im Katalogbereich, ob Ihr Katalog angezeigt wird. Wenn die Verbindung erfolgreich hergestellt wurde, wird in der Spalte Status der Wert Synchronisierung erfolgreich angezeigt.

    

12. Stellen Sie sicher, dass die Bilddefinitionen ordnungsgemäß synchronisiert werden. Wählen Sie im linken Menü "Bilddefinitionenverwalten"> aus. In diesem Beispiel werden zwei Bilddefinitionen angezeigt:

    • Back-End-Entwicklung – Dieses Image ist ein Microsoft Visual Studio + Tools-Image unter Windows 11, das für die eShop-Back-End-Engineering-Umgebung geeignet ist.
    • frontend-dev – Dieses Image ist ein Microsoft Visual Studio + Tools-Image unter Windows 11, das für die eShop-Frontend-Engineering-Umgebung geeignet ist.

    

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 Einem Projekt zugeordneten Dev Box-Pool:

1. Im Azure-Portal.

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 im linken Menü "Dev-Boxpoolsverwalten>" aus.

5. Wählen Sie auf der Seite "Dev box pools " die Option "Erstellen" aus.

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

   Einstellung	Wert
   Name	Geben Sie einen beschreibenden Namen für den Pool ein. Der Poolname ist für Entwickler sichtbar, die beim Erstellen von Entwicklungsfeldern ausgewählt werden sollen. Schließen Sie daher den Zweck und die Region des Pools ein. Der Name muss innerhalb eines Projekts eindeutig sein. Beispiel: contoso-frontend-westUS
   Definition	Wählen Sie im Abschnitt "Bilddefinition" der Liste eine Bilddefinition aus. Beispiel: contoso-catalog/frontend-dev
   Berechnen	Wählen Sie die Computeressourcen für die Entwicklungsfelder im Pool aus. Beispiel: 8 vCPU, 32 GB RAM
   Lagerung	Wählen Sie die Speicheroptionen für die Entwicklerfelder im Pool aus. Beispiel: 256 GB SSD
   Winterschlaf	Die Ruhezustand wird unterstützt, wenn das Quellimage und die Berechnungsgröße beide kompatibel sind.
   Netzwerkverbindung	1. Wählen Sie In einem von Microsoft gehosteten Netzwerk bereitstellen aus. 2. Wählen Sie eine Bereitstellungsregion für die Entwicklungsfelder aus. Wählen Sie eine Region in der Nähe der Dev-Box-Benutzer aus, um eine optimale Benutzererfahrung zu erzielen. Beispiel: West-USA
   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.

   

7. Klicken Sie auf Erstellen.

8. Ü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 Neu>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 names must be unique within a project. Beispiel: contoso-frontend-dev-box
   Projekt	Das Entwicklerportal listet die Projekte auf, auf die Sie Zugriff haben. Wählen Sie das projekt aus der Liste aus.
   Dev-Box-Pool	Im Entwicklerportal werden alle Entwicklerfeldpools für das ausgewählte Projekt aufgelistet. Wählen Sie den entsprechenden Pool für Ihre Arbeit aus. Wählen Sie für die geringste Latenz einen Dev-Box-Pool in der Nähe aus.
   Anwenden von Anpassungen	Lassen Sie dieses Kontrollkästchen deaktiviert. Es wird verwendet, um Benutzeranpassungen anzuwenden. In diesem Artikel haben Sie Teamanpassungen konfiguriert.

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

   • Gibt an, ob der Ruhezustand unterstützt wird.
   • 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 Anpassungen angewendet werden

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, bis das Entwicklerfeld 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.

   

Verwandte Inhalte

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