Quickstart: Een ontwikkelvak maken met behulp van teamaanpassingen

In deze quickstart maakt u een ontwikkelvak 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.

Belangrijk

De functie voor aanpassingen van het Dev Box-team is momenteel beschikbaar als preview-versie. Zie de aanvullende gebruiksvoorwaarden voor Microsoft Azure Previews voor meer informatie over de preview-status. In het document worden juridische termen gedefinieerd die van toepassing zijn op Azure-functies die in bèta, in preview of anderszins nog niet beschikbaar zijn voor algemene beschikbaarheid.

Vereisten

Als u de stappen in deze quickstart wilt uitvoeren, moet u een ontwikkelaarscentrum hebben geconfigureerd met een dev box-project.

Vereiste machtigingen voor het configureren van aanpassingen

Als u de vereiste acties wilt uitvoeren voor het maken en toepassen van aanpassingen op een ontwikkelvak, hebt u de volgende machtigingen nodig:

Actie	Machtiging/rol
Schakel catalogi op projectniveau in voor een ontwikkelaarscentrum.	Platformengineer met schrijftoegang voor het abonnement.
Synchronisatie-instellingen voor catalogus inschakelen voor een project.	Platformengineer met schrijftoegang voor het abonnement.
Voeg een catalogus toe aan een project.	Machtigingen voor projectbeheerder of inzender voor het project.
Maak een aanpassingsbestand.	Geen opgegeven. Iedereen kan een aanpassingsbestand maken.
Gebruik de ontwikkelaarsportal om een YAML-bestand te uploaden en toe te passen tijdens het maken van het ontwikkelvak.	Dev Box-gebruiker.
Taken toevoegen aan een catalogus.	Machtiging om toe te voegen aan de opslagplaats die als host fungeert voor de catalogus.

Een definitie voor de installatiekopie maken

1. Download het voorbeeld van het YAML-aanpassingsbestand.
2. Open het bestand en bekijk de taken.

Het afbeeldingsdefinitiebestand geeft een naam op voor de definitie van de installatiekopieën met behulp van een name veld. Gebruik deze naam om de definitie van de installatiekopieën in de dev box-pool te identificeren.

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 Configuratie in het servicemenu onder Instellingen.

   

3. Selecteer catalogi op projectniveau in het deelvenster Catalogi op projectniveau inschakelen 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. Installeer en configureer de Microsoft Ontwikkelaarscentrum-app.
3. Wijs machtigingen toe in GitHub voor de opslagplaatsen.
4. Voeg uw opslagplaats toe als catalogus.

De voorbeeldcatalogusopslagplaats splitsen

1. Open de voorbeeldcatalogusopslagplaats.
2. Selecteer Fork om de opslagplaats te splitsen in uw GitHub-organisatie.

De Microsoft Ontwikkelaarscentrum-app installeren

1. Meld u aan bij het Azure-portaal.

2. Ga naar uw ontwikkelaarscentrum of project.

3. Selecteer Catalogs in het servicemenu onder Omgevingsconfiguratie en selecteer vervolgens Toevoegen.

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

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

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

   

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

7. Selecteer Configureren op de pagina Microsoft DevCenter.

   

8. 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.

   

9. Selecteer op de pagina Microsoft DevCenter installeren alleen opslagplaatsen, selecteer de opslagplaats die u als catalogus wilt toevoegen en selecteer Vervolgens Installeren.

   

   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.

10. Controleer op het Microsoft DevCenter van Microsoft de machtiging voor de pagina, controleer de vereiste machtigingen en selecteer Vervolgens Microsoft DevCenter autoriseren.

    

Uw opslagplaats toevoegen als catalogus

1. Ga terug naar de Azure-portal.

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

   Veld	Waarde
   Repo	Selecteer de opslagplaats die u als catalogus wilt toevoegen.
   Vertakking	Selecteer de vertakking.
   Mappad	Selecteer de map met submappen die uw omgevingsdefinities bevatten.

   

