Schreiben einer Bilddefinitionsdatei für Dev Box-Teamanpassungen

Mit dem Feature "Microsoft Dev Box-Anpassungen" können Sie die Einrichtung cloudbasierter Entwicklungsumgebungen optimieren. Das Einführen von Entwicklern in ein neues Projekt oder Team ist oft komplex und zeitaufwändig. Mit Anpassungen können Sie Fertigarbeitsstationen mit Anwendungen, Tools, Repositorys, Codebibliotheken, Paketen und Buildskripts konfigurieren. Dieser Artikel führt Sie durch den Prozess des Erstellens, Testens und Bearbeitens einer Bilddefinitionsdatei für Ihr Entwicklungsfeld mithilfe von Visual Studio Code.

Es gibt zwei Möglichkeiten, Anpassungen in Dev Box zu verwenden. Teamanpassungen erstellen eine gemeinsame Konfiguration für ein Team von Entwicklern. Benutzeranpassungen erstellen eine persönliche Konfiguration für einen einzelnen Entwickler. In der folgenden Tabelle sind die Unterschiede zwischen den beiden Anpassungstypen zusammengefasst.

Merkmal	Teamanpassungen	Benutzeranpassungen
Konfigurieren am	Dev-Box-Pool	Dev-Box
Anpassungen gelten für	Alle Dev-Boxen im Pool	Individuelle Dev-Box
Einfach zu teilen	Ja	Nein
Dateiname der Anpassungen	Imagedefinition.yaml	myfilename.yaml oder Workload.yaml
Erstellt aus	Katalog	Hochgeladen oder aus persönlichem Repository
Unterstützt Schlüsseltresorschlüssel	Ja	Ja

Voraussetzungen

• Verfügen Sie über ein Dev Center, das mit einem Dev Box-Pool und einem Dev Box-Projekt konfiguriert ist, damit Sie ein Entwicklerfeld erstellen können.
• Sie müssen Mitglied der Sicherheitsgruppe „Dev Box Benutzer“ für mindestens ein Projekt sein.
• Weisen Sie dem Dev Center einen Katalog mit Aufgaben zu, die Sie in Ihrer Bilddefinitionsdatei verwenden können. Wenn Sie keinen Katalog besitzen, lesen Sie die Informationen unter Hinzufügen und Konfigurieren eines Katalogs aus GitHub oder Azure Repos.

Erforderliche Berechtigungen zum Konfigurieren von Anpassungen

Maßnahme	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.	Dev Center-Projektadministrator- oder Mitwirkendenberechtigungen für das Projekt.
Erstellen Sie eine Bilddefinitionsdatei.	Keine Angabe. Jeder kann eine Bilddefinitionsdatei erstellen.
Hinzufügen von Aufgaben zu einem Katalog.	Berechtigung zum Hinzufügen zum Repository, das den Katalog hosten soll.

Auswählen einer Quelle für Anpassungsaufgaben

Sie können Dev Box-Aufgaben aus aufgaben erstellen, die auf der Plattform integriert sind, oder benutzerdefinierte Aufgaben verwenden, die in einem Katalog gespeichert sind. Wählen Sie die Quelle aus, die ihren Anpassungsanforderungen und Projektanforderungen am besten entspricht.

• Verwenden Sie integrierte WinGet- und PowerShell-Aufgaben. Dev Box Dev Center unterstützen PowerShell- und WinGet-Aufgaben sofort. Sie können mit diesen integrierten Aufgaben beginnen. Wenn Ihre Anpassungen nur PowerShell und WinGet erfordern, fahren Sie mit dem Erstellen der Anpassungsdatei fort. Weitere Informationen finden Sie unter Erstellen einer Bilddefinitionsdatei.

  Die integrierte Aufgabe von WinGet ist nicht die ausführbare WinGet-Datei. Die integrierte WinGet-Aufgabe basiert auf dem PowerShell-WinGet-Cmdlet.

• Verwenden Sie einen Katalog, um benutzerdefinierte Aufgaben zu definieren. Sie können eigene benutzerdefinierte Aufgaben erstellen. Um benutzerdefinierte Aufgaben für Ihre gesamte Organisation verfügbar zu machen, fügen Sie einen Katalog an, der benutzerdefinierte Aufgabendefinitionen enthält, an Ihr Dev Center. Dev Box unterstützt Azure Repos- und GitHub-Kataloge. Da Aufgaben nur im Dev Center definiert sind, speichern Sie Aufgaben und Bilddefinitionen in separaten Repositorys.

  Weitere Informationen zum Definieren von benutzerdefinierten Aufgaben finden Sie unter Erstellen von Aufgaben für Dev Box-Teamanpassungen.

Erstellen von Bilddefinitionen auf Projektebene

Projekte können Ihnen helfen, Dev Box-Ressourcen effizient zu verwalten. Indem Sie jedem Entwicklerteam ein eigenes Projekt zuweisen, können Sie Ressourcen effektiv organisieren. Sie können mehrere Bilddefinitionen in Ihrem Katalog-Repository erstellen, die jeweils in ihrem eigenen Ordner für unterschiedliche Entwicklerteams unter Ihrem Projekt vorgesehen sind.

