Övning – Skapa en pipeline för ditt paket

6 minuter

Här får du teamets nya kod för projektet Tailspin.SpaceGame.Web.Models som nu är separat från projektet Tailspin.SpaceGame.Web . Du skapar ett Azure Pipelines-projekt för modellprojektet och ser artefakten i Azure Artifacts med versionsnumret 1.0.0 i din feed.

Vilka ändringar har gjorts i projektet?

Kom ihåg att Space Game-webbplatsen är en ASP.NET Core-app. Den använder MVC-mönstret (Model-View-Controller) för att skilja data från hur dessa data visas i användargränssnittet. Andy och Mara vill flytta modellklasserna till ett separat bibliotek så att de kan användas i flera projekt.

För att göra det skapar de ett nytt C#-projekt med namnet Tailspin.SpaceGame.Web.Models som endast innehåller modellklasserna. Samtidigt tar de bort modellklasserna från det befintliga projektet Tailspin.SpaceGame.Web. De ersätter modellklasserna i det befintliga projektet med en referens till projektet Tailspin.SpaceGame.Web.Models.

För att skapa dessa projekt använder Andy och Mara två pipelines, en för varje projekt. Du har redan det första projektet och dess associerade Azure Pipelines-konfiguration. Här förgrenar du det andra projektet på GitHub och skapar en Azure Pipelines-konfiguration för att skapa det. Du publicerar det resulterande paketet till Azure Artifacts.

Förbereda Visual Studio Code

Tidigare har du konfigurerat Visual Studio Code för att arbeta med projektet Tailspin.SpaceGame.Web . Här öppnar du en andra instans av Visual Studio Code så att du kan arbeta med projektet Tailspin.SpaceGame.Web.Models .

Öppna en andra instans av Visual Studio Code.
Öppna den integrerade terminalen i Visual Studio Code.
Gå till den överordnade katalogen där ditt mslearn-tailspin-spacegame-web-projekt finns. Här är ett exempel som flyttas till din hemkatalog:
```
cd ~
```

Hämta källkoden

Hämta källkoden för projektet Tailspin.SpaceGame.Web.Models från GitHub och konfigurera Visual Studio Code så att du kan arbeta med filerna.

Skapa en förgrening

Det första steget är att förgrena lagringsplatsen mslearn-tailspin-spacegame-web-models så att du kan arbeta med och ändra källfilerna. Kom ihåg att Mara placerade katalogen Models (Modeller) i ett nytt projekt och tog bort den från webbprojektet.

Så här förgrenar du projektet mslearn-tailspin-spacegame-web-models i ditt GitHub-konto:

Från en webbläsare går du till GitHub och loggar in.
Gå till projektet mslearn-tailspin-spacegame-web-models .
Markera Förgreningen.
Följ anvisningarna för att förgrena lagringsplatsen till ditt konto.

Klona förgreningen lokalt

Så här klonar du mslearn-tailspin-spacegame-web-models-projekten till datorn:

På GitHub går du till din förgrening av projektet mslearn-tailspin-spacegame-web-models .
Välj Kod. På fliken HTTPS väljer du sedan knappen bredvid den URL som visas för att kopiera URL:en till Urklipp.
Från Visual Studio Code går du till terminalfönstret och kör det här git clone kommandot. Ersätt den URL som visas med innehållet i Urklipp.
```
git clone https://github.com/your-name/mslearn-tailspin-spacegame-web-models.git
```
Flytta till katalogen mslearn-tailspin-spacegame-web-models . Det är rotkatalogen för din lagringsplats.
```
cd mslearn-tailspin-spacegame-web-models
```

Öppna projektet och undersöka konfigurationen

I Visual Studio Code pekar terminalfönstret på rotkatalogen för projektet mslearn-tailspin-spacegame-web-models . Öppna projektet från utforskaren så att du kan visa dess struktur och arbeta med filer.

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.
Öppna den integrerade terminalen igen. Terminalen placerar dig i roten för ditt webbprojekt.
Öppna filen azure-pipelines.yml.

