Erstellen einer freigegebenen Anpassung
Die Verwendung einer Anpassungsdatei vereinfacht die Erstellung von Dev-Boxen für Ihr Team. Mit Anpassungen von Dev-Boxen können Sie eine gemeinsame Teamanpassung erstellen, indem Sie eine Anpassungsdatei namens Imagedefinition erstellen. Das Erstellen eines wiederverwendbaren Images aus dieser Imagedefinition optimiert Anpassungen und spart Zeit beim Erstellen von Dev-Boxen. In diesem Artikel erfahren Sie, wie Sie einen Pool für die Verwendung einer Imagedefinition konfigurieren und wiederverwendbare Images für Ihre Entwicklungsteams erstellen.
Um die Imageerstellung für Dev Box-Teamanpassungen zu konfigurieren, aktivieren Sie Kataloge auf Projektebene, und konfigurieren Sie Katalogsynchronisierungseinstellungen für das Projekt. Fügen Sie dann einen Katalog mit einer Definitionsdatei an Ihr Projekt an, konfigurieren Sie einen Dev-Box-Pool für die Verwendung einer Imagedefinition, und stellen Sie sicher, dass die Anpassungen auf eine neue Dev-Box angewendet werden. Wenn die Anpassungen ordnungsgemäß angewendet werden, können Sie ein wiederverwendbares Image erstellen. Dadurch wird die Erstellung neuer Dev-Boxen beschleunigt.
Wichtig
Dev Box-Teamanpassungen befinden sich derzeit in der Vorschauphase. 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
Um die Schritte dieses Artikels abzuschließen, benötigen Sie Folgendes:
- Dev Center mit einer vorhandenen Dev-Box-Definition und Netzwerkverbindung. Wenn Sie keine Dev Center-Instanz besitzen, führen Sie die Schritte unter Schnellstart: Konfigurieren von Microsoft Dev Box aus, um eine zu erstellen.
- Eine Teamanpassungsdatei, die Sie zum Erstellen einer Dev-Box verwenden möchten. Wenn Sie keine Anpassungsdatei haben, lesen Sie die Informationen unter Schreiben einer Anpassungsdatei.
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 bestimmte Berechtigungen. In der folgenden Tabelle werden die Aktionen und Berechtigungen oder Rollen beschrieben, die Sie zum Konfigurieren von Anpassungen benötigen.
| Aktion | Berechtigung/Rolle |
|---|---|
| Aktivieren von Katalogen auf Projektebene für eine Dev Center-Instanz | 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 | 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 Tasks zu einem Katalog | Berechtigung zum Hinzufügen zum Repository, das den Katalog hostet |
Zum Verwalten eines Dev-Box-Pools benötigen Sie die folgenden Berechtigungen:
| Aktion | Erforderliche Berechtigungen |
|---|---|
| Erstellen, Löschen oder Aktualisieren eines Dev-Box-Pools | - Berechtigungen als „Besitzer“ oder „Mitwirkender“ für ein Azure-Abonnement oder eine bestimmte Ressourcengruppe. - Berechtigungen als DevCenter-Projektadministrator für das Projekt. |
Aktivieren von Katalogen auf Projektebene
Aktivieren Sie Kataloge auf Projektebene. Mit dieser Einstellung können Sie einen Katalog an ein Projekt anfügen.
Weitere Informationen zu Katalogen auf Projektebene finden Sie unter Aktivieren von Katalogen auf Projektebene.
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.
Melden Sie sich beim Azure-Portal an.
Geben Sie im Suchfeld Projekte ein. Wählen Sie in der Ergebnisliste Projekte aus.
Öffnen Sie das Dev Box-Projekt, für das Sie Katalogsynchronisierungseinstellungen konfigurieren möchten.
Wählen Sie Kataloge aus.
Wählen Sie Synchronisierungseinstellungen aus.
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.
Auf der Seite „Imagedefinition“ werden die für Ihr Projekt zugänglichen Imagedefinitionen angezeigt.
Weitere Informationen zum Anfügen von Katalogen finden Sie unter Hinzufügen und Konfigurieren eines Katalogs aus GitHub oder Azure Repos.
Konfigurieren eines Dev-Box-Pools für die Verwendung einer Imagedefinition
Stellen Sie Anpassungen für Ihre Entwicklungsteams zur Verfügung, indem Sie einen Dev-Box-Pool für die Verwendung einer Anpassungsdatei konfigurieren (imagedefinition.yaml). Speichern Sie die Anpassungsdatei in einem Repository, das mit einem Katalog in Ihrer Dev Center-Instanz oder Ihrem 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.
Melden Sie sich beim Azure-Portal an.
Geben Sie im Suchfeld Projekte ein. Wählen Sie in der Ergebnisliste Projekte aus.
Öffnen Sie das Dev-Box-Projekt, dem der neue Dev-Box-Pool zugeordnet werden soll.
Wählen Sie Dev-Box-Pools und dann Erstellen aus.
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. Er muss innerhalb eines Projekts eindeutig sein. Definition 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-Boxes. 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. 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. 
Klicken Sie auf Erstellen.
Ü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 Imagedefinitionsdatei angewendet werden, erstellen Sie eine Dev-Box im Microsoft Dev Box-Entwicklerportal.
Melden Sie sich beim Microsoft Dev Box-Entwicklerportal an.
Wenn die Dev-Box erstellt wird, werden die Anpassungen aus der Imagedefinitionsdatei auf die Dev-Box angewendet. Sie können nun eine Verbindung mit der 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 zufrieden und die Anpassungen korrekt sind, können Sie ein wiederverwendbares Image erstellen.
Auswählen der Erstellung eines wiederverwendbaren Images
Um Anpassungen zu optimieren und ein wiederverwendbares Image für Ihr Team zu erstellen, erstellen Sie ein Image aus der Anpassungsdatei. Dieses Image gilt für alle Dev-Boxen, die aus dem Pool erstellt werden.
Führen Sie die folgenden Schritte aus, um ein Image aus einer Anpassungsdatei zu erstellen:
Wählen Sie auf der Seite „Imagedefinition“ das Image aus, das Sie erstellen möchten.
Wählen Sie Build aus.
Nachverfolgen des Status
Wichtig
Wenn Sie die Imagedefinition in ein Image optimieren, wird eine Dev-Box erstellt, um die Anpassungsdatei auszuführen und ein Image zu generieren. Während dieses Prozesses ist diese Dev Box-Instanz mit einem virtuellen Netzwerk verbunden, das von Microsoft verwaltet wird, und bei Aufgaben, die Zugriff auf lokale Ressourcen erfordern, kann ein Fehler auftreten.
Wenn die Erstellung erfolgreich abgeschlossen wurde, verwendet der Dev-Box-Pool automatisch das Image für neue Dev-Boxen. Sie müssen keine zusätzlichen Konfigurationsschritte ausführen, um das Image dem Pool zuzuweisen. Sie können jetzt Dev-Boxen aus dem Pool erstellen, und die Anpassungen werden auf jede Dev-Box angewendet.