Taken maken voor Dev Box-teamaanpassingen
Wanneer u taken maakt voor microsoft Dev Box-teamaanpassingen, kunt u specifieke acties definiëren voor uw ontwikkelvakken om een consistente en efficiënte ontwikkelomgeving te garanderen. Door nieuwe taken in een catalogus te maken, kunt u herbruikbare onderdelen definiëren die zijn afgestemd op uw ontwikkelteams en kaders toevoegen voor de configuraties die mogelijk zijn. In dit artikel wordt u begeleid bij het maken van een catalogus voor aanpassingstaken, het toevoegen van taken en het koppelen van de catalogus aan een ontwikkelaarscentrum of project.
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 dit artikel wilt uitvoeren, moet u het volgende hebben:
- Een ontwikkelaarscentrum dat is geconfigureerd met een dev box-project.
- Een bestaande catalogus in GitHub of Azure-opslagplaatsen.
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. |
Wat zijn taken?
Een taak voert een specifieke actie uit, zoals het installeren van software. Elke taak bestaat uit een of meer PowerShell-scripts, samen met een task.yaml-bestand dat parameters biedt en definieert hoe de scripts worden uitgevoerd. U kunt ook een PowerShell-opdracht opnemen in het bestand task.yaml.
U kunt een verzameling gecureerde taken opslaan in een catalogus die is gekoppeld aan uw ontwikkelaarscentrum, waarbij elke taak zich in een afzonderlijke map bevindt. Dev Box biedt ondersteuning voor het gebruik van een GitHub-opslagplaats of een Opslagplaats voor Azure-opslagplaatsen als catalogus. Dev Box scant een opgegeven map van de catalogus recursief om taakdefinities te vinden.
WinGet en PowerShell zijn beschikbaar vanuit elk ontwikkelcentrum zonder dat hiervoor een catalogus nodig is. Als uw aanpassingen alleen WinGet of PowerShell gebruiken, kunt u taken maken die deze gebruiken in een aanpassingsbestand. Als u andere hulpprogramma's of scripts wilt gebruiken, kunt u taken maken in een catalogus.
Microsoft biedt een snelstartcatalogus waarmee u aan de slag kunt met aanpassingen. Het bevat een standaardset taken die algemene acties definiëren:
- Installeer software met WinGet-pakketbeheer.
- Implementeer Desired State Configuration (DSC) met behulp van WinGet-configuratie.
- Kloon een opslagplaats met behulp van
git-clone. - Configureer toepassingen zoals het installeren van Visual Studio-extensies.
- Voer PowerShell-scripts uit.
Taken maken in een catalogus
Taken, zoals het installeren van software of het uitvoeren van scripts, worden ingedeeld in een catalogus. U maakt en beheert taken in een catalogus, definieert nieuwe taken en koppelt uw catalogus aan een ontwikkelaarscentrum. Met de snelstartcatalogus van Microsoft kunt u aan de slag met algemene taken, zoals het installeren van software, het implementeren van DSC, het klonen van opslagplaatsen en het configureren van toepassingen.
Nieuwe taken definiëren
Voer de volgende stappen uit om taken te maken en te beheren voor Dev Box-teamaanpassingen:
Maak een opslagplaats om uw taken op te slaan. U kunt eventueel een kopie maken van de quickstart-catalogus in uw eigen opslagplaats om te gebruiken als uitgangspunt.
Maak taken in uw opslagplaats door bestaande PowerShell-scripts te wijzigen of door nieuwe scripts te maken. Als u taken wilt maken, kunt u de voorbeelden in de GitHub-opslagplaats gebruiken voor voorbeelden van ontwikkelaarscentrums en in PowerShell-documentatie.
Koppel uw opslagplaats als een catalogus aan uw ontwikkelaarscentrum.
Maak een configuratiebestand voor deze taken door de stappen in Een aanpassingsbestand schrijven te volgen.
Geheimen uit een Azure-sleutelkluis gebruiken
U kunt geheimen uit uw Azure-sleutelkluis in uw YAML-configuraties gebruiken om privéopslagplaatsen te klonen of met een aangepaste taak die u ontwerpt waarvoor een toegangstoken is vereist.
Uw ontwikkelaarscentrum heeft toegang nodig tot uw sleutelkluis. DevCenter biedt geen ondersteuning voor servicetags, dus als uw sleutelkluis privé blijft, moet u vertrouwde Microsoft-services toestaan om de firewall te omzeilen.
Uw sleutelkluisgeheimen configureren voor gebruik in uw YAML-configuraties:
Zorg ervoor dat de beheerde identiteit van uw ontwikkelaarscentrumproject de rol Key Vault Reader en Key Vault Secrets User in uw sleutelkluis heeft.
Verdeel de rol Key Vault Secrets User voor het sleutelkluisgeheim aan elke gebruiker of gebruikersgroep die het geheim moet kunnen gebruiken tijdens het aanpassen van een ontwikkelvak. De gebruiker of groep waaraan de rol is verleend, moet de beheerde identiteit voor het ontwikkelaarscentrum, uw eigen gebruikersaccount en elke gebruiker of groep bevatten die het geheim nodig heeft tijdens het aanpassen van een ontwikkelvak.
Een catalogus bijvoegen
U kunt een catalogus aan een project koppelen om taken toegankelijk te maken voor het ontwikkelaarsteam. Als u een catalogus aan een project wilt koppelen, volgt u de stappen in Een catalogus toevoegen en configureren vanuit GitHub of Azure-opslagplaatsen.