Quickstart: Een ontwikkelvak maken met behulp van teamaanpassingen

In deze snelstartgids maakt u een ontwikkelbox met behulp van Microsoft Dev Box-teamaanpassingen. De functie maakt gebruik van een afbeeldingsdefinitiebestand, zodat u consistent aangepaste ontwikkelvakken voor uw ontwikkelteam kunt maken en een op maat gemaakte omgeving voor uw projecten kunt bieden.

Vereisten

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, raadpleegt u Een catalogus toevoegen en configureren vanuit GitHub of Azure-opslagplaatsen. -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. - Een aanpassingsbestand maken: Geen opgegeven. Iedereen kan een aanpassingsbestand maken. - Als u de ontwikkelaarsportal wilt gebruiken om een YAML-bestand te uploaden en toe te passen tijdens het maken van een dev box: Dev Box-gebruiker. - Taken toevoegen aan een catalogus: Machtiging om toe te voegen aan de opslagplaats die als host fungeert voor de catalogus.
Visual Studio Code	- Installeer de nieuwste versie

Maak een afbeeldingsdefinitie

Als u een ontwikkelvak met aanpassingen wilt maken, moet u een afbeeldingsdefinitiebestand maken. Het definitiebestand van de installatiekopieën is een YAML-bestand dat de aanpassingen bevat die u wilt toepassen op het ontwikkelvak. U kunt het voorbeeldbestand voor afbeeldingsdefinities in deze quickstart als uitgangspunt gebruiken.

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.

1. Ga in Azure Portal naar uw ontwikkelaarscentrum.

2. Selecteer in het servicemenu onder Instellingen de instellingen van het Ontwikkelaarscentrum.

3. Selecteer onder Catalogussen op projectniveau de optie Catalogi inschakelen per project en selecteer vervolgens Toepassen.

   

Een catalogus toevoegen aan uw project

In de volgende secties wordt u begeleid bij het doorlopen van deze taken:

1. Maak een fork van de voorbeeldcatalogusopslagplaats naar uw GitHub-organisatie.
2. Configureer synchronisatie-instellingen om de catalogus te synchroniseren met uw project.
3. Voeg uw opslagplaats toe als catalogus.

De voorbeeldcatalogusopslagplaats splitsen

1. Open de voorbeeldcatalogusopslagplaats.

2. Selecteer Fork>Create a new fork to fork the repository to fork to your GitHub organization.

   

Synchronisatie-instellingen voor catalogus configureren

1. Ga terug naar Azure Portal.

2. Voer projecten in het zoekvak in. Selecteer Projecten in de lijst met resultaten.

3. Selecteer het project waaraan u de catalogus wilt toevoegen.

4. Selecteer Instellingencatalogus>in het linkermenu.

5. Selecteer Synchronisatie-instellingen.

   

6. In het deelvenster Synchronisatie-instellingen :

   • Als afbeeldingsdefinities zijn gewist, selecteert u deze en selecteert u Opslaan.
   • Als afbeeldingsdefinities al zijn geselecteerd, selecteert u Annuleren.

   

Uw opslagplaats toevoegen als catalogus

1. Selecteer Toevoegen op de pagina Catalogi.

2. Voer in het deelvenster Catalogus toevoegen de volgende waarden in of selecteer deze:

   Veld	Waarde
   Naam	Voer een Naam in voor de catalogus.
   Catalogusbron	Selecteer GitHub.
   Verificatietype	Selecteer de GitHub-app.

3. Selecteer de koppeling voor het configureren van uw opslagplaatsen .

   

4. Als u wordt gevraagd om te verifiëren bij GitHub, moet u zich verifiëren.

5. Selecteer Configureren op de pagina Microsoft DevCenter.

   

6. Selecteer de GitHub-organisatie die de opslagplaats bevat die u als catalogus wilt toevoegen. U moet eigenaar van de organisatie zijn om deze app te installeren.

   

7. Selecteer op de pagina Microsoft DevCenter installerenalleen opslagplaatsen, selecteer de opslagplaats die u als catalogus wilt toevoegen en selecteer Vervolgens Opslaan.

   

   U kunt meerdere opslagplaatsen selecteren die u als catalogus wilt toevoegen. U moet elke opslagplaats toevoegen als een afzonderlijke catalogus, zoals beschreven in de volgende sectie van deze quickstart.

8. Ga terug naar Azure Portal.

9. Selecteer Aanmelden met GitHub in het deelvenster Catalogus toevoegen.

10. Voer in het deelvenster Catalogus toevoegen de volgende gegevens in en selecteer Toevoegen:

    Veld	Waarde
    Repository	Selecteer de opslagplaats die de definitie van de installatiekopieën bevat. Voorbeeld: eShop
    Filiaal	Selecteer de vertakking. Voorbeeld: hoofd
    Mappad	Selecteer de map met submappen waarin uw afbeeldingsdefinities zijn opgeslagen. Voorbeeld: .devcenter/catalog/image-definitions

11. Controleer in het deelvenster Catalogi of uw catalogus wordt weergegeven. Wanneer de verbinding succesvol is, geeft de kolom StatusSynchronisatie geslaagd weer.

    

12. Controleer of de definities van de installatiekopieën correct zijn gesynchroniseerd. Selecteer in het linkermenuDefinities van installatiekopieënbeheren>. In dit voorbeeld ziet u twee afbeeldingsdefinities:

    • backend-dev : deze installatiekopie is een Microsoft Visual Studio + Tools-installatiekopie in Windows 11, geschikt voor de back-end-engineeringomgeving van eShop.
    • front-end-dev : deze installatiekopie is een Microsoft Visual Studio + Tools-installatiekopie in Windows 11, geschikt voor de front-end-engineeringomgeving van eShop.

    

