Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Gebruik de microsoft Dev Box-aanpassingsfunctie om het instellen van ontwikkelomgevingen in de cloud te stroomlijnen. Het starten van een nieuw project of het deelnemen aan een nieuw team kan complex en tijdrovend zijn. Teamaanpassingen maken gebruik van een afbeeldingsdefinitiebestand (imagedefinition.yaml) om hulpprogramma's vooraf te installeren, opslagplaatsen te klonen en instellingen in te stellen voor elk ontwikkelvak in een pool. Met teamaanpassingen kunnen beheerders kant-en-klare werkstations voorzien van apps, hulpprogramma's, opslagplaatsen, codebibliotheken, pakketten en buildscripts. In dit artikel leest u hoe u een afbeeldingsdefinitiebestand voor uw ontwikkelvak in Visual Studio Code maakt, test en bewerkt.
U kunt aanpassingen in Dev Box op twee manieren gebruiken. Teamaanpassingen maken een gedeelde configuratie voor een team. Gebruikersaanpassingen maken een persoonlijke configuratie voor een afzonderlijke ontwikkelaar. De volgende lijst bevat een overzicht van de verschillen tussen deze aanpassingstypen.
- Teamaanpassingen: eenmaal gedefinieerd, toegepast op elk ontwikkelvak in een pool via imagedefinition.yaml in een catalogus.
- Aanpassingen van gebruikers: Persoonlijke YAML geüpload tijdens het maken van een vak; is slechts van invloed op dat ene vak.
- Team gebruiken voor consistentie en naleving; gebruiker gebruiken voor persoonlijke voorkeuren.
Zie Microsoft Dev Box-aanpassingen voor meer informatie.
Configureer teamaanpassingen door de volgende stappen uit te voeren:
Vereiste voorwaarden
| Product | Requirements |
|---|---|
| Microsoft Dev Box | - Stel een ontwikkelaarscentrum in met een dev box-pool en een dev box-project , zodat u een ontwikkelvak kunt maken.
- Voeg een catalogus toe 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. -Machtigingen - Ga als volgende te werk om een ontwikkelaarsvak te maken: Neem deel aan de beveiligingsgroep Dev Box Users voor ten minste één project. - Catalogi op projectniveau inschakelen voor een ontwikkelaarscentrum: Platformengineer met schrijftoegang voor het abonnement. - Catalogussynchronisatie-instellingen voor een project inschakelen: Platformengineer met schrijftoegang voor het abonnement. - Een catalogus toevoegen aan een project: Machtigingen voor ontwikkelaarscentrumprojectbeheerder of inzender voor het project. |
| Visual Studio Code | - Installeer de nieuwste versie |
Een afbeeldingsdefinitiebestand maken
Als u de hulpprogramma's, pakketten en configuraties wilt definiëren die uw team nodig heeft, maakt u een afbeeldingsdefinitiebestand in YAML-indeling met de vereiste taken voor uw ontwikkelvakomgeving.
Ingebouwde taken of een catalogus gebruiken voor aangepaste taken
Taken zijn herbruikbare acties die afkomstig zijn van ingebouwde primitieven (WinGet, PowerShell en Git-Clone) of uit een catalogus die u aan uw ontwikkelaarscentrumproject koppelt. Kies de bron die het beste past bij uw aanpassingsbehoeften en projectvereisten.
Gebruik WinGet, PowerShell en Git-Clone ingebouwde taken. Dev Box-ontwikkelcentra ondersteunen PowerShell- en WinGet-taken direct. Als voor uw aanpassingen alleen PowerShell, WinGet of Git-Clone is vereist, kunt u aan de slag met deze ingebouwde taken en het definitiebestand voor de installatiekopie maken. Zie Een afbeeldingsdefinitiebestand maken voor meer informatie.
Belangrijk
De ingebouwde WinGet-taak is niet hetzelfde als het uitvoerbare WinGet-bestand. De ingebouwde WinGet-taak is gebaseerd op de PowerShell WinGet-cmdlet.
Gebruik een catalogus om aangepaste taken te definiëren. Maak uw eigen aangepaste taken. 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.
Zie Taken configureren voor Dev Box-aanpassingen voor meer informatie over het definiëren van aangepaste taken.
Dev Box ondersteunt een agentische werkstroom met de GitHub Copilot-agentmodus. Gebruik prompts in natuurlijke taal om het definitiebestand voor de installatiekopie (imagedefinition.yaml) te genereren. GitHub Copilot maakt het eenvoudiger om uw Dev Box-omgeving in te stellen, omdat u uw behoeften gespreksmatig beschrijft in plaats van handmatig YAML-bestanden te maken.
Met de dev Box-agentische werkstroom kunt u het volgende doen:
- Uw huidige ontwikkelomgeving nabootsen : genereer of wijzig een definitie die overeenkomt met de configuratie van uw huidige computer.
- Gebruik de context van de opslagplaats : maak of wijzig een definitie in de context van een specifieke GitHub-opslagplaats.
- Gebruik instructies voor natuurlijke taal : een afbeeldingsdefinitiebestand genereren door de gewenste ontwikkelomgeving te beschrijven.
Opmerking
De agentische werkstroom ondersteunt alleen primitieve Dev Box-taken, waaronder WinGet, PowerShell en Git-Clone.
Het afbeeldingsdefinitiebestand genereren
Open Visual Studio Code.
Installeer de Dev Box-extensie.
Open Extensies (Ctrl+Shift+X), zoek naar Dev Box en installeer de extensie.
Installeer de GitHub Copilot-extensie die is ingesteld in VS Code.
Zorg ervoor dat de agentmodus is ingeschakeld door chat.agent.enabled in te stellen in de editor Instellingen. Voor deze instelling is Visual Studio Code 1.99 of hoger vereist.
Open Copilot Chat in VS Code.
Zorg ervoor dat Dev Box-hulpprogramma's vooraf zijn geselecteerd onder Hulpprogramma's selecteren.
Selecteer agentmodus en kies het model: Claude 3.5 Sonnet.
Geef prompts in natuurlijke taal op, zoals:
"Ik wil een ontwikkelvak instellen met alle hulpprogramma's en pakketten die nodig zijn om aan deze [naam van opslagplaats] te werken."
"Ik wil Visual Studio 2022 Enterprise, Visual Studio Code, Git, .NET SDK 8, Node.js LTS en Docker Desktop vooraf installeren in een ontwikkelvak en de opslagplaats [URL] van het team laten klonen naar het ontwikkelvak."
"Ik wil een ontwikkelvak instellen met alle ontwikkelhulpprogramma's en pakketten die op mijn huidige computer zijn geïnstalleerd."
Aanbeveling
Kloon en open de specifieke opslagplaats in Visual Studio Code als u de definitie wilt genereren in de context van een opslagplaats.
Volg de aanwijzingen om pakketten te configureren.
Wanneer u hierom wordt gevraagd, selecteert u Doorgaan om door te gaan met de installatie van het pakket.
Copilot genereert het bestand imagedefinition.yaml .
Verfijn deze met meer prompts.
- Ga door met de agent totdat de hulpprogramma's en pakketten die u wilt weergeven in het bestand.
Het afbeeldingsdefinitiebestand uploaden naar een opslagplaats
U kunt een GitHub- of Azure-opslagplaats voor opslagplaatsen als catalogus gebruiken om uw afbeeldingsdefinitiebestand toegankelijk te maken vanuit een dev box-project. Elk project kan een catalogus hebben waarin meerdere afbeeldingsdefinitiebestanden worden opgeslagen, die u op pools kunt configureren om af te stemmen op de behoeften van uw ontwikkelaarsteams.
Wanneer u een afbeeldingsdefinitiebestand hebt dat u wilt gebruiken, uploadt u het naar een catalogus. In de volgende secties ziet u hoe u uw catalogus aan een project koppelt en uw installatiekopieëndefinitie beschikbaar maakt voor selectie bij het configureren van uw dev box-pools.
Afbeeldingsdefinities configureren op projectniveau
Met projecten kunt u Dev Box-resources efficiënt beheren. U kunt elk ontwikkelaarsteam een eigen project toewijzen om resources effectief te organiseren. Maak meerdere installatiekopieën in uw catalogusopslagplaats, elk in een eigen map om verschillende ontwikkelaarsteams onder uw project te richten.
Catalogi op projectniveau inschakelen
Schakel catalogi op projectniveau in op het niveau van het ontwikkelaarscentrum voordat u een catalogus aan een project toevoegt. Catalogi op projectniveau inschakelen op het niveau van het ontwikkelaarscentrum:
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.
Synchronisatie-instellingen voor catalogus configureren voor het project
Stel uw project in om definities van installatiekopieën uit de catalogus te synchroniseren. Met deze instelling kunt u de definities van installatiekopieën in de catalogus gebruiken om dev box-pools 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 waar u synchronisatie-instellingen voor catalogus wilt instellen.
Selecteer Catalogi.
Selecteer Synchronisatie-instellingen.
Selecteer afbeeldingsdefinities in het deelvenster Synchronisatie-instellingen en selecteer vervolgens Opslaan.
Voeg de catalogus met het definitiebestand van de installatiekopieën toe
Als u een afbeeldingsdefinitiebestand wilt gebruiken, voegt u de catalogus met het bestand toe aan uw project. Hierdoor is de definitie van de installatiekopieën beschikbaar voor selectie bij het configureren van uw dev box-pools.
In het deelvenster Afbeeldingsdefinities ziet u de afbeeldingsdefinities die uw project kan gebruiken.
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
Laat uw ontwikkelteam aanpassingen gebruiken door een dev box-pool in te stellen met een afbeeldingsdefinitiebestand. Sla het afbeeldingsdefinitiebestand op in een opslagplaats die is gekoppeld aan uw project als catalogus. Geef dit bestand op als de definitie van de installatiekopieën voor de pool en de aanpassingen zijn van toepassing op nieuwe dev-vakken.
Volg deze stappen om een dev box-pool te maken en een definitie van een installatiekopieën op te geven:
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 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 toestaan voor de ontwikkelvakken in deze pool. Eenmalige aanmelding moet worden ingesteld 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 het schema voor automatisch stoppen uit te schakelen. U kunt een schema voor automatisch stoppen instellen nadat de pool is gemaakt. Stoptijd Selecteer een tijd om alle dev-vakken in de pool te stoppen. Tijdzone Selecteer de tijdzone voor de stoptijd. Licenties Schakel dit selectievakje in om te bevestigen dat uw organisatie Azure Hybrid Benefit-licenties heeft om van toepassing te zijn op de ontwikkelvakken in deze pool. 
Klik op Creëren.
Controleer of de nieuwe ontwikkelvakgroep wordt weergegeven in de lijst. Mogelijk moet u het scherm vernieuwen.
Een ontwikkelaarsvak maken met behulp van de ontwikkelaarsportal
Als u wilt controleren of aanpassingen van het definitiebestand van de installatiekopieën zijn 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 nieuwe ontwikkelvak en controleer of de aanpassingen naar verwachting werken.
Breng wijzigingen aan in het definitiebestand van de installatiekopieën en maak een nieuw ontwikkelvak om ze te testen. Wanneer u zeker weet dat de aanpassingen juist zijn, maakt u een herbruikbare installatiekopieën.
Modulaire scripts en bestanden gebruiken in Dev Box-aanpassingen
Modulaire scripts en bestanden zoals PowerShell-scripts, DSC-bestanden (Desired State Configuration), configuratiebestanden, tekstbestanden of afbeeldingen kunnen worden opgeslagen in een gedeelde catalogus, zodat u Dev Box-aanpassingen voor meerdere installatiekopieën opnieuw kunt gebruiken en standaardiseren.
Ze zijn ontworpen om:
- Hergebruik verhogen in meerdere Dev Box-instellingen
- Duplicatie en onderhoudsoverhead verminderen
- Consistente configuratieprocedures inschakelen
Catalogusstructuur
Bestanden in dezelfde map als de imagedefinition.yaml, of in de submappen, worden naar de ontwikkelbox gekopieerd bij het aanmaken. U kunt deze bestanden gebruiken wanneer u aanpassingstaken uitvoert.
In het volgende diagram ziet u een catalogusstructuur voor modulaire scripts en bestanden in Dev Box-aanpassingen.
Op het hoogste niveau bevindt zich een map met afbeeldingsdefinities . Binnen vindt u submappen voor afbeeldingsdefinities, zoals front-end-imagedef en backend-imagedef. De map front-end-imagedef heeft een PowerShell-scriptbestand. De map backend-imagedef bevat een submap die DSC-bestanden bevat. U kunt een van beide structuren gebruiken om scripts en andere bestanden op te slaan.
Refereren aan modulaire scripts of bestanden
Afbeeldingsdefinitiebestand stelt een lijst met taken in die worden uitgevoerd in de systeemcontext en userTasks die worden uitgevoerd na de eerste aanmelding in het nieuwe ontwikkelvak, in de gebruikerscontext. Gebruik weergavenamen voor taken om het doel van elke taak te verduidelijken. In uw afbeeldingsdefinitiebestand verwijst u naar de modulaire scripts die u wilt uitvoeren of de bestanden die u wilt opnemen.
$schema: "1.0"
name: "modular-script"
image: microsoftvisualstudio_visualstudioplustools_vs-2022-ent-general-win11-m365-gen2
description: "This definition shows examples of referencing PowerShell scripts and DSC configuration files."
tasks:
- name: ~/powershell
displayName: "Modular Script"
parameters:
script: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso.ps1
- name: ~/winget
displayName: "Install VS Code"
parameters:
configurationFile: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso.dsc.yaml
userTasks:
- name: ~/winget
displayName: "Install Insomnia"
parameters:
configurationFile: C:\ProgramData\Microsoft\DevBoxAgent\ImageDefinitions\catalog-name\modular-script\contoso-user.dsc.yaml
Dev Box valideert dat alle taken verwijzen naar intrinsieke taken (zoals PowerShell of WinGet) of naar een taak die beschikbaar is op het niveau van het devcenter. Alle installatiekopieëndefinitiebestanden worden gedownload naar een vaste map in de nieuwe ontwikkelomgeving, samen met de relevante taakbestanden. Vervolgens wordt elke taak uitgevoerd in de gedownloade taakmap en wordt de taakstatus geüpload na voltooiing.
Volgende stap
Nu u een image-definitiebestand hebt dat dev boxes configureert en maakt voor uw ontwikkelteam, leert u hoe u de aanmaaktijd van dev boxes kunt optimaliseren met imaging via het dev center.