Du ser stegen där paketet skapas, versionen anges och paketet läggs till i Azure Artifacts.

Den här DotNetCoreCLI@2-aktiviteten bygger projektet:
```
- task: DotNetCoreCLI@2
  displayName: 'Build the project - $(buildConfiguration)'
  inputs:
    command: 'build'
    arguments: '--no-restore --configuration $(buildConfiguration)'
    projects: '**/*.csproj'
```
Den här DotNetCoreCLI@2-aktiviteten paketerar projektet med version 1.0.0:
```
- task: DotNetCoreCLI@2
  displayName: 'Pack the project - $(buildConfiguration)'
  inputs:
    command: 'pack'
    projects: '**/*.csproj'
    arguments: '--no-build --configuration $(buildConfiguration)'
    versioningScheme: byPrereleaseNumber
    majorVersion: '1'
    minorVersion: '0'
    patchVersion: '0'
```
När du utvecklar ditt paket är det vanligt att använda byPrereleaseNumber-versionsschemat. Detta lägger till ett unikt pre-release-suffix, till exempel "-CI-20190621-042647" i slutet av versionsnumret. I det här exemplet skulle det fullständiga versionsnumret bli ”1.0.0-CI-20190621-042647”.

Den här NuGetCommand@2-aktiviteten push-överför paketet till din Tailspin.SpaceGame.Web.Models-feed i Azure Artifacts:
```
- task: NuGetCommand@2
  displayName: 'Publish NuGet package'
  inputs:
    command: push
    feedPublish: '$(System.TeamProject)/Tailspin.SpaceGame.Web.Models'
    allowPackageConflicts: true
  condition: succeeded()
```
feedPublish anger namnet på feeden som ska publiceras till. Namnets format är <projectName>/<feedName>, där:
- $(System.TeamProject) är en fördefinierad variabel som refererar till projektnamnet. till exempel "Space Game – web – Dependencies".
- Tailspin.SpaceGame.Web.Models är det flödesnamn som du angav i föregående övning.

Ställa in behörigheter

Innan du kan konfigurera och köra pipelinen måste du ge build-tjänsten rätt behörigheter.

Gå till projektet i Azure DevOps.
Välj Artefakter på menyn till vänster.
Välj ikonen Inställningar längst upp till höger på skärmen och välj sedan fliken Behörigheter.
Välj knappen Lägg till användare/grupper.
I fältet Användare/grupper anger du Space Game – web – Dependencies Build Service, väljer rollen Deltagare och väljer Spara.

Skapa pipelinen i Azure Pipelines

Du har lärt dig hur du ställer in Azure Pipelines i en tidigare modul. Om du behöver en uppdatering går du till Skapa en byggpipeline med Azure Pipelines.

Så här konfigurerar du en andra pipeline för att skapa paketet och laddar upp paketet till Azure Artifacts.

Från Azure DevOps går du till projektet Space Game – web – Dependencies .
Välj Pipelines på menyn till vänster.
Välj Ny pipeline.
Välj GitHub på fliken Connect (Anslut).
På fliken Välj väljer du mslearn-tailspin-spacegame-web-models.

Ange dina GitHub-autentiseringsuppgifter om du uppmanas att göra det. På sidan som visas bläddrar du längst ned och väljer Godkänn och installera.
Den nya pipelinens azure-pipelines.yml-fil visas på fliken Review (Granska).
Markera Kör.
Se pipelinekörningen.
Gå till fliken Artefakter .
I listrutan längst upp väljer du Tailspin.SpaceGame.Web.Models.

Det resulterande paketet, Tailspin.SpaceGame.Web.Models, visas i Azure Artifacts.
Välj paketet för att gå till informationssidan. Kopiera sedan versionsnumret till en plats där du enkelt kan komma åt det senare.

Du använder det här versionsnumret i nästa lektion.