Övning – Hämta exempelprogrammet

Slutförd

Gör dig redo att börja skapa en CI-pipeline med Microsoft Azure Pipelines. Det första steget är att skapa och köra webbappen Space Game . Om du förstår hur du skapar programvara manuellt förbereder du dig för att upprepa processen i pipelinen.

Mara kommer att göra exakt det, och genom att följa procedurerna kan du göra samma sak.

Skapa en personlig åtkomsttoken för Azure DevOps

  1. Logga in på din organisation (https://dev.azure.com/{yourorganization}). Om du inte redan har en Azure DevOps-organisation skapar du en kostnadsfri organisation innan du börjar. När du har loggat in väljer du Azure DevOps om du har fler än en organisation och går till den organisation som du planerar att använda för att slutföra den här modulen. I det här exemplet är fabrikamnamnet på organisationen .

    Screenshot of choosing your Azure DevOps organization.Skärmbild av hur du väljer din Azure DevOps-organisation.

  2. På startsidan öppnar du användarinställningar och väljer Personliga åtkomsttoken.

  3. Välj + Ny token.

  4. Namnge din token med valfritt namn som du föredrar. Token används när Codespace registrerar sin agent med din Azure DevOps-organisation, så att du kan behålla standardförfallotiden.

  5. Välj Anpassad definierad och välj Visa alla omfång.

    Screenshot of viewing all scopes for a personal access token.Skärmbild av att visa alla omfång för en personlig åtkomsttoken.

  6. Välj följande omfång: Agentpooler (Läs och hantera)och välj Skapa.

    Screenshot of selecting agent pool permissions for a personal access token.Skärmbild av val av behörigheter för agentpooler för en personlig åtkomsttoken.

  7. När du är klar kopierar du token och lagrar den på en säker plats. För din säkerhet visas den inte igen.

Varning

Behandla och använd en PAT som ditt lösenord och håll det hemligt.

Skapa en förgrening

Det första steget för att använda ett projekt i Git är att skapa en förgrening så att du kan arbeta med och ändra källfilerna. En förgrening är en kopia av en GitHub-lagringsplats. Kopian finns i ditt konto och gör att du kan göra de ändringar du vill utan att påverka det ursprungliga projektet.

Även om du kan föreslå ändringar i det ursprungliga projektet arbetar du i den här lektionen med space game-webbprojektet som om det vore det ursprungliga projektet som ägdes av Mara och teamet.

Kommentar

Om du tidigare har förgrenat den här lagringsplatsen, till exempel om du tidigare har slutfört den här modulen eller en annan Tailspin Toys-träningsmodul, rekommenderar vi att du tar bort din förgrening och skapar en ny förgrening med hjälp av följande steg. Om du inte vill ta bort din förgrening kontrollerar du att du synkroniserar din förgrening.

Nu ska vi förgrena Space Game-webbprojektet till ditt GitHub-konto:

  1. I en webbläsare går du till GitHub och loggar in.

  2. Gå till webbprojektet Space Game .

  3. Markera Förgreningen:

    Screenshot of GitHub showing the location of the Fork button.Skärmbild av GitHub som visar platsen för knappen Förgrening.

  4. Följ anvisningarna för att förgrena lagringsplatsen till ditt konto.

Konfigurera hemligheter för lokalt installerad agent

Innan du skapar ditt Codespace skapar du flera hemligheter som hjälper din lokala Azure DevOps-agent att köra. I produktion vill du inte använda en lokalt installerad agent i GitHub Codespaces. Men eftersom ditt team använder Codespaces för testning är det en bra tillfällig lösning att använda den när du skapar dina pipelines.

  1. Gå till din förgrenade GitHub-lagringsplats och välj Inställningar>Hemligheter och variabler>Codespaces.

    Screenshot of GitHub Codespaces secrets. Skärmbild av GitHub Codespaces-hemligheter.

  2. Skapa följande codespaces-lagringsplatshemligheter.

    Name Värde
    ADO_ORG Namnet på den Azure DevOps-organisation som du använder för att slutföra den här modulen. I det här exemplet fabrikam är namnet på organisationen. Det här organisationsnamnet måste vara samma som du använde när du skapade din PAT i föregående steg.
    ADO_PAT Den personliga åtkomsttoken som du skapade i föregående steg.

    Dricks

    I den här utbildningsmodulen tilldelas agenten till agentpoolen Default . Om du inte vill köra din agent i Default poolen (till exempel om du kör den här träningsmodulen med din Azure DevOps-produktionsmiljö och du har andra agenter i Default poolen) kan du skapa en hemlighet med namnet ADO_POOL_NAME och ange namnet på agentpoolen som ska användas. Om den här hemligheten Default inte har angetts används poolen.

Konfigurera codespaces

Därefter konfigurerar du Codespaces så att du kan skapa webbplatsen, arbeta med källfiler och köra din pipeline med hjälp av en lokalt installerad agent.

  1. I din förgrenade GitHub-lagringsplats väljer du Kod, väljer Kod igen, väljer fliken Codespaces och väljer + att skapa ett nytt kodområde.

    Screenshot of create a new Codespace with options. Skärmbild av att skapa ett nytt Codespace med alternativ.

  2. Vänta tills kodområdet har skapats. Den här versionen kan ta en stund, men du behöver bara göra det en gång i det här steget i träningsmodulen.

    När bygget är klart omdirigeras du till en onlineversion av Visual Studio Code. Ditt Codespace levereras med en ny installation av Visual Studio Code, ungefär som en ny installation av Visual Studio Code på den lokala datorn. När Codespace startar kan Visual Studio Code online uppmana dig att ange vissa konfigurationer eller fråga dig om inställningar. Du kan välja de inställningar som passar din Visual Studio Code-användningsstil.

Ange överordnad fjärrplats

En fjärranslutning är en Git-lagringsplats där teammedlemmar samarbetar (ungefär som en lagringsplats på GitHub). Nu ska vi lista dina fjärrplatser och lägga till en fjärranslutning som pekar på Microsofts kopia av lagringsplatsen så att du kan hämta den senaste exempelkoden.

  1. I Visual Studio Code-onlineredigeraren går du till terminalfönstret och väljer bash till höger.

    Screenshot of terminal window in Visual Studio Code online editor. Skärmbild av terminalfönstret i Visual Studio Code onlineredigeraren.

  2. Kör kommandot för git remote att visa en lista över dina fjärrdatorer:

    git remote -v
    

    Du har både hämta (ladda ned) och skicka (ladda upp) å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) uppströms.

  3. Om du vill skapa en fjärranslutning med namnet upstream som pekar på Microsoft-lagringsplatsen kör du det här git remote add kommandot:

    git remote add upstream https://github.com/MicrosoftDocs/mslearn-tailspin-spacegame-web.git
    
  4. 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)
    

