Dela via

Konfigurera användaranpassningar för dev-rutor

Du kan anpassa Din Microsoft Dev Box genom att ladda upp en användaranpassningsfil. Med användaranpassningsfiler kan du konfigurera din utvecklingsruta med önskade personliga inställningar och appar, så att du kan börja koda snabbare. Den här artikeln beskriver hur du skapar, testar och laddar upp en användaranpassningsfil från din lokala enhet eller lagringsplats med hjälp av Visual Studio-koden (VS). Du får också lära dig hur du verifierar filen och hanterar anpassningsinställningar för projekt.

Använd anpassningar i Microsoft Dev Box på två sätt: Teamanpassningar skapar en delad konfiguration för ett team och användaranpassningar skapar en personlig konfiguration för en enskild utvecklare. I följande tabell visas skillnaderna mellan de två typerna av anpassningar.

Egenskap Teamanpassningar Användaranpassningar
Konfigurera på Pool för utvecklingsboxar Utvecklingslåda
Anpassningar gäller för Alla utvecklingslådor i poolen Enskild utvecklingsmiljö
Lätt att dela Ja Nej
Namn på anpassningsfil Imagedefinition.yaml myfilename.yaml eller workload.yaml
Källa Katalog Ladda upp eller personlig lagringsplats
Stödjer nyckelvalv-hemligheter Ja Ja

Användaranpassningar hjälper till att säkerställa att utvecklare följer företagets riktlinjer; endast anpassade uppgifter som har godkänts i förväg via en katalog är tillgängliga för utvecklare att använda i sina anpassningsfiler. Standard dev box-användare kan inte köra inbyggda PowerShell- och WinGet-uppgifter i en systemkontext, vilket förhindrar eskalering av privilegier.

Användaranpassningar kan aktiveras eller inaktiveras på projektnivå. När du skapar ett projekt är användaranpassningar aktiverade som standard.

Förutsättningar

Så här slutför du stegen i den här artikeln:

Behörigheter som krävs för att konfigurera anpassningar

Om du vill skapa och tillämpa anpassningar på en utvecklingsruta behöver du följande behörigheter:

Åtgärd Behörighet eller roll
Aktivera eller inaktivera användaranpassningar i ett projekt Skrivbehörighet för projektet.
Skapa en anpassningsfil Inget angivet. 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

Skapa en användaranpassningsfil

Skapa och hantera anpassningsfiler i VS Code. Använd Microsoft Dev Box-tillägget i VS Code för att identifiera uppgifter i den anslutna katalogen och testa anpassningsfilen.

  1. Skapa en utvecklingsruta för testning eller använd en befintlig utvecklingsruta.

  2. Installera VS Code i test-utvecklingsrutan och installera sedan Dev Box-tillägget.

  3. Ladda ned en YAML-exempelanpassningsfil från exempellagringsplatsen och öppna den sedan i VS Code.

  4. Identifiera tillgängliga uppgifter i katalogen med hjälp av kommandopaletten. Välj Visa>kommandopaletten>Dev Box: Lista tillgängliga uppgifter för den här dev boxen.

    Skärmbild av Dev Box-kommandopaletten i Visual Studio Code som visar kommandot för att visa tillgängliga uppgifter.

  5. Testa anpassningen i VS Code med hjälp av kommandopaletten. Välj Visa>Kommandopalett>Utvecklingsruta: Tillämpa anpassningsuppgifter.

    Skärmbild av Dev Box-kommandopaletten i Visual Studio Code som visar kommandot för att tillämpa anpassningsuppgifter.

  6. Anpassningsfilen körs och tillämpar de angivna uppgifterna på testutvecklingsrutan. Granska ändringarna och kontrollera VS Code-terminalen om det finns fel eller varningar under aktivitetskörningen.

  7. När anpassningsfilen har körts laddar du upp den till katalogen.

Valfritt: Anpassa utvecklingsrutan med hjälp av befintliga WinGet-konfigurationsfiler

WinGet-konfigurationen använder en metod för konfiguration som kod för att definiera de unika uppsättningar av programvara och konfigurationsinställningar som behövs för att göra Din Windows-miljö redo att kodas. Du kan också använda de här konfigurationsfilerna för att konfigurera en utvecklingsruta med hjälp av en WinGet-uppgift som ingår i snabbstartskatalogen som tillhandahålls av Microsoft.

Det här exemplet visar en dev box-anpassningsfil som använder en befintlig DSC-fil (WinGet Desired State Configuration).

tasks:
    - name: winget
      parameters:
          configure: "projectConfiguration.dsc.yaml"

Mer information finns i WinGet-konfiguration.

Skapa en utvecklingsruta med hjälp av en användaranpassningsfil

