Een afbeeldingsdefinitiebestand schrijven voor dev Box-teamaanpassingen

2025-05-30

Met de microsoft Dev Box-aanpassingsfunctie kunt u de installatie van cloudomgevingen stroomlijnen. Ontwikkelaars aan de slag laten gaan met een nieuw project of met een nieuw team zijn vaak complex en tijdrovend. Met aanpassingen kunt u kant-en-klare werkstations configureren met toepassingen, hulpprogramma's, opslagplaatsen, codebibliotheken, pakketten en buildscripts. In dit artikel wordt u begeleid bij het maken, testen en bewerken van een afbeeldingsdefinitiebestand voor uw ontwikkelvak met behulp van Visual Studio Code.

Er zijn twee manieren om aanpassingen te gebruiken in Dev Box. Teamaanpassingen maken een gedeelde configuratie voor een team van ontwikkelaars. Gebruikersaanpassingen maken een persoonlijke configuratie voor een afzonderlijke ontwikkelaar. De volgende tabel bevat een overzicht van de verschillen tussen de twee typen aanpassingen.

Eigenschap	Teamaanpassingen	Gebruikersaanpassingen
Configureren op locatie	Dev Box-pool	Dev-box
Aanpassingen zijn van toepassing op	Alle ontwikkelboxen in de pool	Afzonderlijke ontwikkelingsbox
Eenvoudig deelbaar	Ja	Nee.
Aanpassingen bestandsnaam	`Imagedefinition.yaml`	`myfilename.yaml` of `Workload.yaml`
Afkomstig van	Catalogus	Geüpload of vanuit persoonlijke opslagplaats
Ondersteunt geheimen van de sleutelkluis	Ja	Ja

Vereiste voorwaarden

Laat een ontwikkelaarscentrum configureren met een dev box-pool en een dev box-project , zodat u een dev box kunt creëren.
Wees lid van de beveiligingsgroep Dev Box Users voor ten minste één project.
U hebt een catalogus gekoppeld aan het ontwikkelaarscentrum met taken die u kunt gebruiken in uw afbeeldingsdefinitiebestand. Als u geen catalogus hebt, zie Een catalogus toevoegen en configureren vanuit GitHub of Azure Repos.

Vereiste machtigingen voor het configureren van aanpassingen

Handeling	Machtiging/rol
Schakel catalogi op projectniveau in voor een ontwikkelaarscentrum.	Platform-engineer met schrijftoegang tot het abonnement.
Synchronisatie-instellingen voor catalogus inschakelen voor een project.	Platform-engineer met schrijftoegang tot het abonnement.
Voeg een catalogus toe aan een project.	Toegang als projectbeheerder of medewerker in het ontwikkelaarscentrum voor het project.
Maak een afbeeldingsdefinitiebestand.	Niets opgegeven. Iedereen kan een afbeeldingsdefinitiebestand maken.
Taken toevoegen aan een catalogus.	Machtiging om toe te voegen aan de opslagplaats die als host fungeert voor de catalogus.

Een bron kiezen voor aanpassingstaken

U kunt Dev Box-taken afkomstig laten zijn van taken die zijn opgebouwd in het platform, of aangepaste taken gebruiken die zijn opgeslagen in een catalogus. Kies de bron die het beste aansluit bij uw aanpassingsbehoeften en projectvereisten.

Ingebouwde WinGet- en PowerShell-taken gebruiken. Dev Box-ontwikkelcentra ondersteunen PowerShell- en WinGet-taken direct. U kunt aan de slag met deze ingebouwde taken. Als uw aanpassingen alleen PowerShell en WinGet vereisen, gaat u verder met het maken van uw aanpassingsbestand. Zie Een afbeeldingsdefinitiebestand maken voor meer informatie.

De ingebouwde WinGet-taak is niet het uitvoerbare WinGet-bestand. De ingebouwde WinGet-taak is gebaseerd op de PowerShell WinGet-cmdlet.
Gebruik een catalogus om aangepaste taken te definiëren. U kunt uw eigen aangepaste taken maken. Als u aangepaste taken beschikbaar wilt maken voor uw hele organisatie, voegt u een catalogus met aangepaste taakdefinities toe aan uw ontwikkelaarscentrum. Dev Box ondersteunt Azure-opslagplaatsen en GitHub-catalogi. Omdat taken alleen in het ontwikkelaarscentrum zijn gedefinieerd, moet u taken en immagedefinities opslaan in afzonderlijke opslagplaatsen.

Voor meer informatie over hoe u aangepaste taken kunt definiëren, zie taken maken voor Dev Box-teamaanpassingen.

Afbeeldingsdefinities maken op projectniveau

Met projecten kunt u Dev Box-resources efficiënt beheren. Door elk ontwikkelaarsteam een eigen project toe te wijzen, kunt u resources effectief organiseren. U kunt meerdere afbeeldingsdefinities maken in uw catalogusrepository, elk in hun eigen map om verschillende ontwikkelaarsteams binnen uw project te ondersteunen.