Skapa och köra webbappen

  1. I Visual Studio Code-onlineredigeraren navigerar du till terminalfönstret och kör följande dotnet build kommando för att skapa appen:

    dotnet build --configuration Release
    
  2. Kör det här dotnet run kommandot från terminalfönstret för att köra appen:

    dotnet run --configuration Release --no-build --project Tailspin.SpaceGame.Web
    

    .NET-lösningsfiler kan innehålla mer än ett projekt. Argumentet --project anger projektet för Space Game-webbappen.

Kontrollera att programmet körs

I utvecklingsläge är webbplatsen Space Game konfigurerad att köras på port 5000.

Du ser ett nytt meddelande i Visual Studio-redigeraren. Programmet som körs på port 5000 är tillgängligt. Välj Öppna i webbläsare för att gå till appen som körs.

Screenshot of port forwarding Codespaces message. Skärmbild av meddelande om portvidarebefordring av Codespaces.

I det nya webbläsarfönstret bör du se webbplatsen Space Game:

Screenshot of a web browser showing the Space Game web site.Skärmbild av en webbläsare som visar webbplatsen Space Game.

Du kan interagera med sidan, inklusive resultattavlan. När du väljer en spelares namn visas information om spelaren:

Screenshot of a web browser showing the Space Game leaderboard.Skärmbild av en webbläsare som visar space game-rankningslistan.

När du är klar går du tillbaka till terminalfönstret och stoppar appen som körs genom att välja Ctrl + C.

Förbereda Visual Studio Code

Börja med att konfigurera Visual Studio Code så att du kan skapa webbplatsen lokalt och arbeta med källfiler.

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:

    Screenshot of selecting the Bash shell in Visual Studio Code.Skärmbild av att välja Bash-gränssnittet i Visual Studio Code.

    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. Om du vill navigera till den katalog som du vill arbeta från, till exempel din hemkatalog (~), kör cd du kommandot . 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.

I Konfigurera Git förklaras processen närmare.

Du måste minst utföra följande steg. Kör dessa kommandon från den integrerade Terminalen i Visual Studio Code.

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

Kommentar

Om du redan använder tvåfaktorautentisering med GitHub skapar du en personlig åtkomsttoken och använder din token i stället för ditt lösenord när du uppmanas att göra det senare.

Behandla din åtkomsttoken som ett lösenord. Förvara den på en säker plats.

Hämta källkoden

Nu hämtar du källkoden från GitHub och konfigurerar Visual Studio Code så att du kan köra appen och arbeta med källkodsfiler.

Skapa en förgrening

Det första steget för att använda ett projekt i Git är att skapa en förgrening så att du kan arbeta med och ändra källfilerna. En förgrening är en kopia av en GitHub-lagringsplats. Kopian finns i ditt konto och gör att du kan göra de ändringar du vill utan att påverka det ursprungliga projektet.

