Snabbstart: Skapa en utvecklingsruta med hjälp av teamanpassningar

I den här snabbstarten skapar du en utvecklingsruta med hjälp av Microsoft Dev Box-teamanpassningar. Funktionen använder en bilddefinitionsfil så att du kan skapa konsekvent anpassade utvecklingsrutor för utvecklingsteamet och tillhandahålla en skräddarsydd miljö för dina projekt.

Förutsättningar

Produkt	Kravspecifikation
Microsoft Dev Box	– Konfigurera ett utvecklingscenter med en dev box-pool och ett dev box-projekt så att du kan skapa en utvecklingslåda. – Koppla en katalog till utvecklingscentret med uppgifter som du kan använda i bilddefinitionsfilen. Om du inte har någon katalog kan du läsa Lägga till och konfigurera en katalog från GitHub eller Azure Repos. -Behörigheter - Så här skapar du en utvecklingsruta: Gå med i säkerhetsgruppen Dev Box-användare för minst ett projekt. - Så här aktiverar du kataloger på projektnivå för ett utvecklingscenter: Plattformstekniker med skrivåtkomst till prenumerationen. - Så här aktiverar du inställningar för katalogsynkronisering för ett projekt: Plattformstekniker med skrivåtkomst till prenumerationen. - Så här kopplar du en katalog till ett projekt: Projektadministratörs- eller deltagarbehörigheter för Dev Center för projektet. - Så här skapar du en anpassningsfil: Ingen har angetts. Vem som helst kan skapa en anpassningsfil. - Så här använder du utvecklarportalen för att ladda upp och tillämpa en YAML-fil när dev box skapas: Dev Box-användare. - Så här lägger du till uppgifter i en katalog: Behörighet att lägga till på den lagringsplats som är värd för katalogen.
Visual Studio Code	– Installera den senaste versionen

Skapa en bilddefinition

Om du vill skapa en utvecklingsruta med anpassningar måste du skapa en bilddefinitionsfil. Bilddefinitionsfilen är en YAML-fil som innehåller de anpassningar som du vill tillämpa på utvecklingsrutan. Du kan använda exempelbildens definitionsfil i den här snabbstarten som utgångspunkt.

Aktivera kataloger på projektnivå

Du måste aktivera kataloger på projektnivå på utvecklingscenternivå innan du kan lägga till en katalog i ett projekt.

1. I Azure Portal går du till utvecklingscentret.

2. På tjänstmenyn går du till Inställningar och väljer Inställningar för Dev Center.

3. Under Kataloger på projektnivå väljer du Aktivera kataloger per projekt och sedan Använd.

   

Lägga till en katalog i projektet

Avsnitten som följer vägleder dig genom dessa uppgifter:

1. Förgrena exempelkataloglagringsplatsen till din GitHub-organisation.
2. Konfigurera synkroniseringsinställningar för att synkronisera katalogen med projektet.
3. Lägg till din lagringsplats som en katalog.

Förgrena exempelkataloglagringsplatsen

1. Öppna exempelkataloglagringsplatsen.

2. Välj Förgrena>Skapa en ny förgrening för att förgrena lagringsplatsen till din GitHub-organisation.

   

Konfigurera inställningar för katalogsynkronisering

1. Växla tillbaka till Azure-portalen.

2. I sökrutan anger du projekt. I listan med resultat väljer du Projekt.

3. Välj det projekt som du vill lägga till katalogen i.

4. På den vänstra menyn väljer du Inställningar>Kataloger.

5. Välj Synkroniseringsinställningar.

   

6. I fönstret Synkroniseringsinställningar :

   • Om Bilddefinitioner har avmarkerats väljer du den och väljer Spara.
   • Om Bilddefinitioner redan har valts väljer du Avbryt.

   

Lägga till din lagringsplats som en katalog

1. På sidan Kataloger väljer du Lägg till.

2. I fönstret Lägg till katalog anger eller väljer du följande värden:

   Fält	Värde
   Namn	Ange ett namn för katalogen.
   Katalogkälla	Välj GitHub.
   Autentiseringstyp	Välj GitHub-app.

3. Välj länken konfigurera dina lagringsplatser.

   

4. Om du uppmanas att autentisera till GitHub autentiserar du.

5. På sidan Microsoft DevCenter väljer du Konfigurera.

   

6. Välj den GitHub-organisation som innehåller den lagringsplats som du vill lägga till som en katalog. Du måste vara ägare till organisationen för att kunna installera den här appen.

   

7. På sidan Installera Microsoft DevCenter väljer du Endast lagringsplatser, väljer den lagringsplats som du vill lägga till som en katalog och väljer sedan Spara.

   

   Du kan välja flera lagringsplatser att lägga till som kataloger. Du måste lägga till varje lagringsplats som en separat katalog enligt beskrivningen i nästa avsnitt i den här snabbstarten.

8. Växla tillbaka till Azure-portalen.

9. I fönstret Lägg till katalog väljer du Logga in med GitHub.

10. I fönstret Lägg till katalog anger du följande information och väljer sedan Lägg till:

    Fält	Värde
    Repository	Välj den lagringsplats som innehåller din bilddefinition. Exempel: eShop
    Gren	Välj grenen. Exempel: main
    Mappsökväg	Välj mappen som innehåller undermappar som innehåller dina bilddefinitioner. Exempel: .devcenter/catalog/image-definitions