Machtigingen toewijzen voor projectbeheerders

Als u een catalogus aan een project wilt koppelen, moet u de machtiging Projectbeheerder of Inzender voor het project hebben. Zie Beheertoegang verlenen aan Dev Box-projecten voor meer informatie over het toewijzen van machtigingen voor projectbeheerders.

Catalogi op projectniveau inschakelen

U moet catalogi op projectniveau inschakelen op het niveau van het ontwikkelaarscentrum voordat u een catalogus aan een project kunt toevoegen. Het gebruik van catalogi op projectniveau op het niveau van het ontwikkelaarscentrum inschakelen:

Ga in Azure Portal naar uw ontwikkelaarscentrum.
Selecteer in het linkermenu onder Instellingen de instellingen van het Ontwikkelaarscentrum.
Selecteer onder Catalogussen op projectniveau de optie Catalogi inschakelen per project en selecteer vervolgens Toepassen.

Zie Een catalogus toevoegen en configureren vanuit GitHub of Azure-opslagplaatsen voor meer informatie over het toevoegen van catalogi aan projecten.

Een afbeeldingsdefinitiebestand maken

U kunt afbeeldingsdefinitiebestanden maken en testen met behulp van Visual Studio Code. Naast het gebruik van de ingebouwde taken, kunt u de Dev Box-extensie in Visual Studio Code gebruiken om de aangepaste taken te detecteren die beschikbaar zijn via uw ontwikkelaarscentrum.

Maak een ontwikkelvak (of gebruik een bestaand ontwikkelvak) om te testen.
Installeer Visual Studio Code in het test dev-vak en installeer vervolgens de Dev Box-extensie.
Download een voorbeeld van een YAML-afbeeldingsdefinitiebestand uit de opslagplaats met voorbeelden. Open deze in Visual Studio Code.
Ontdek de taken die beschikbaar zijn in de catalogus met behulp van het opdrachtenpalet. Selecteer Weergeven>Opdrachtpalet>Dev Box: Lijst beschikbare taken voor deze Dev Box.
Test de aanpassing in Visual Studio Code met behulp van het opdrachtenpalet. Selecteer Weergeven>Opdrachtpalet>Dev Box: Aanpassingstaken Toepassen.
Het image-definitiebestand wordt uitgevoerd en past de opgegeven taken toe op uw testontwikkelingsomgeving. Inspecteer de wijzigingen en controleer de Visual Studio Code-terminal op eventuele fouten of waarschuwingen die tijdens de taakuitvoering zijn gegenereerd.
Wanneer het afbeeldingsdefinitiebestand wordt uitgevoerd, uploadt u het naar uw catalogus.

Systeemtaken en gebruikerstaken

U kunt zowel systeem- als gebruikerstaken gebruiken in uw afbeeldingsdefinitiebestand. De takensectie van het afbeeldingsdefinitiebestand is onderverdeeld in de volgende secties. Beide secties delen dezelfde parameters op basis van de taakdefinities in uw catalogus.

Systeemtaken: Deze taken worden uitgevoerd als LocalSystem tijdens de inrichtingsfase van de ontwikkelomgeving. Ze worden meestal gebruikt voor configuraties op systeemniveau, zoals het installeren van software of het configureren van systeeminstellingen waarvoor beheerdersbevoegdheden zijn vereist.
Gebruikerstaken: Deze taken worden uitgevoerd nadat de gebruiker zich voor het eerst heeft aangemeld bij de ontwikkelomgeving. Ze worden meestal gebruikt voor configuraties op gebruikersniveau, zoals het installeren van gebruikersspecifieke toepassingen of het configureren van gebruikersinstellingen onder gebruikerscontext. Gebruikers geven bijvoorbeeld de voorkeur aan python en Visual Studio Code onder gebruikerscontext in plaats van systeemomvattend te installeren. Plaats WinGet-taken in de userTasks sectie voor betere resultaten wanneer ze niet onder taken werken.

Standaardgebruikers die gebruikersaanpassingen configureren, kunnen alleen gebruikerstaken gebruiken. Ze kunnen geen systeemtaken gebruiken.

Optioneel: Uw ontwikkelvak aanpassen met behulp van bestaande Desired State Configuration-bestanden

Desired State Configuration (DSC) is een beheerplatform in PowerShell waarmee u uw ontwikkelomgeving met configuratie als code kunt beheren. U kunt DSC gebruiken om de gewenste status van uw ontwikkelvak te definiëren, waaronder software-installaties, configuraties en instellingen.

U kunt ook DSC-configuratiebestanden gebruiken om een ontwikkelvak in te stellen met behulp van een ingebouwde WinGet-taak.

In het volgende voorbeeld ziet u een definitiebestand voor dev box image dat een bestaand WinGet DSC-bestand aanroept:

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

Zie De WinGet-configuratie voor meer informatie.

Synchronisatie-instellingen voor catalogus configureren voor het project

Configureer uw project om afbeeldingsdefinities uit de catalogus te synchroniseren. Met deze instelling kunt u de afbeeldingsdefinities in de catalogus gebruiken om ontwikkelboxgroepen te maken.

