Övning – Konfigurera din Azure DevOps-miljö

I den här lektionen ser du till att din Microsoft Azure DevOps-organisation har konfigurerats för att slutföra resten av den här modulen.

Gör så här för att göra den här konfigurationen:

Hämta Azure DevOps-projektet

Här ser du till att din Azure DevOps-organisation har konfigurerats för att slutföra resten av den här modulen. Du gör detta genom att köra en mall som skapar ett projekt åt dig i Azure DevOps.

Modulerna i den här utbildningsvägen utgör en följd där du följer Tailspin-webbteamet under deras DevOps-resa. I utbildningssyfte har varje modul ett associerat Azure DevOps-projekt.

Kör mallen

Kör en mall som konfigurerar din Azure DevOps-organisation.

1. Hämta och kör ADOGenerator-projektet i Visual Studio eller valfri IDE.

2. När du uppmanas att ange mallnumret i listan med mallar anger du 27 för Hantera byggberoenden med Azure Artifacts och trycker sedan på Retur.

3. Välj din autentiseringsmetod. Du kan konfigurera och använda en personlig åtkomsttoken (PAT) eller använda enhetsinloggning.

   Kommentar

   Om du konfigurerar en PAT måste du auktorisera de nödvändiga omfången. För den här modulen kan du använda Fullständig åtkomst, men i en verklig situation bör du se till att du endast beviljar de nödvändiga omfången.

4. Ange ditt Azure DevOps-organisationsnamn och tryck sedan på Retur.

5. Om du uppmanas till det anger du din Azure DevOps PAT och trycker sedan på Retur.

6. Ange ett projektnamn som Space Game – web – Dependencies och tryck sedan på Retur.

7. När du har skapat projektet går du till din Azure DevOps-organisation i webbläsaren och https://dev.azure.com/<your-organization-name>/ väljer projektet.

Förgrena lagringsplatsen

Skapa en förgrening av lagringsplatsen mslearn-tailspin-spacegame-web om du inte redan har gjort det.

1. På GitHub går du till lagringsplatsen mslearn-tailspin-spacegame-web .

2. Välj Fork längst upp till höger på skärmen.

3. Välj ditt GitHub-konto som ägare och välj sedan Skapa förgrening.

Ange projektets synlighet

Ursprungligen är din förgrening av Space Game-lagringsplatsen på GitHub inställd på offentlig medan projektet som skapats av Azure DevOps-mallen är inställt på privat. En offentlig lagringsplats på GitHub kan nås av vem som helst, medan en privat lagringsplats endast är tillgänglig för dig och de personer som du väljer att dela den med. På samma sätt ger offentliga projekt i Azure DevOps skrivskyddad åtkomst till icke-autentiserade användare, medan privata projekt kräver att användarna beviljas åtkomst och autentiseras för att få åtkomst till tjänsterna.

För närvarande är det inte nödvändigt att ändra någon av dessa inställningar i den här modulen. För dina personliga projekt måste du dock fastställa den synlighet och åtkomst som du vill bevilja andra. Om projektet till exempel är öppen källkod kan du välja att göra både din GitHub-lagringsplats och ditt Azure DevOps-projekt offentligt. Om projektet är proprietärt skulle du vanligtvis göra både din GitHub-lagringsplats och ditt Azure DevOps-projekt privata.

Senare kan följande resurser vara användbara för att avgöra vilket alternativ som är bäst för projektet:

• Använda privata och offentliga projekt
• Ändra projektsynlighet till offentlig eller privat
• Ange synlighet för lagringsplats

Flytta arbetsuppgiften till Doing (Utför nu)

I det här avsnittet tilldelar du ett arbetsobjekt till dig själv som relaterar till den här modulen i Azure Boards. Du flyttar också arbetsobjektet till tillståndet Doing. I praktiken skulle du och ditt team skapa arbetsobjekt i början av varje sprint eller arbetst iteration.

Genom att tilldela arbete på det här sättet får du en checklista som du kan arbeta från. Listan ger andra i teamet en inblick i vad du arbetar med och hur mycket arbete som finns kvar att göra. Det hjälper också teamet att framtvinga pågående begränsningar så att teamet inte tar på sig för mycket arbete samtidigt.

Kom ihåg att teamet löste de här sju viktigaste problemen:

Här flyttar du det sjätte objektet, Flytta modelldata till ett eget paket till kolumnen Doing (Gör ) och tilldelar dig själv till arbetsobjektet.

Kom ihåg att Flytta modelldata till ett eget paket handlar om att flytta återanvändbar kod till ett eget NuGet-paket, så att paketet kan delas mellan flera appar.

Så här konfigurerar du arbetsobjektet:

1. Från Azure DevOps går du till Boards och väljer Tavlor från menyn.

   

2. Från Flytta modelldata till ett eget paketarbetsobjekt väljer du nedåtpilen längst ned på kortet och tilldelar sedan arbetsobjektet till dig själv.

   

3. Flytta arbetsobjektet från kolumnen Att göra till Gör.

   

När du har slutfört uppgiften i slutet av den här modulen flyttar du kortet till kolumnen Klar .

Konfigurera projektet lokalt

Här läser du in Space Game-projektet i Visual Studio Code, konfigurerar Git, klonar lagringsplatsen lokalt och konfigurerar den överordnade fjärrplatsen så att du kan ladda ned startkoden.

Öppna den integrerade terminalen

Visual Studio Code levereras med en integrerad terminal, så att du kan redigera filer och arbeta från kommandoraden på ett och samma ställe.