Zuweisen von Berechtigungen für Projektadministratoren

Um einen Katalog an ein Projekt anzufügen, müssen Sie über die Berechtigung "Projektadministrator" oder "Mitwirkender" für das Projekt verfügen. Informationen zum Zuweisen von Project-Administratorberechtigungen finden Sie unter Erteilen des Administratorzugriffs auf Dev Box-Projekte.

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. So aktivieren Sie das Verwenden von Katalogen auf Projektebene auf Dev Center-Ebene:

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

2. Wählen Sie im linken Menü 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.

   

Weitere Informationen zum Hinzufügen von Katalogen zu Projekten finden Sie unter Hinzufügen und Konfigurieren eines Katalogs aus GitHub oder Azure Repos.

Erstellen einer Bilddefinitionsdatei

Sie können Bilddefinitionsdateien mithilfe von Visual Studio Code erstellen und testen. Zusätzlich zur Verwendung der integrierten Aufgaben können Sie die Dev Box-Erweiterung in Visual Studio Code verwenden, um die benutzerdefinierten Aufgaben zu ermitteln, die über Ihr Dev Center verfügbar sind.

1. Erstellen Sie eine Dev-Box (oder verwenden Sie eine vorhandene Dev-Box) zum Testen.

2. Installieren Sie visual Studio Code im Test-Entwicklungsfeld, und installieren Sie dann die Dev Box-Erweiterung.

3. Laden Sie ein Beispiel für eine YAML-Bilddefinitionsdatei aus dem Beispiel-Repository herunter. Öffnen Sie es in Visual Studio Code.

4. Ermitteln Sie die Aufgaben, die im Katalog verfügbar sind, mithilfe der Befehlspalette. Wählen Sie Ansicht>Befehlspalette>Dev-Box: Verfügbare Tasks für diese Dev-Box auflisten aus.

   

5. Testen Sie die Anpassung in Visual Studio Code mithilfe der Befehlspalette. Wählen Sie Ansicht>Befehlspalette>Dev-Box: Anpassungstasks anwenden aus.

   

6. Die Bilddefinitionsdatei wird ausgeführt und wendet die angegebenen Aufgaben auf Ihr Test-Entwicklungsfeld an. Sehen Sie sich die Änderungen an, und überprüfen Sie das Visual Studio Code-Terminal auf Fehler oder Warnungen, die während der Taskausführung generiert wurden.

7. Wenn die Bilddefinitionsdatei erfolgreich ausgeführt wird, laden Sie sie in Ihren Katalog hoch.

Systemaufgaben und Benutzeraufgaben

Sie können sowohl System- als auch Benutzeraufgaben in Ihrer Bilddefinitionsdatei verwenden. Der Aufgabenabschnitt der Bilddefinitionsdatei ist in die folgenden Abschnitte unterteilt. Beide Abschnitte verwenden dieselben Parameter basierend auf den Aufgabendefinitionen in Ihrem Katalog.

• Systemaufgaben: Diese Aufgaben werden während der Bereitstellungsphase der Dev-Box als LocalSystem ausgeführt. Sie werden in der Regel für Konfigurationen auf Systemebene verwendet, z. B. das Installieren von Software oder das Konfigurieren von Systemeinstellungen, die Administratorrechte erfordern.
• Benutzeraufgaben: Diese Aufgaben werden nach der ersten Anmeldung des Benutzers beim Entwicklerfeld als Benutzer ausgeführt. Sie werden in der Regel für Konfigurationen auf Benutzerebene verwendet, z. B. das Installieren von benutzerspezifischen Anwendungen oder das Konfigurieren von Benutzereinstellungen im Benutzerkontext. Benutzer bevorzugen z. B. häufig die Installation von Python und Visual Studio Code im Benutzerkontext anstelle von Systemweite. Fügen Sie WinGet-Aufgaben in den userTasks Abschnitt ein, um bessere Ergebnisse zu erzielen, wenn sie unter Aufgaben nicht funktionieren.

Standardbenutzer, die Benutzeranpassungen konfigurieren, können nur Benutzeraufgaben verwenden. Sie können keine Systemaufgaben verwenden.

Optional: Passen Sie Ihre Dev Box mit vorhandenen Desired State Configuration-Dateien an.

Desired State Configuration (DSC) ist eine Verwaltungsplattform in PowerShell, mit der Sie Ihre Entwicklungsumgebung mit Konfiguration als Code verwalten können. Sie können DSC verwenden, um den gewünschten Zustand Ihres Entwicklungsfelds zu definieren, einschließlich Softwareinstallationen, Konfigurationen und Einstellungen.

Sie können auch DSC-Konfigurationsdateien verwenden, um ein Entwicklerfeld mithilfe einer integrierten WinGet-Aufgabe einzurichten.

Das folgende Beispiel zeigt eine Dev Box-Bilddefinitionsdatei, die eine vorhandene WinGet-DSC-Datei aufruft:

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

