Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Sie können Ihr Microsoft Dev Box personalisieren, indem Sie eine Benutzeranpassungsdatei hochladen. Mithilfe von Benutzeranpassungsdateien können Sie Ihr Entwicklerfeld mit Ihren bevorzugten persönlichen Einstellungen und Apps konfigurieren, sodass Sie mit dem Codieren schneller beginnen können. In diesem Artikel wird erläutert, wie Sie eine Benutzeranpassungsdatei mithilfe von Visual Studio(VS)-Code von Ihrem lokalen Laufwerk oder Repository erstellen, testen und hochladen. Außerdem erfahren Sie, wie Sie Ihre Datei überprüfen und Anpassungseinstellungen für Projekte verwalten.
Verwenden Sie Anpassungen in Microsoft Dev Box auf zwei Arten: Teamanpassungen erstellen eine freigegebene Konfiguration für ein Team, und Benutzeranpassungen erstellen eine persönliche Konfiguration für einen einzelnen Entwickler. Die folgende Tabelle zeigt die Unterschiede zwischen den beiden Arten von Anpassungen.
| Merkmal | Teamanpassungen | Benutzeranpassungen |
|---|---|---|
| Einrichten 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 |
| Quelle | Katalog | Hochladen oder persönliches Repository |
| Unterstützt Schlüsseltresorschlüssel | Ja | Ja |
Benutzeranpassungen tragen dazu bei, dass Fachkräfte in der Entwicklung Unternehmensrichtlinien einhalten. Nur Aufgaben, die vorab über einen Katalog genehmigt wurden, stehen Fachkräften in der Entwicklung für die Verwendung in ihren Anpassungsdateien zur Verfügung. Standardmäßige Entwicklerbox-Benutzer können keine integrierten PowerShell- und WinGet-Aufgaben in einem Systemkontext ausführen, wodurch die Eskalation von Berechtigungen verhindert wird.
Benutzeranpassungen können auf Projektebene aktiviert oder deaktiviert werden. Wenn Sie ein Projekt erstellen, sind Benutzeranpassungen standardmäßig aktiviert.
Voraussetzungen
Zur Durchführung der in diesem Artikel aufgeführten Schritte ist Folgendes erforderlich:
- Richten Sie ein Dev Center mit einer Dev Box-Definition, einem Dev Box-Pool und einem Dev Box-Projekt ein, damit Sie ein Entwicklerfeld erstellen können.
- Treten Sie der Sicherheitsgruppe "Dev Box-Benutzer" für mindestens ein Projekt bei.
- Fügen Sie einen Katalog mit Aufgaben, die Sie in Ihrer Anpassungsdatei verwenden, an das Dev Center an. Wenn Sie keinen Katalog besitzen, lesen Sie die Informationen unter Hinzufügen und Konfigurieren eines Katalogs aus GitHub oder Azure Repos.
Zum Einrichten von Anpassungen erforderliche Berechtigungen
Zum Erstellen und Anwenden von Anpassungen auf ein Entwicklerfeld benötigen Sie die folgenden Berechtigungen:
| Maßnahme | Berechtigung oder Rolle |
|---|---|
| Aktivieren oder Deaktivieren von Benutzeranpassungen für ein Projekt | Schreibberechtigung für das Projekt |
| Erstellen einer Anpassungsdatei | Keine Angabe. Jeder kann eine Anpassungsdatei erstellen. |
| Verwenden des Entwicklerportals zum Hochladen und Anwenden einer YAML-Datei während der Erstellung von Entwicklungsboxen | Dev-Box-Benutzer |
Erstellen einer Benutzeranpassungsdatei
Erstellen und Verwalten von Anpassungsdateien in VS Code. Verwenden Sie die Microsoft Dev Box-Erweiterung in VS Code, um Aufgaben im angefügten Katalog zu ermitteln und die Anpassungsdatei zu testen.
Erstellen Sie ein Entwicklerfeld zum Testen, oder verwenden Sie ein vorhandenes Entwicklerfeld.
Installieren Sie im Test dev box VS Code, und installieren Sie dann die Dev Box-Erweiterung.
Laden Sie eine Beispiel-YAML-Anpassungsdatei aus dem Beispiel-Repository herunter, und öffnen Sie sie dann in VS Code.
Entdecken Sie verfügbare Aufgaben im Katalog mithilfe der Befehlspalette. Wählen Sie Ansicht>Befehlspalette>Dev-Box: Verfügbare Tasks für diese Dev-Box auflisten aus.
Testen Sie die Anpassung in VS Code mithilfe der Befehlspalette. Wählen Sie Ansicht>Befehlspalette>Dev-Box: Anpassungstasks anwenden aus.
Die Anpassungsdatei wird ausgeführt und wendet die angegebenen Aufgaben auf Ihr Test-Entwicklungsfeld an. Überprüfen Sie die Änderungen, und überprüfen Sie das VS Code-Terminal auf Fehler oder Warnungen während der Aufgabenausführung.
Nachdem die Anpassungsdatei erfolgreich ausgeführt wurde, laden Sie sie in Ihren Katalog hoch.
Optional: Anpassen Des Entwicklerfelds mithilfe vorhandener WinGet-Konfigurationsdateien
Die WinGet-Konfiguration verwendet einen Config-as-Code-Ansatz, um die eindeutigen Gruppen von Software- und Konfigurationseinstellungen zu definieren, die erforderlich sind, um Ihre Windows-Umgebung codebereit zu machen. Sie können diese Konfigurationsdateien auch verwenden, um ein Entwicklerfeld einzurichten, indem Sie eine WinGet-Aufgabe verwenden, die im von Microsoft bereitgestellten Schnellstartkatalog enthalten ist.
Dieses Beispiel zeigt eine Entwicklungsfeldanpassungsdatei, die eine vorhandene WinGet Desired State Configuration (DSC)-Datei verwendet.
tasks:
- name: winget
parameters:
configure: "projectConfiguration.dsc.yaml"
Weitere Informationen finden Sie unter WinGet-Konfiguration.
Erstellen eines Entwicklerfelds mithilfe einer Benutzeranpassungsdatei
Verwenden Sie eine einzelne Anpassungsdatei, indem Sie sie von einem lokalen Laufwerk hochladen, wenn Sie Ihr Entwicklerfeld erstellen, oder indem Sie sie aus einem Repository herunterladen. Anpassungsdateien, die in einem Repository gespeichert sind, müssen den Namen "workload.yaml" haben. Anpassungsdateien, die lokal für den Upload gespeichert sind, sollten den Namen "myfilename.yaml" haben.
Hochladen einer Datei
Wählen Sie im EntwicklerportalNeu>Neue Entwicklerbox aus.
Fügen Sie im Bereich " Entwicklerfeld hinzufügen " Details zu Ihrem Entwicklerfeld hinzu.
Wählen Sie "Anpassungen anwenden" und dann " Weiter" aus.
Wählen Sie "Anpassungsdatei hochladen" aus, wählen Sie "Anpassungen aus Datei hinzufügen" aus, navigieren Sie dann zu Ihrer Datei "myfilename.yaml ".
Um zu überprüfen, ob die Aufgaben in der Anpassungsdatei ordnungsgemäß angewendet werden, überprüfen Sie sie, bevor Sie fortfahren. Wählen Sie "Überprüfen" aus.
Überprüfen Sie die Erstellungszusammenfassung des Entwicklerfelds, und wählen Sie dann "Erstellen" aus.
Abrufen einer Datei aus einem Repository
Wählen Sie im EntwicklerportalNeu>Neue Entwicklerbox aus.
Im Bereich "Dev-Box hinzufügen" fügen Sie Details für die Dev-Box hinzu.
Wählen Sie "Anpassungen anwenden" und dann " Weiter" aus.
Wählen Sie "Anpassungsdatei hochladen" aus, wählen Sie eine Anpassungsdatei aus einem Repository aus, und geben Sie dann die URL für das Repository ein, in dem Ihre Datei "workload.yaml " gespeichert ist.
Um zu überprüfen, ob die Aufgaben in der Anpassungsdatei ordnungsgemäß angewendet werden, überprüfen Sie sie, bevor Sie fortfahren. Wählen Sie "Überprüfen" aus.
Überprüfen Sie die Zusammenfassung der Erstellung der Entwicklerbox, und wählen Sie anschließend Erstellen aus.
Benutzeranpassungen deaktivieren
Benutzeranpassungen werden auf Projektebene gesteuert und standardmäßig aktiviert. Sie können sie während oder nach der Projekterstellung deaktivieren. Wenn sie deaktiviert sind, können Entwickler ihre eigenen Anpassungsdateien nicht auf neue Entwicklerfelder anwenden. Durch das Aktivieren von Benutzeranpassungen werden vorhandene Projektschutzschienen nicht umgangen. Entwickler können nur Aufgaben verwenden, die im angefügten Katalog bereitgestellt werden, und aufgaben mit erhöhten Rechten nicht ausführen, es sei denn, ein Administrator hat explizit eine Administrative Aufgabe in den Katalog aufgenommen.
Deaktivieren von Benutzeranpassungen über das Azure-Portal
Melden Sie sich beim Azure-Portal an.
Geben Sie im Suchfeld Projekte ein. Wählen Sie in der Ergebnisliste "Projekte" aus.
Wählen Sie auf der Seite "Projekte " das Projekt aus, in dem Sie Benutzeranpassungen deaktivieren möchten.
Wechseln Sie zu Einstellungen>Dev-Box-Einstellungen.
Um Benutzeranpassungen zu deaktivieren, entfernen Sie das Häkchen im Kontrollkästchen Aktivieren, und wählen Sie dann Übernehmen aus.
Entwicklererfahrung im Entwicklerportal
Wenn Sie Benutzeranpassungen für ein Projekt deaktivieren, können Entwickler während der Erstellung des Entwicklungsfelds weiterhin eine Benutzeranpassungsdatei hochladen, der Überprüfungsprozess schlägt jedoch fehl, und die Anpassungen werden nicht auf das Entwicklerfeld angewendet.
Wenn Sie ein Entwicklerfeld mit Benutzeranpassungen in einem Projekt erstellen, in dem Benutzeranpassungen deaktiviert sind, wird folgendes im Entwicklerportal angezeigt:
In einer Meldung auf der Kachel für das neue Entwicklerfeld werden Fehler beim Anwenden von Anpassungen angezeigt.
Die Details sagen, dass Sie sich an Ihren Administrator wenden.
Das Entwicklerfeld enthält keine Benutzeranpassungen.