11. Kontrollera att katalogen visas i fönstret Kataloger . När anslutningen har slutförts visar kolumnen Status Synkroniseringen lyckades.

    

12. Kontrollera att bilddefinitionerna är korrekt synkroniserade. Välj Hantera>bilddefinitioner på den vänstra menyn. I det här exemplet visas två bilddefinitioner:

    • backend-dev – Den här bilden är en Microsoft Visual Studio + Tools-avbildning i Windows 11, lämplig för eShop-serverdelsmiljön .
    • frontend-dev – Den här avbildningen är en Microsoft Visual Studio + Tools-avbildning i Windows 11, lämplig för utvecklingsmiljön för eShop-klientdelen .

    

Skapa en dev box-pool för bilddefinitionen

Om du vill göra anpassningsfilen imagedefintion.yaml tillgänglig för att skapa dev-rutor anger du den som avbildningsdefinition för en pool.

Så här skapar du en dev box-pool som är associerad med ett projekt:

1. I Azure-portalen.

2. I sökrutan anger du projekt. I listan med resultat väljer du Projekt.

3. Öppna projektet där du vill skapa utvecklingspoolen.

4. På den vänstra menyn väljer du Hantera>Dev box-pooler

5. På sidan Dev box-pooler väljer du Skapa.

6. I fönstret Skapa en utvecklingspool anger du följande värden:

   Inställning	Värde
   Namn	Ange ett beskrivande namn för poolen. Poolnamnet är synligt för utvecklare att välja när de skapar dev-rutor, så inkludera syftet och regionen för poolen. Namnet måste vara unikt i ett projekt. Exempel: contoso-frontend-westUS
   Definition	I bilddefinitionsavsnittet i listan väljer du en bilddefinition. Exempel: contoso-catalog/frontend-dev
   Beräkning	Välj beräkningsresurserna för utvecklingsrutorna i poolen. Exempel: 8 vCPU, 32 GB RAM
   Förvaring	Välj lagringsalternativen för utvecklingsrutorna i poolen. Exempel: 256 GB SSD
   Vinterdvala	Viloläge stöds när källbilden och beräkningsstorleken båda är vilolägeskompatibla.
   Nätverksanslutning	1. Välj Distribuera till ett Microsoft-hostat nätverk. 2. Välj en distributionsregion för utvecklingsrutorna. Välj en region nära dina dev box-användare för den optimala användarupplevelsen. Exempel: USA, västra
   Licensiering	Markera den här kryssrutan för att bekräfta att din organisation har Azure Hybrid-förmån licenser som du vill använda för utvecklingsrutorna i den här poolen.

   

7. Välj Skapa.

8. Kontrollera att den nya dev box-poolen visas i listan. Du kan behöva uppdatera skärmen.

Azure-portalen distribuerar utvecklingsbox-poolen och kör hälsokontroller för att säkerställa att avbildningen och nätverket uppfyller valideringskriterierna för utvecklingsboxar.

Skapa en utvecklingsruta från dev box-poolen

När du skapar en utvecklingsruta från en dev box-pool tillämpas bilddefinitionen på utvecklingsrutan. Utvecklingsrutan skapas med de anpassningar som bilddefinitionsfilen har angett.

Så här skapar du en utvecklingsruta i Microsoft Dev Box-utvecklarportalen:

1. Logga in på Microsoft Dev Box-utvecklarportalen.

2. Välj Ny>Ny utvecklingslåda.

3. I avsnittet Lägg till en utvecklingsmiljö ska du ange följande värden:

   Inställning	Värde
   Namn	Ange ett namn för utvecklingsrutan. Dev box-namn måste vara unika i ett projekt. Exempel: contoso-frontend-dev-box
   Projekt	Utvecklarportalen visar de projekt som du har åtkomst till. Välj det projekt som du behöver i listan.
   Dev boxpool	Utvecklarportalen visar en lista över alla dev box-pooler för det projekt som du har valt. Välj lämplig pool för ditt arbete. Välj en dev box-pool nära dig för den lägsta svarstiden.
   Tillämpa anpassningar	Låt kryssrutan vara avmarkerad. Den används för att tillämpa användaranpassningar. I den här artikeln har du konfigurerat teamanpassningar.

   När du har valt visar sidan följande information:

   • Om viloläge stöds eller inte.
   • Ett meddelande om att processen för att skapa dev box kan ta 25 minuter eller längre.

4. Välj Skapa för att börja skapa utvecklingsrutan.

5. Om du vill spåra förloppet för skapandet använder du dev box-panelen i utvecklarportalen.

Kontrollera att anpassningarna tillämpas

Dev Box tillämpar anpassningar som det sista steget i skapandeprocessen. Dev Box skickar e-post till dig när utvecklingsrutan är klar. Sedan kan du kontrollera att dina anpassningar tillämpas.

1. Vänta tills utvecklingsrutan har skapats.

2. I utvecklarportalen går du till panelen dev box och väljer Åtgärder>Anpassningar.

   

3. I fönstret Anpassningsinformation bekräftar du de anpassningar som tillämpades på utvecklingsrutan.

   

Rensa resurser

1. Logga in på utvecklarportalen.

2. För den utvecklingsruta som du vill ta bort går du till menyn Åtgärder och väljer Ta bort.

   

3. Bekräfta borttagningen genom att välja Ta bort.

   

Relaterat innehåll

• Microsoft Dev Box-anpassningar
• Skriva en anpassningsfil för en utvecklingsruta