Weitere Informationen finden Sie unter WinGet-Konfiguration.

Konfigurieren von Katalogsynchronisierungseinstellungen für das Projekt

Konfigurieren Sie Ihr Projekt, um Imagedefinitionen aus dem Katalog zu synchronisieren. Mit dieser Einstellung können Sie die Imagedefinitionen im Katalog verwenden, um Dev-Box-Pools zu erstellen.

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 Dev Box-Projekt, für das Sie Katalogsynchronisierungseinstellungen konfigurieren möchten.

4. Wählen Sie Kataloge aus.

5. Wählen Sie Synchronisierungseinstellungen aus.

   

6. Wählen Sie im Bereich Synchronisierungseinstellungen die Option Imagedefinitionen und dann Speichern aus.

   

Anfügen eines Katalogs, der die Definitionsdatei enthält

Bevor Sie eine Anpassungsdatei als Imagedefinition verwenden können, müssen Sie einen Katalog mit der Definitionsdatei an Ihre Dev Center-Instanz oder Ihr Projekt anfügen. Der Katalog kann aus GitHub oder Azure Repos stammen.

Im Bereich "Bilddefinitionen " werden die Bilddefinitionen aufgelistet, auf die Ihr Projekt zugreifen kann.

Weitere Informationen zum Anfügen von Katalogen finden Sie unter Hinzufügen und Konfigurieren eines Katalogs von GitHub oder Azure Repos.

Konfigurieren eines Dev-Box-Pools für die Verwendung einer Imagedefinition

Machen Sie Anpassungen für Ihre Entwicklungsteams verfügbar, indem Sie einen Entwicklerboxpool für die Verwendung einer Anpassungsdatei (imagedefinition.yaml) konfigurieren. Speichern Sie die Anpassungsdatei in einem Repository, das mit einem Katalog in Ihrem Dev Center oder Projekt verknüpft ist. Geben Sie diese Datei als Imagedefinition für den Pool an, und die Anpassungen werden auf neue Dev-Boxen angewendet.

Die folgenden Schritte zeigen, wie Sie einen Dev-Box-Pool erstellen und eine Imagedefinition angeben:

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 Dev-Box-Projekt, dem der neue Dev-Box-Pool zugeordnet werden soll.

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

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

   Konfiguration	Wert
   Name	Geben Sie einen Namen für den Pool ein. Der Poolname ist für Entwickler sichtbar, um ihn beim Erstellen von Dev-Boxen auszuwählen. Er muss innerhalb eines Projekts eindeutig sein.
   Definition	Diese Box listet Imagedefinitionen aus zugänglichen Katalogen und Dev-Box-Definitionen auf. Wählen Sie eine Imagedefinitionsdatei aus.
   Netzwerkverbindung	Wählen Sie Bereitstellen in einem von Microsoft gehosteten Netzwerk oder verwenden Sie eine bestehende Netzwerkverbindung.
   Einmaliges Anmelden aktivieren	Wählen Sie Ja aus, um einmaliges Anmelden für die Dev-Boxes in diesem Pool zu aktivieren. Einmaliges Anmelden muss für die Organisation konfiguriert werden. Weitere Informationen finden Sie unter Aktivieren des einmaligen Anmeldens für Dev Boxen.
   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 Autostopp-Zeitplan zu deaktivieren. Sie können einen Zeitplan für das automatische Stoppen konfigurieren, nachdem der Pool erstellt wurde.
   Endzeit	Wählen Sie einen Zeitpunkt aus, zu dem alle Dev-Boxen im Pool heruntergefahren werden sollen.
   Zeitzone	Wählen Sie die Zeitzone aus, die die Beendigungszeit vorgibt.
   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. Wählen Sie "Erstellen" aus.

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

Erstellen einer Dev-Box mithilfe des Entwicklerportals

Um zu überprüfen, ob Anpassungen aus der Bilddefinitionsdatei angewendet werden, erstellen Sie ein Entwicklerfeld im Dev Box-Entwicklerportal. Führen Sie die Schritte im Schnellstart: Erstellen und Verbinden einer Dev-Box über das Dev Box-Entwicklerportal aus. Sie können dann eine Verbindung mit der neu erstellten Dev-Box herstellen und überprüfen, ob die Anpassungen wie erwartet funktionieren.

Sie können Änderungen an der Anpassungsdatei vornehmen und eine neue Dev-Box erstellen, um die Änderungen zu testen. Wenn Sie sicher sind, dass die Anpassungen korrekt sind, können Sie ein wiederverwendbares Image erstellen.

Nächster Schritt

Nachdem Sie nun über eine Bilddefinitionsdatei verfügen, laden Sie sie in einen Katalog hoch, und fügen Sie den Katalog an ein Projekt an. Die Bilddefinitionsdatei wird zum Konfigurieren und Erstellen von Entwicklungsfeldern für Ihre Entwicklungsteams verwendet.

Imaging für Dev Box-Teamanpassungen konfigurieren