Meld u aan bij het Azure-portaal.
Voer projecten in het zoekvak in. Selecteer Projecten in de lijst met resultaten.
Open het Dev Box-project waarvoor u instellingen voor catalogussynchronisatie wilt configureren.
Selecteer Catalogi.
Selecteer Synchronisatie-instellingen.
Selecteer afbeeldingsdefinities in het deelvenster Synchronisatie-instellingen en selecteer Vervolgens Opslaan.

Een catalogus bijvoegen die het definitiebestand bevat

Voordat u een aanpassingsbestand als afbeeldingsdefinitie kunt gebruiken, moet u een catalogus met het definitiebestand toevoegen aan uw ontwikkelaarscentrum of project. De catalogus kan afkomstig zijn van GitHub of Azure-opslagplaatsen.

Het deelvenster Afbeeldingsdefinities bevat de afbeeldingsdefinities waartoe uw project toegang heeft.

Zie Een catalogus toevoegen en configureren vanuit GitHub of Azure-opslagplaatsen voor meer informatie over het koppelen van catalogi.

Een dev box-pool configureren om een afbeeldingsdefinitie te gebruiken

Maak aanpassingen beschikbaar voor uw ontwikkelteams door een dev box-pool te configureren voor het gebruik van een aanpassingsbestand (imagedefinition.yaml). Sla het aanpassingsbestand op in een opslagplaats die is gekoppeld aan een catalogus in uw ontwikkelaarscentrum of project. Geef dit bestand op als de afbeeldingsdefinitie voor de pool en de aanpassingen worden toegepast op nieuwe ontwikkeldozen.

In de volgende stappen ziet u hoe u een devboxpool maakt en een image-definitie opgeeft.

Meld u aan bij het Azure-portaal.
Voer projecten in het zoekvak in. Selecteer Projecten in de lijst met resultaten.
Open het Dev Box-project waaraan u de nieuwe dev box-pool wilt koppelen.
Selecteer Dev box pools, en selecteer vervolgens Maken.

Voer op het paneel Ontwikkelboxpool maken de volgende waarden in:

Configuratie	Waarde
Naam	Voer een naam in voor de pool. De naam van de pool is zichtbaar voor ontwikkelaars om te selecteren wanneer ze ontwikkelvakken maken. Deze moet uniek zijn binnen een project.
Definitie	In dit vak worden afbeeldingsdefinities van toegankelijke catalogi en dev box-definities weergegeven. Selecteer een afbeeldingsdefinitiebestand.
Netwerkverbinding	Selecteer Implementeren in een gehost Microsoft-netwerk of gebruik een bestaande netwerkverbinding.
Eenmalige aanmelding inschakelen	Selecteer Ja als u eenmalige aanmelding wilt inschakelen voor de ontwikkelvakken in deze pool. Single sign-on moet worden geconfigureerd voor de organisatie. Zie Eenmalige aanmelding inschakelen voor dev boxes voor meer informatie.
Dev box Creator-bevoegdheden	Selecteer Lokale beheerder of Standaardgebruiker.
Automatisch stoppen inschakelen	Ja is de standaardwaarde. Selecteer Nee om een schema voor automatisch stoppen uit te schakelen. U kunt een automatische stopplanning instellen nadat de pool is aangemaakt.
Stoptijd	Kies een tijdstip om alle ontwikkelomgevingen van de pool uit te schakelen.
Tijdzone	Selecteer de tijdzone waarin de stoptijd zich bevindt.
Licenties	Schakel dit selectievakje in om te bevestigen dat uw organisatie Azure Hybrid Benefit-licenties heeft die u wilt toepassen op de dev-vakken in deze pool.

Klik op Creëren.
Controleer of de nieuwe dev box-pool wordt weergegeven in de lijst. Mogelijk moet u het scherm vernieuwen.

Maak een ontwikkelaarsomgeving met behulp van de ontwikkelaarsportaal

Als u wilt controleren of aanpassingen van het afbeeldingsdefinitiebestand worden toegepast, maakt u een ontwikkelaarsvak in de Ontwikkelaarsportal van Dev Box. Volg de stappen in Quickstart: Een Dev Box maken en er verbinding mee maken met behulp van de Ontwikkelaarsportal van Dev Box. Maak vervolgens verbinding met het zojuist gemaakte ontwikkelvak en controleer of de aanpassingen naar verwachting werken.

U kunt wijzigingen aanbrengen in het aanpassingsbestand en een nieuw ontwikkelvak maken om de wijzigingen te testen. Wanneer u zeker weet dat de aanpassingen juist zijn, kunt u een herbruikbare image maken.

Volgende stap

Nu u een afbeeldingsdefinitiebestand hebt, uploadt u het naar een catalogus en voegt u de catalogus toe aan een project. Het afbeeldingsdefinitiebestand wordt gebruikt om ontwikkelvakken voor uw ontwikkelteams te configureren en te maken.

Imaging configureren voor Dev Box-teamaanpassingen