1. Starta Visual Studio Code.

2. På menyn Visa väljer du Terminal.

3. I listrutan väljer du bash. Om du är bekant med ett annat Unix-gränssnitt som du föredrar att använda, till exempel Zsh, väljer du gränssnittet i stället.

   

   Med terminalfönstret kan du välja valfritt gränssnitt som är installerat på systemet, till exempel Bash, Zsh och PowerShell.

   Här använder du Bash. Git för Windows tillhandahåller Git Bash, vilket gör det enkelt att köra Git-kommandon.

   Kommentar

   Om du inte ser Git Bash som ett alternativ i Windows kontrollerar du att du har installerat Git och startar sedan om Visual Studio Code.

4. cd Kör kommandot för att navigera till den katalog som du vill arbeta från, till exempel din hemkatalog (~). Du kan välja en annan katalog om du vill.

   cd ~
   

Konfigurera Git

Om du är nybörjare på Git och GitHub måste du först köra några kommandon för att associera din identitet med Git och autentisera med GitHub.

Konfigurera Git förklarar processen mer detaljerat.

Du måste minst utföra följande steg. Kör dessa kommandon från den integrerade terminalen:

1. Ange ditt användarnamn.
2. Ange din inchecknings-e-postadress.
3. Cachera ditt GitHub-lösenord.

Konfigurera projektet i Visual Studio Code

I den här delen klonar du din förgrening lokalt så att du kan göra ändringar och bygga ut din pipelinekonfiguration.

Klona förgreningen lokalt

Nu har du en kopia av Space Game-webbprojektet i ditt GitHub-konto. Nu ska du ladda ned eller klona en kopia till datorn så att du kan arbeta med den.

En klon, precis som en förgrening, är en kopia av en lagringsplats. När du klonar en lagringsplats kan du göra ändringar, verifiera att de fungerar som förväntat och sedan ladda upp ändringarna tillbaka till GitHub. Du kan även synkronisera din lokala kopia med ändringar som andra autentiserade användare har gjort till GitHub-kopian av din lagringsplats.

Så här klonar du space game-webbprojektet till datorn:

1. Gå till din fork av Space Game-webbprojektet (mslearn-tailspin-spacegame-web) på GitHub.

2. Välj Kod. På fliken HTTPS väljer du sedan knappen bredvid den URL som visas för att kopiera URL:en till Urklipp.

   

3. I Visual Studio Code går du till terminalfönstret.

4. I terminalen går du till den katalog som du vill arbeta från, till exempel din hemkatalog (~). Du kan välja en annan katalog om du vill.

   cd ~
   

5. Kör kommandot git clone. Ersätt url:en som visas här med innehållet i Urklipp:

   git clone https://github.com/your-name/mslearn-tailspin-spacegame-web.git
   

6. Gå till katalogen mslearn-tailspin-spacegame-web. Det är rotkatalogen för din lagringsplats.

   cd mslearn-tailspin-spacegame-web
   

Ange överordnad fjärrplats

En fjärranslutning är en Git-lagringsplats där teammedlemmar samarbetar (till exempel en lagringsplats på GitHub). Här visar du en lista över dina fjärrplatser och lägger till en fjärranslutning som pekar på Microsofts kopia av lagringsplatsen så att du kan hämta den senaste exempelkoden.

1. Kör det här git remote kommandot för att visa en lista över dina fjärranslutningar:

   git remote -v
   

   Du ser att du både har hämta (ladda ned) och push-överför åtkomst till lagringsplatsen:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   

   Origin anger lagringsplatsen på GitHub. När du förgrenar kod från en annan lagringsplats är det vanligt att namnge den ursprungliga fjärrplatsen (den som du förgrenade från) som uppströms.

2. Kör det här git remote add kommandot för att skapa en fjärranslutning med namnet upstream som pekar på Microsoft-lagringsplatsen:

   git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
   

3. Kör git remote en andra gång för att se ändringarna:

   git remote -v
   

   Du ser du fortfarande har åtkomst både till att hämta (ladda ned) och skicka (ladda upp) för din lagringsplats. Nu har du även hämtnings- och push-åtkomst till Microsoft-lagringsplatsen:

   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (fetch)
   origin  https://github.com/username/mslearn-tailspin-spacegame-web.git (push)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (fetch)
   upstream        https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git (push)
   

Öppna projektet i Utforskaren

I Visual Studio Code pekar terminalfönstret på rotkatalogen för webbprojektet Space Game . Om du vill visa dess struktur och arbeta med filer öppnar du projektet från utforskaren.

1. Det enklaste sättet att öppna projektet är att öppna Visual Studio Code igen i den aktuella katalogen. Det gör du genom att köra följande kommando från den integrerade terminalen:

   code -r .
   

   Du kan se katalogen och filträdet i Utforskaren.

2. Öppna den integrerade terminalen igen. Terminalen placerar dig i roten för ditt webbprojekt.

Om kommandot code misslyckas måste du lägga till Visual Studio Code i systemsökvägen. Så här gör du:

1. I Visual Studio Code väljer du F1 eller väljer Visa>kommandopalett för att komma åt kommandopaletten.
2. I kommandopaletten anger du Shell-kommandot: Installera kommandot "code" i PATH.
3. Upprepa föregående procedur för att öppna projektet i utforskaren.

Du har nu konfigurerats för att arbeta med Space Game-källkoden och din Azure Pipelines-konfiguration från din lokala utvecklingsmiljö.