Även om du kan föreslå ändringar i det ursprungliga projektet arbetar du i den här lektionen med space game-webbprojektet som om det vore det ursprungliga projektet som ägdes av Mara och teamet.

Nu ska vi förgrena Space Game-webbprojektet till ditt GitHub-konto:

  1. I en webbläsare går du till GitHub och loggar in.

  2. Gå till webbprojektet Space Game .

  3. Markera Förgreningen:

    Screenshot of GitHub showing the location of the Fork button.Skärmbild av GitHub som visar platsen för knappen Förgrening.

  4. Följ anvisningarna för att förgrena lagringsplatsen till ditt konto.

Klona förgreningen lokalt

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

En klon, 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 också synkronisera din lokala kopia med ändringar som gjorts av andra autentiserade användare i GitHubs kopia av lagringsplatsen.

Så här klonar du Space Game-webbprojektet till datorn:

  1. Gå till din förgrening av Space Game-webbprojektet på GitHub.

  2. I kommandofältet väljer du Kod. I ett fönster visas alternativet Klona med flikar för typer av kloning. På fliken HTTPS väljer du kopieringsikonen bredvid URL:en för att kopiera URL:en till Urklipp.

    Screenshot of locating the URL and copy button from the GitHub repository.Skärmbild av att hitta URL:en och kopiera knappen från GitHub-lagringsplatsen.

  3. I Visual Studio Code går du till terminalfönstret och anger git cloneoch klistrar sedan in URL:en från Urklipp. Den bör se ut ungefär så här:

    git clone https://github.com/username/mslearn-tailspin-spacegame-web.git
    
  4. När åtgärden Cloning 'mslearn-tailspin-spacegame-web'... är klar anger du följande kommando för att ändra till mslearn-tailspin-spacegame-webkatalogen. Rotkatalogen för lagringsplatsen.

    cd mslearn-tailspin-spacegame-web
    

Ange överordnad fjärrplats

En fjärranslutning är en Git-lagringsplats där teammedlemmar samarbetar (ungefär som en lagringsplats på GitHub). Nu ska vi lista dina fjärrplatser och lägga till en fjärranslutning som pekar på Microsofts kopia av lagringsplatsen så att du kan hämta den senaste exempelkoden.

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

    git remote -v
    

    Du har både hämta (ladda ned) och skicka (ladda upp) å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) uppströms.

  2. Om du vill skapa en fjärranslutning med namnet upstream som pekar på Microsoft-lagringsplatsen kör du det här git remote add kommandot:

    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 till rotkatalogen för Space Game-webbprojektet. Nu ska vi öppna projektet för att visa dess struktur och arbeta med filer.

  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.

Skapa och köra webbappen

Nu när du har webbappen kan du skapa och köra den lokalt.

  1. I Visual Studio Code navigerar du till terminalfönstret och kör följande dotnet build kommando för att skapa appen:

    dotnet build --configuration Release
    

    Kommentar

    dotnet Om kommandot inte hittas granskar du förutsättningarna i början av den här modulen. Du kan behöva installera .NET SDK.

    .NET-projekt levereras vanligtvis med två byggkonfigurationer: Felsökning och version. Felsökningsversioner är inte optimerade för prestanda. De gör det enklare för dig att spåra genom ditt program och felsöka problem. Här väljer du versionskonfigurationen bara för att se webbappen i praktiken.

  2. Kör det här dotnet run kommandot från terminalfönstret för att köra appen:

    dotnet run --configuration Release --no-build --project Tailspin.SpaceGame.Web
    

    .NET-lösningsfiler kan innehålla mer än ett projekt. Argumentet --project anger projektet för Space Game-webbappen.

Kontrollera att programmet körs

I utvecklingsläge är webbplatsen Space Game konfigurerad att köras på port 5000.

Från en ny webbläsarflik går du till för att http://localhost:5000 se appen som körs:

Screenshot of a web browser showing the Space Game web site.Skärmbild av en webbläsare som visar webbplatsen Space Game.

Dricks

Om du ser ett fel i webbläsaren som är relaterat till ett sekretess- eller certifikatfel väljer du Ctrl + C från terminalen för att stoppa appen som körs.

Kör sedan dotnet dev-certs https --trust och välj Ja när du uppmanas att göra det. Mer information finns i detta blogginlägg.

När datorn har förtroende för ditt lokala SSL-certifikat dotnet run kör du kommandot en andra gång och går till http://localhost:5000 från en ny webbläsarflik för att se appen som körs.

Du kan interagera med sidan, inklusive resultattavlan. När du väljer en spelares namn visas information om spelaren:

Screenshot of a web browser showing the Space Game leaderboard.Skärmbild av en webbläsare som visar space game-rankningslistan.

När du är klar går du tillbaka till terminalfönstret och stoppar appen som körs genom att välja Ctrl+C.