Använd en enskild anpassningsfil genom att ladda upp den från en lokal enhet när du skapar utvecklingsrutan eller genom att ladda ned den från en lagringsplats. Anpassningsfiler som lagras på en lagringsplats måste ha namnet workload.yaml. Anpassningsfiler som lagras lokalt för uppladdning ska ha namnet myfilename.yaml.

Ladda upp en fil

  1. I utvecklarportalen väljer du rutan Ny>ny utveckling.

  2. I rutan Lägg till en utvecklingsruta lägger du till information för utvecklingsrutan.

  3. Välj Tillämpa anpassningar och välj sedan Fortsätt.

    Skärmbild av fönstret Lägg till en utvecklingsruta i utvecklarportalen som visar alternativet att tillämpa anpassningar.

  4. Välj Ladda upp en anpassningsfil eller anpassningsfil, välj Lägg till anpassningar från filen och bläddra sedan till och välj filen myfilename.yaml .

    Skärmbild av avsnittet Ladda upp en anpassningsfil i utvecklarportalen med alternativet att lägga till anpassningar från en fil.

  5. Kontrollera att uppgifterna i anpassningsfilen tillämpas korrekt genom att verifiera dem innan du fortsätter. Välj validera.

    Skärmbild av knappen Verifiera i utvecklarportalen som visar alternativet att verifiera anpassningsfilen innan du fortsätter.

  6. Granska sammanfattningen av skapande av dev box och välj sedan Skapa.

    Skärmbild av sammanfattningssidan för utvecklingsrutan i utvecklarportalen som visar alternativet att skapa en anpassad utvecklingsruta.

Hämta en fil från en lagringsplats

  1. I utvecklarportalen väljer du rutan Ny>ny utveckling.

  2. I rutan Lägg till en utvecklingsruta lägger du till information för utvecklingsrutan.

  3. Välj Tillämpa anpassningar och välj sedan Fortsätt.

    Skärmbild av fönstret Lägg till en utvecklingsruta i utvecklarportalen som visar alternativet att tillämpa anpassningar.

  4. Välj Ladda upp en eller flera anpassningsfiler, välj Välj en anpassningsfil från en lagringsplats och ange sedan URL:en för lagringsplatsen som lagrar filen workload.yaml .

    Skärmbild av avsnittet Välj en anpassningsfil från en lagringsplats i utvecklarportalen, som visar alternativet att ange en lagringsplats-URL.

  5. Verifiera att uppgifterna i anpassningsfilen tillämpas korrekt genom att verifiera dem innan du fortsätter. Välj validera.

    Skärmbild av knappen Verifiera i utvecklarportalen som visar alternativet att verifiera anpassningsfilen innan du fortsätter.

  6. Granska sammanfattningen av skapande av dev box och välj sedan Skapa.

    Skärmbild av sammanfattningssidan för utvecklingsrutan i utvecklarportalen som visar alternativet att skapa en anpassad utvecklingsruta.

Inaktivera användaranpassningar

Användaranpassningar styrs på projektnivå och aktiveras som standard. Du kan inaktivera dem under eller efter att projektet har skapats. När de är inaktiverade kan utvecklare inte tillämpa sina egna anpassningsfiler på nya dev-rutor. Att aktivera användaranpassningar kringgår inte befintliga projektskyddsmekanismer. utvecklare kan bara använda uppgifter som tillhandahålls i den anslutna katalogen och kan inte köra uppgifter med förhöjd behörighet om inte en administratör uttryckligen har inkluderat en administrativ uppgift i katalogen.

Inaktivera användaranpassningar via Azure-portalen

  1. Logga in på Azure-portalen.

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

  3. På sidan Projekt väljer du det projekt där du vill inaktivera användaranpassningar.

  4. Gå till Inställningar>Dev box-inställningar.

    Skärmbild av ett dev box-projekt som visar funktionen för användaranpassningar aktiverad i dev box-inställningarna.

  5. Om du vill inaktivera användaranpassningar avmarkerar du kryssrutan Aktivera och väljer sedan Använd.

Utvecklarupplevelse i utvecklarportalen

När du inaktiverar användaranpassningar för ett projekt kan utvecklare fortfarande ladda upp en användaranpassningsfil när dev box skapas, men valideringsprocessen misslyckas och anpassningarna tillämpas inte på utvecklingsrutan.

Om du skapar en utvecklingsruta med användaranpassningar i ett projekt där användaranpassningar är inaktiverade visas följande i utvecklarportalen:

  1. Ett meddelande på den nya dev box-panelen visar fel vid anpassningar.

    Skärmbild av en dev box-panel som visar meddelandet Vi påträffade fel när anpassningar tillämpades. Knappen Visa information är markerad.

  2. Informationen säger att du ska kontakta administratören.

    Skärmbild av fönstret med felinformation i utvecklarportalen, som visar ett meddelande om att anpassningarna misslyckades och rådde användaren att kontakta administratören.

  3. Utvecklingsrutan innehåller inte användaranpassningar.

Relaterat innehåll

  • Last updated on