3. Controleer in het deelvenster Catalogi of uw catalogus wordt weergegeven. Wanneer de verbinding is geslaagd, wordt in de kolom Status gesynchroniseerd weergegeven.

   

Een dev box-pool maken voor de definitie van de installatiekopieën

Als u het aanpassingsbestand imagedefintion.yaml wilt maken, toegankelijk voor het maken van ontwikkelvakken, geeft u het op als de definitie van de installatiekopie voor een pool.

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

1. Meld u aan bij het Azure-portaal.

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

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

4. Selecteer Dev-vakgroepen en selecteer vervolgens Maken.

5. Voer in het deelvenster Een ontwikkelvakgroep maken de volgende waarden in:

   Instelling	Weergegeven als
   Naam	Voer een naam in voor de pool. De naam van de pool is zichtbaar voor ontwikkelaars om te selecteren wanneer ze ontwikkelvakken maken. De naam moet uniek zijn binnen een project.
   Definitie	Selecteer de definitie, zoals opgegeven in het afbeeldingsdefinitiebestand.
   Netwerkverbinding	1. Selecteer Implementeren in een gehost Microsoft-netwerk. 2. Selecteer de gewenste implementatieregio voor de ontwikkelvakken. Kies een regio dicht bij uw dev box-gebruikers voor de optimale gebruikerservaring.
   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 schema voor automatisch stoppen configureren nadat de pool is gemaakt.
   Stoptijd	Selecteer een tijd om alle ontwikkelvakken in de pool af te sluiten. Alle ontwikkelvakken in deze pool worden elke dag afgesloten.
   Tijdzone	Selecteer de tijdzone voor de stoptijd.
   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.

   

6. Selecteer Maken.

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

Azure Portal implementeert de dev box-pool en voert statuscontroles uit om ervoor te zorgen dat de installatiekopieën en het netwerk voldoen aan de validatiecriteria voor dev-vakken.

Een dev-box maken vanuit de dev box-pool

Wanneer u een ontwikkelaarsvak maakt vanuit een dev box-pool, wordt de definitie van de installatiekopieën toegepast op het ontwikkelvak. Het ontwikkelaarsvak wordt gemaakt met de aanpassingen die door het definitiebestand van de installatiekopieën zijn opgegeven.

Een ontwikkelaarsvak maken in de Ontwikkelaarsportal van Microsoft Dev Box:

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

2. Selecteer nieuw>ontwikkelvak.

3. Voer in het vak Een dev toevoegen de volgende waarden in:

   Instelling	Weergegeven als
   Naam	Voer een naam in voor uw ontwikkelvak. Namen van dev-vakken moeten uniek zijn binnen een project.
   Project	Selecteer een project in de vervolgkeuzelijst.
   Dev Box-pool	Selecteer een pool in de vervolgkeuzelijst, die alle dev box-pools voor dat project bevat. Kies een dev box-pool bij u in de buurt voor de laagste latentie.

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

   • Hoeveel dev-vakken u kunt maken in het project dat u hebt geselecteerd, als het project limieten heeft geconfigureerd.
   • Of de sluimerstand wel of niet wordt ondersteund.
   • Of aanpassingen wel of niet zijn ingeschakeld.
   • Een afsluittijd als de pool waarin u het ontwikkelvak maakt, een afsluitschema heeft.
   • Een melding dat het proces voor het maken van het ontwikkelvak 25 minuten of langer kan duren.

4. Selecteer Maken om te beginnen met het maken van uw ontwikkelvak.

5. Als u de voortgang van het maken wilt bijhouden, gebruikt u de tegel dev box in de ontwikkelaarsportal.

Controleer of de aanpassing is toegepast

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

1. Wacht op e-mailbevestiging dat het ontwikkelvak is gemaakt.

2. Selecteer in de ontwikkelaarsportal, op de tegel dev box, actiesaanpassingen>.

   

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

   

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-teamaanpassingen
• Een aanpassingsbestand schrijven voor een ontwikkelaarsvak