Een dev box-pool aanmaken voor de afbeeldingsdefinitie.

Als u het aanpassingsbestand imagedefinition.yaml toegankelijk wilt maken voor het creëren van ontwikkelboxen, specificeert u het als de afbeeldingsdefinitie voor een pool.

Een dev box-pool maken die is gekoppeld aan een project:

1. In Azure Portal.

2. Voer projecten in het zoekvak in. Selecteer Projecten in de lijst met resultaten.

3. Open het project waarin u de ontwikkelboxgroep wilt maken.

4. Selecteer In het menu links de optieDev-boxpoolsbeheren>

5. Selecteer Maken op de pagina Dev-vakgroepen.

6. Voer in het deelvenster Een ontwikkelboxpool maken de volgende waarden in:

   Instelling	Waarde
   Naam	Voer een beschrijvende naam in voor de pool. De naam van de pool is zichtbaar voor ontwikkelaars om te selecteren wanneer ze ontwikkelvakken maken, dus neem het doel en de regio van de pool op. De naam moet uniek zijn binnen een project. Voorbeeld: contoso-frontend-westUS
   Definitie	Selecteer in de sectie afbeeldingsdefinitie van de lijst een afbeeldingsdefinitie. Voorbeeld: contoso-catalog/frontend-dev
   Berekenen	Selecteer de rekenresources voor de ontwikkelvakken in de pool. Voorbeeld: 8 vCPU, 32 GB RAM
   Opslag	Selecteer de opslagopties voor de ontwikkelvakken in de pool. Voorbeeld: 256 GB SSD
   Winterslaap	Sluimerstand wordt ondersteund wanneer de broninstallatiekopie en de rekenkracht beide compatibel zijn met de sluimerstand.
   Netwerkverbinding	1. Selecteer Implementeren in een gehost Microsoft-netwerk. 2. Selecteer een implementatieregio voor de ontwikkelvakken. Kies een regio dicht bij uw dev box-gebruikers voor de optimale gebruikerservaring. Voorbeeld: VS - west
   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.

   

7. Maak Aan.

8. Controleer of de nieuwe dev box-pool wordt weergegeven in de lijst. Mogelijk moet u het scherm vernieuwen.

De Azure-portal implementeert de dev box-pool en voert statuscontroles uit om ervoor te zorgen dat de image en het netwerk voldoen aan de validatiecriteria voor dev boxes.

Een dev-box maken vanuit de dev box-pool

Wanneer u een dev box maakt vanuit een dev box-pool, wordt de afbeeldingsdefinitie toegepast op de dev box. Het ontwikkelbox wordt gemaakt met de aanpassingen die door het afbeeldingsdefinitiebestand zijn opgegeven.

Een dev box maken in de Microsoft Dev Box ontwikkelaarsportal:

1. Meld u aan bij de Ontwikkelaarsportal van Microsoft Dev Box.

2. Selecteer Nieuw>Nieuwe ontwikkelvak.

3. Een dev box toevoegen, voer de volgende waarden in:

   Instelling	Waarde
   Naam	Voer een naam in voor uw ontwikkelomgeving. Namen van dev-vakken moeten uniek zijn binnen een project. Voorbeeld: contoso-front-end-dev-box
   Project	In de ontwikkelaarsportal worden de projecten vermeld waar u toegang toe hebt. Selecteer het project dat u nodig hebt in de lijst.
   Dev boxpool	In de ontwikkelaarsportal worden alle ontwikkelaarsvakgroepen weergegeven voor het project dat u hebt geselecteerd. Selecteer de juiste pool voor uw werk. Kies een dev box-pool bij u in de buurt voor de laagste latentie.
   Aanpassingen toepassen	Laat dit selectievakje uitgeschakeld. Het wordt gebruikt om gebruikersaanpassingen toe te passen. In dit artikel hebt u teamaanpassingen geconfigureerd.

   Nadat u uw selecties hebt geselecteerd, wordt op de pagina de volgende informatie weergegeven:

   • Of de sluimerstand wel of niet wordt ondersteund.
   • Een melding dat het aanmaken van de ontwikkelomgeving 25 minuten of langer kan duren.

4. Kies Maken om te beginnen met het maken van uw ontwikkelomgeving.

5. Om de voortgang van de creatie te volgen, gebruikt u de dev box-tegel in de developer portal.

Controleer of de aanpassingen zijn toegepast

Dev Box past aanpassingen toe als de laatste fase van het aanmaakproces. Dev Box stuurt je een e-mail wanneer de ontwikkelingsbox gereed is. Vervolgens kunt u controleren of uw aanpassingen zijn toegepast.

1. Wacht totdat het ontwikkelvak is gemaakt.

2. Selecteer in de ontwikkelaarsportal, op de tegel dev box, Acties> en vervolgens Aanpassingen.

   

3. Bevestig in het deelvenster Aanpassingsgegevens de aanpassingen die zijn toegepast op de ontwikkelomgeving.

   

Resources opschonen

1. Meld u aan bij de ontwikkelaarsportal.

2. Voor het ontwikkelvak dat u wilt verwijderen, selecteert u Verwijderen in het menu Acties.

   

3. Selecteer Verwijderen om de verwijdering te bevestigen.

   

Gerelateerde inhoud

• Microsoft Dev Box-aanpassingen
• Een aanpassingsbestand schrijven voor een ontwikkelaarsvak