Erstellen von Aufgaben für Dev Box-Teamanpassungen
Wenn Sie Aufgaben für Microsoft Dev Box-Teamanpassungen erstellen, können Sie bestimmte Aktionen für Ihre Entwicklungsfelder definieren, um eine konsistente und effiziente Entwicklungsumgebung sicherzustellen. Durch das Erstellen neuer Aufgaben in einem Katalog können Sie wiederverwendbare Komponenten definieren, die auf Ihre Entwicklungsteams zugeschnitten sind, sowie Schutzmaßnahmen für die möglichen Konfigurationen hinzufügen. In diesem Artikel werden die Schritte zum Erstellen eines Katalogs für Anpassungsaufgaben, zum Hinzufügen von Aufgaben und zum Anfügen des Katalogs an eine Dev Center-Instanz oder ein Projekt erläutert.
Wichtig
Die Funktion 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-Funktionen gelten, die sich in der Beta- oder Vorschauphase befinden oder anderweitig noch nicht allgemein verfügbar sind.
Voraussetzungen
Zur Durchführung der in diesem Artikel aufgeführten Schritte ist Folgendes erforderlich:
- Dev Center-Instanz mit einem Dev-Box-Projekt.
- Vorhandener Katalog auf GitHub oder in Azure Repos.
Erforderliche Berechtigungen zum Konfigurieren von Anpassungen
Um die erforderlichen Aktionen zum Erstellen und Anwenden von Anpassungen auf ein Entwicklerfeld 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 hosten soll. |
Was sind Tasks?
Ein Task führt eine bestimmte Aktion aus, z. B. die Installation von Software. Jeder Task besteht aus einem oder mehreren PowerShell-Skripts sowie der Datei task.yaml, die Parameter bereitstellt und definiert, wie die Skripts ausgeführt werden. Sie können auch einen PowerShell-Befehl in die Datei „task.yaml“ einschließen.
Sie können eine Sammlung kuratierter Aufgaben in einem Katalog speichern, der Ihrem Dev Center zugeordnet ist, wobei jede Aufgabe in einem separaten Ordner enthalten ist. Dev Box unterstützt die Verwendung eines GitHub-Repositorien oder eines Azure Repos-Repositorien als Katalog. Dev Box überprüft einen angegebenen Ordner des Katalogs rekursiv, um Aufgabendefinitionen zu finden.
WinGet und PowerShell sind in jeder Dev Center-Instanz verfügbar, ohne dass ein Katalog erforderlich ist. Wenn Ihre Anpassungen nur WinGet oder PowerShell nutzen, können Sie Aufgaben erstellen, die sie in einer Anpassungsdatei verwenden. Wenn Sie andere Tools oder Skripts verwenden müssen, können Sie Aufgaben in einem Katalog erstellen.
Microsoft stellt einen Schnellstartkatalog zur Verfügung, der Ihnen bei den ersten Schritten mit Anpassungen hilft. Er enthält einen Standardsatz von allgemeinen Aktionen:
- Installieren Sie Software mithilfe des WinGet-Paket-Managers.
- Bereitstellen der Desired State Configuration (DSC) mithilfe der WinGet-Konfiguration.
- Klonen Sie ein Repository mithilfe von
git-clone. - Konfigurieren von Anwendungen, etwa Installation von Visual Studio-Erweiterungen.
- Ausführen von PowerShell-Skripts.
Erstellen von Aufgaben in einem Katalog
Aufgaben, z. B. die Installation von Software oder das Ausführen von Skripts, sind in einem Katalog organisiert. Sie erstellen und verwalten Aufgaben in einem Katalog, definieren neue Aufgaben und fügen Ihren Katalog an eine Dev Center-Instanz an. Mit dem Schnellstartkatalog von Microsoft können Sie mit allgemeinen Aufgaben wie der Installation von Software, der Bereitstellung von DSC, dem Klonen von Repositorien und der Konfiguration von Anwendungen beginnen.
Definieren neuer Aufgaben
Führen Sie die folgenden Schritte aus, um Aufgaben für Dev Box-Teamanpassungen zu erstellen und zu verwalten:
Erstellen Sie ein Repository zum Speichern Ihrer Tasks. Optional können Sie eine Kopie des Schnellstartkatalogs in Ihrem eigenen Repository erstellen, um sie als Ausgangspunkt zu verwenden.
Erstellen Sie Aufgaben in Ihrem Repository, indem Sie vorhandene PowerShell-Skripts ändern oder neue Skripts erstellen. Um mit dem Erstellen von Aufgaben zu beginnen, können Sie die Beispiele im GitHub-Repository für Dev Center-Beispiele und in der PowerShell-Dokumentation verwenden.
Fügen Sie Ihr Repository als Katalog an Ihr Dev Center an.
Erstellen Sie eine Konfigurationsdatei für diese Tasks, indem Sie die Schritte unter Schreiben einer Anpassungsdatei ausführen.
Verlinken von Geheimnissen aus einem Azure Key Vault
Sie können Geheimnisse aus Ihrem Azure Key Vault in Ihren YAML-Konfigurationen verwenden, um private Repositorien zu klonen, oder mit jeder benutzerdefinierten Aufgabe, die Sie verfassen und die ein Zugriffstoken erfordert.
Dev Center benötigt Zugriff auf Ihren Schlüsseltresor. DevCenter unterstützt keine Diensttags, wenn Ihr Schlüsseltresor privat ist, müssen Sie vertrauenswürdigen Microsoft-Diensten also erlauben, die Firewall zu umgehen.
So konfigurieren Sie Ihre Key Vault-Geheimnisse für die Verwendung in Ihren YAML-Konfigurationen:
Stellen Sie sicher, dass die verwaltete Identität Ihres Dev Center-Projekts die Rollen „Leseberechtigter für Schlüsseltresore“ und „Geheimnisbenutzer für Schlüsseltresore“ für Ihren Schlüsseltresor besitzt.
Gewähren Sie die Rolle „Geheimnisbenutzer für Schlüsseltresore“ für das Schlüsseltresorgeheimnis jeder benutzenden Person oder Benutzergruppe, die in der Lage sein soll, das Geheimnis während der Anpassung einer Dev-Box zu verwenden. Zu den benutzenden Personen oder Gruppen, denen die Rolle zugewiesen wird, müssen die verwaltete Identität für das Dev Center, Ihr eigenes Benutzerkonto und alle benutzenden Personen oder Gruppen gehören, die das Geheimnis während der Anpassung einer Dev-Box benötigen.
Weitere Informationen zur Verwendung von Schlüsseltresorgeheimnissen in einer Anpassungsdatei finden Sie unter Klonen eines privaten Repositorys mithilfe einer Anpassungsdatei.
Anfügen eines Katalogs
Sie können einen Katalog an ein Projekt angefügt, um Aufgaben für das Entwicklerteam zugänglich zu machen. Führen Sie zum Anfügen eines Katalogs an ein Projekt die Schritte: Hinzufügen und Konfigurieren eines Katalogs aus GitHub oder Azure Repos aus.