Skapa uppgifter för Dev Box-teamanpassningar
När du skapar uppgifter för Microsoft Dev Box-teamanpassningar kan du definiera specifika åtgärder för dina utvecklingsrutor för att säkerställa en konsekvent och effektiv utvecklingsmiljö. Genom att skapa nya uppgifter i en katalog kan du definiera återanvändbara komponenter som är skräddarsydda för dina utvecklingsteam och lägga till skyddsräcken kring de konfigurationer som är möjliga. Den här artikeln vägleder dig genom att skapa en katalog för anpassningsuppgifter, lägga till uppgifter och koppla katalogen till ett utvecklingscenter eller projekt.
Viktigt!
Dev Box-teamets anpassningsfunktion är för närvarande i förhandsversion. Mer information om förhandsversionens status finns i Kompletterande användningsvillkor för Förhandsversioner av Microsoft Azure. Dokumentet definierar juridiska villkor som gäller för Azure-funktioner som är i betaversion, förhandsversion eller som inte ännu släppts i allmän tillgänglighet.
Förutsättningar
För att slutföra stegen i den här artikeln måste du ha:
- Ett utvecklingscenter som konfigurerats med ett dev box-projekt.
- En befintlig katalog i GitHub eller Azure Repos.
Behörigheter som krävs för att konfigurera anpassningar
Om du vill utföra de åtgärder som krävs för att skapa och tillämpa anpassningar på en utvecklingsruta behöver du följande behörigheter:
| Åtgärd | Behörighet/roll |
|---|---|
| Aktivera kataloger på projektnivå för ett utvecklingscenter. | Plattformstekniker med skrivåtkomst till prenumerationen. |
| Aktivera inställningar för katalogsynkronisering för ett projekt. | Plattformstekniker med skrivåtkomst till prenumerationen. |
| Koppla en katalog till ett projekt. | Projektadministratörs- eller deltagarbehörigheter för projektet. |
| Skapa en anpassningsfil. | Ingen har angetts. Vem som helst kan skapa en anpassningsfil. |
| Använd utvecklarportalen för att ladda upp och tillämpa en YAML-fil när dev box skapas. | Dev Box-användare. |
| Lägg till uppgifter i en katalog. | Behörighet att lägga till på den lagringsplats som är värd för katalogen. |
Vad är uppgifter?
En uppgift utför en specifik åtgärd, till exempel att installera programvara. Varje uppgift består av ett eller flera PowerShell-skript, tillsammans med en task.yaml-fil som innehåller parametrar och definierar hur skripten körs. Du kan också inkludera ett PowerShell-kommando i filen task.yaml.
Du kan lagra en samling utvalda uppgifter i en katalog som är kopplad till utvecklingscentret, med varje uppgift i en separat mapp. Dev Box stöder användning av en GitHub-lagringsplats eller en Azure Repos-lagringsplats som en katalog. Dev Box söker igenom en angiven mapp i katalogen rekursivt för att hitta uppgiftsdefinitioner.
WinGet och PowerShell är tillgängliga från alla dev center utan att en katalog krävs. Om dina anpassningar endast använder WinGet eller PowerShell kan du skapa uppgifter som använder dem i en anpassningsfil. Om du behöver använda andra verktyg eller skript kan du skapa uppgifter i en katalog.
Microsoft tillhandahåller en snabbstartskatalog som hjälper dig att komma igång med anpassningar. Den innehåller en standarduppsättning med uppgifter som definierar vanliga åtgärder:
- Installera programvara med winget-pakethanteraren.
- Distribuera DSC (Desired State Configuration) med hjälp av WinGet-konfiguration.
- Klona en lagringsplats med hjälp
git-cloneav . - Konfigurera program som att installera Visual Studio-tillägg.
- Kör PowerShell-skript.
Skapa uppgifter i en katalog
Uppgifter, till exempel att installera programvara eller köra skript, ordnas i en katalog. Du skapar och hanterar uppgifter i en katalog, definierar nya uppgifter och kopplar katalogen till ett utvecklingscenter. Med Microsofts snabbstartskatalog kan du komma igång med vanliga uppgifter som att installera programvara, distribuera DSC, klona lagringsplatser och konfigurera program.
Definiera nya uppgifter
Följ dessa steg för att skapa och hantera uppgifter för Dev Box-teamanpassningar:
Skapa en lagringsplats för att lagra dina uppgifter. Du kan också göra en kopia av snabbstartskatalogen på din egen lagringsplats för användning som utgångspunkt.
Skapa uppgifter på lagringsplatsen genom att ändra befintliga PowerShell-skript eller genom att skapa nya skript. Om du vill börja skapa uppgifter kan du använda exemplen på GitHub-lagringsplatsen för dev center-exempel och i PowerShell-dokumentationen.
Koppla lagringsplatsen till utvecklingscentret som en katalog.
Skapa en konfigurationsfil för dessa uppgifter genom att följa stegen i Skriva en anpassningsfil.
Använda hemligheter från ett Azure-nyckelvalv
Du kan använda hemligheter från ditt Azure-nyckelvalv i YAML-konfigurationerna för att klona privata lagringsplatser, eller med alla anpassade uppgifter som du skapar som kräver en åtkomsttoken.
Utvecklingscentret behöver åtkomst till ditt nyckelvalv. DevCenter stöder inte tjänsttaggar, så om nyckelvalvet hålls privat måste du tillåta att betrodda Microsoft-tjänster kringgår brandväggen.
Så här konfigurerar du dina nyckelvalvshemligheter för användning i YAML-konfigurationerna:
Se till att dev center-projektets hanterade identitet har rollen Key Vault Reader och Key Vault Secrets User i nyckelvalvet.
Ge key vault-hemligheterna användarrollen för nyckelvalvets hemlighet till varje användare eller användargrupp som ska kunna använda hemligheten under anpassningen av en utvecklingsruta. Den användare eller grupp som har beviljats rollen måste innehålla den hanterade identiteten för utvecklingscentret, ditt eget användarkonto och alla användare eller grupper som behöver hemligheten under anpassningen av en utvecklingsruta.
Mer information om hur du använder key vault-hemligheter i en anpassningsfil finns i Klona en privat lagringsplats med hjälp av en anpassningsfil.
Bifoga en katalog
Du kan koppla en katalog till ett projekt för att göra uppgifter tillgängliga för utvecklarteamet. Om du vill koppla en katalog till ett projekt följer du stegen i Lägg till och konfigurera en katalog från GitHub eller Azure Repos.