Sestavování, testování a nasazování aplikací .NET Core

Přihlášení k Azure Pipelines

Přihlaste se k Azure Pipelines. po přihlášení se v prohlížeči přejde na https://dev.azure.com/my-organization-name a zobrazí váš řídicí panel Azure DevOps.

V rámci vybrané organizace vytvořte projekt. Pokud ve vaší organizaci nemáte žádné projekty, zobrazí se obrazovka vytvořit projekt pro začátek. v opačném případě vyberte v pravém horním rohu řídicího panelu tlačítko vytvořit Project .

1. přihlaste se ke svojí organizaci Azure DevOps a přejděte do svého projektu.

2. přejít na Pipelinesa pak vyberte nový kanál.

3. projděte si kroky průvodce, a to tak, že nejprve vyberete GitHub jako umístění vašeho zdrojového kódu.

4. možná budete přesměrováni na GitHub pro přihlášení. pokud ano, zadejte přihlašovací údaje pro GitHub.

5. Když se zobrazí seznam úložišť, vyberte své úložiště.

6. k instalaci aplikace Azure Pipelines můžete přesměrovat GitHub. Pokud ano, vyberte schválit instalaci.

Jakmile se zobrazí karta Konfigurovat , vyberte ASP.NET Core.

1. Po zobrazení nového kanálu se podívejte na YAML a podívejte se, co dělá. Až budete připraveni, vyberte Uložit a spustit.

   

2. Budete vyzváni k potvrzení nového souboru Azure-Pipelines. yml do úložiště. Až budete s touto zprávou spokojeni, vyberte Uložit a spustit znovu.

   Pokud chcete sledovat svůj kanál v akci, vyberte úlohu sestavení.

   právě jste vytvořili a spustili kanál, který jsme pro vás automaticky vytvořili, protože váš kód se zdá být dobrou shodou pro šablonu ASP.NET Core .

   Teď máte v úložišti pracovní YAML kanál ( azure-pipelines.yml ), který je připravený k přizpůsobení.

3. až budete připraveni udělat změny v kanálu, vyberte ji na stránce Pipelines a pak upravte soubor.

4. V následujících částech se dozvíte několik nejběžnějších způsobů přizpůsobení kanálu.

YAML

1. Přidejte azure-pipelines.yml soubor do úložiště. Přizpůsobení tohoto fragmentu kódu pro sestavení.

trigger:
- master

pool: Default

variables:
  buildConfiguration: 'Release'

# do this before all your .NET Core tasks
steps:
- task: DotNetCoreInstaller@2
  inputs:
    version: '2.2.402' # replace this value with the version that you need for your project
- script: dotnet build --configuration $(buildConfiguration)
  displayName: 'dotnet build $(buildConfiguration)'

2. Vytvořte kanál (Pokud si nejste jisti, jak si přečtěte téma Vytvoření prvního kanálu) a pro šablonu vyberte YAML.

3. Nastavte fond agentů a cestu k souboru YAML pro svůj kanál.

4. Uložte kanál a sestavte sestavení do fronty. Když se zobrazí zpráva sestavení #nnnnnnnn. n ve frontě , vyberte odkaz číslo, abyste viděli svůj kanál v akci.

5. Až budete připraveni udělat změny kanálu, upravte ho.

6. V následujících částech se dozvíte několik nejběžnějších způsobů přizpůsobení kanálu.

Klasický

1. Vytvoření kanálu (Pokud si nejste jisti, jak postupovat, najdete v tématu Vytvoření prvního kanálu). Vyberte pro šablonu prázdný kanál .

2. V katalogu úloh vyhledejte a přidejte úlohu .NET Core . Tato úloha se spustí dotnet build pro sestavení kódu v ukázkovém úložišti.

3. Uložte kanál a sestavte sestavení do fronty. Když se zobrazí zpráva sestavení #nnnnnnnn. n ve frontě , vyberte odkaz číslo, abyste viděli svůj kanál v akci.

   Teď máte pracovní kanál připravený k přizpůsobení!

4. Až budete připraveni udělat změny kanálu, upravte ho.

5. V následujících částech se dozvíte několik nejběžnějších způsobů přizpůsobení kanálu.

pomocí Azure Pipelines můžete sestavovat projekty .net Core v Windows, Linux nebo macOS, aniž byste museli nastavovat žádnou infrastrukturu sami. agenti hostovaná společností Microsoft v Azure Pipelines zahrnují několik vydaných verzí předinstalovaných sad .net Core sdk.

V souboru YAML se tady nastavuje Ubuntu 18,04.

pool:
  vmImage: 'ubuntu-18.04' # examples of other options: 'macOS-10.15', 'windows-2019'

Kompletní seznam imagí a fondů pro další příklady najdete v tématu agenti pro hostování Microsoftu .

Agenti hostující Microsoft neobsahují některé starší verze .NET Core SDK. Nezahrnují také předběžné verze. Pokud potřebujete tyto druhy sad SDK v agentech hostovaných Microsoftem, přidejte do souboru YAML úlohu UseDotNet@2 .

Chcete-li nainstalovat verzi Preview sady SDK 5.0. x pro sestavování a 3.0. x pro spouštění testů, které cílí na .NET Core 3.0. x, přidejte tento fragment kódu:

steps:
- task: UseDotNet@2
  inputs:
    version: '5.0.x'
    includePreviewVersions: true # Required for preview versions

- task: UseDotNet@2
  inputs:
    version: '3.0.x'
    packageType: runtime

agenti Windows už obsahují modul runtime .net Core. Pokud chcete nainstalovat novější sadu SDK, nastavte performMultiLevelLookup na true v tomto fragmentu kódu:

steps:
- task: UseDotNet@2
  displayName: 'Install .NET Core SDK'
  inputs:
    version: 5.0.x
    performMultiLevelLookup: true
    includePreviewVersions: true # Required for preview versions

projekty .net Core můžete sestavit pomocí .NET Core SDK a modulu runtime v Windows, Linux nebo macOS. Vaše sestavení běží na samoobslužném agentovi. Ujistěte se, že máte v agentu nainstalovanou potřebnou verzi .NET Core SDK a modulu runtime.

balíčky NuGet můžete stáhnout z Azure Artifacts, NuGet. org nebo z jiného externího nebo interního úložiště NuGet. úloha .net Core je obzvláště užitečná pro obnovení balíčků z ověřených informačních kanálů NuGet.

Tento kanál používá dotnet restore v dotnet restoreinformační kanál artefaktu.

trigger:
- master

pool:
  vmImage: 'windows-latest'

variables:
  buildConfiguration: 'Release'

steps:
- task: DotNetCoreCLI@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-vsts-feed' # A series of numbers and letters

- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    arguments: '--configuration $(buildConfiguration)'
  displayName: 'dotnet build $(buildConfiguration)'

balíčky NuGet můžete stáhnout z NuGet. org.

V .NET Core SDK verze 2,0 a novější se balíčky automaticky obnoví při spuštění dalších příkazů, jako je například dotnet build .

V .NET Core SDK verze 2,0 a novější se balíčky automaticky obnoví při spuštění dalších příkazů, jako je například dotnet build . Pokud ale používáte ověřený informační kanál, může být stále nutné použít úlohu .NET Core k obnovení balíčků.

pokud se vaše sestavení občas nezdaří při obnovení balíčků z NuGet. org z důvodu problémů s připojením, můžete použít Azure Artifacts u nadřazených zdrojů a ukládat balíčky do mezipaměti. Přihlašovací údaje kanálu se automaticky použijí při připojování k Azure Artifacts. tyto přihlašovací údaje jsou obvykle odvozené z účtu sestavovací služby Project Collection .

pokud chcete zadat úložiště NuGet, vložte adresy url do NuGet.config souboru v úložišti. pokud je váš informační kanál ověřený, spravujte jeho přihlašovací údaje vytvořením připojení služby NuGet na kartě služby v části Project Nastavení.

Pokud používáte agenty hostované Microsoftem, získáte nový počítač při každém spuštění sestavení, což znamená, že se balíčky obnovují pokaždé. Toto obnovení může trvat poměrně dlouhou dobu. pokud chcete tento problém zmírnit, můžete použít Azure Artifacts nebo samoobslužného agenta. v takovém případě získáte výhodu použití mezipaměti balíčku.

K obnovení balíčků z externího vlastního kanálu použijte úlohu .NET Core :

# do this before your build tasks
steps:
- task: DotNetCoreCLI@2
  displayName: Restore
  inputs:
    command: restore
    projects: '**/*.csproj'
    feedsToUse: config
    nugetConfigPath: NuGet.config    # Relative to root of the repository
    externalFeedCredentials: <Name of the NuGet service connection>
# ...

další informace o připojeních služby NuGet najdete v tématu publikování do NuGet kanálů.

1. Vyberte úkoly v kanálu. Vyberte úlohu, která spouští vaše úlohy sestavení. Pak vyberte + , chcete-li přidat nový úkol do této úlohy.

2. V katalogu úloh vyhledejte a přidejte úlohu .NET Core .

3. Vyberte úlohu a v příkazuvyberte obnovit.

4. Zadejte další možnosti, které pro tento úkol potřebujete. Pak sestavení uložte.

Pokud chcete projekt sestavit pomocí úlohy .NET Core, přidejte do souboru následující fragment azure-pipelines.yml kódu:

steps:
- task: DotNetCoreCLI@2
  displayName: Build
  inputs:
    command: build
    projects: '**/*.csproj'
    arguments: '--configuration $(buildConfiguration)' # Update this to match your need

Ve svém kanálu můžete spustit libovolný vlastní příkaz dotnet. Následující příklad ukazuje, jak nainstalovat a používat globální nástroj .NET dotnet pro:

steps:
- task: DotNetCoreCLI@2
  displayName: 'Install dotnetsay'
  inputs:
    command: custom
    custom: tool
    arguments: 'install -g dotnetsay'

Sestavení

1. V kanálu vyberte Tasks (Úlohy). Vyberte úlohu, která spouští úlohy sestavení. Potom vyberte + a přidejte do této úlohy nový úkol.

2. V katalogu úloh vyhledejte a přidejte úlohu .NET Core.

3. Vyberte úlohu a v možnosti Příkazvyberte build nebo publish.

4. Zadejte všechny další možnosti, které pro tuto úlohu potřebujete. Pak sestavení uložte.

Instalace nástroje

Pokud chcete do sestavení spuštěného v Windows nainstalovat globální nástroj .NET Core, jako je dotnet popisky , proveďte následující kroky:

1. Přidejte úlohu .NET Core a nastavte následující vlastnosti:

   • Příkaz: vlastní.
     • Cesta k projektům:Ponechte prázdnou hodnotu.
   • Vlastní příkaz: nástroj.
   • Argumenty: .

2. Přidejte úlohu příkazového řádku a nastavte následující vlastnosti:

   • Skript: .

Do souboru přidejte následující fragment azure-pipelines.yml kódu:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration)'

Alternativou je spustit příkaz dotnet test s konkrétním protokolovačem a pak použít úlohu dotnet test

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx
- task: PublishTestResults@2
  condition: succeededOrFailed()
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

K otestování použijte úlohu .NET Core s příkazemnastaveným na. Cesta k projektům by měla odkazovat na projekty testů ve vašem řešení.

Do souboru přidejte následující fragment azure-pipelines.yml kódu:

steps:
# ...
# do this after other tasks such as building
- task: DotNetCoreCLI@2
  inputs:
    command: test
    projects: '**/*Tests/*.csproj'
    arguments: '--configuration $(buildConfiguration) --collect "Code coverage"'

Pokud se rozhodnete spustit příkaz , zadejte protokolovací nástroj výsledků testu a dotnet test možnosti pokrytí. Pak použijte úlohu Publish Výsledky testů:

steps:
# ...
# do this after your tests have run
- script: dotnet test <test-project> --logger trx --collect "Code coverage"
- task: PublishTestResults@2
  inputs:
    testRunner: VSTest
    testResultsFiles: '**/*.trx'

1. Přidejte do úlohy sestavení úlohu .NET Core a nastavte následující vlastnosti:

   • Příkaz: test.
   • Cesta k projektům:Měl by odkazovat na projekty testů ve vašem řešení.
   • Argumenty: .

2. Ujistěte se, že zůstává vybraná možnost Publikovat výsledky testu.

Publikování artefaktů do Azure Pipelines

Pokud chcete publikovat výstup sestavení .NET,

• Spusťte dotnet publish --output $(Build.ArtifactStagingDirectory) v rozhraní příkazového řádku nebo přidejte DotNetCoreCLI@2 pomocí příkazu publish.
• Publikujte artefakt pomocí úlohy Publikovat artefakt.

Do souboru přidejte následující fragment azure-pipelines.yml kódu:

steps:

- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

# this code takes all the files in $(Build.ArtifactStagingDirectory) and uploads them as an artifact of your build.
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Build.ArtifactStagingDirectory)' 
    artifactName: 'myWebsiteName'

Pokud chcete zkopírovat více souborů do adresáře buildu před publikováním, použijte nástroj: kopírování souborů.

Publikování do NuGet kanálu

Pokud chcete vytvořit a publikovat NuGet, přidejte následující fragment kódu:

steps:
# ...
# do this near the end of your pipeline in most cases
- script: dotnet pack /p:PackageVersion=$(version)  # define version variable elsewhere in your pipeline
- task: NuGetAuthenticate@0
  input:
    nuGetServiceConnections: '<Name of the NuGet service connection>'
- task: NuGetCommand@2
  inputs:
    command: push
    nuGetFeedType: external
    publishFeedCredentials: '<Name of the NuGet service connection>'
    versioningScheme: byEnvVar
    versionEnvVar: version

Další informace o verzích a publikování balíčků NuGet najdete v tématu publikování do NuGet informačních kanálů.

Nasazení webové aplikace

Pokud chcete .zip souborový archiv, který je připravený k publikování do webové aplikace, přidejte následující fragment kódu:

steps:
# ...
# do this after you've built your app, near the end of your pipeline in most cases
# for example, you do this before you deploy to an Azure web app on Windows
- task: DotNetCoreCLI@2
  inputs:
    command: publish
    publishWebProjects: True
    arguments: '--configuration $(BuildConfiguration) --output $(Build.ArtifactStagingDirectory)'
    zipAfterPublish: True

Pokud chcete tento archiv publikovat do webové aplikace, podívejte se na Web Apps Azure.

Publikování artefaktů do Azure Pipelines

Pomocí úlohy publish Artifacts publikujte výstup sestavení do sady Azure Pipelines nebo TFS.

Publikování do NuGet kanálu

Pokud chcete publikovat kód do kanálu NuGet, postupujte následovně:

1. Použijte úlohu .NET Core s příkazem nastaveným na pack.

2. Publikujte balíček do informačního kanálu NuGet.

Nasazení webové aplikace

1. Použijte úlohu .NET Core s příkazem nastaveným na publikování.

2. Ujistěte se, že jste vybrali možnost pro vytvoření .zip souboru.

3. Pokud chcete tento archiv publikovat do webové aplikace, podívejte se na Web Apps Azure.

• Na agenty hostované Microsoftem neinstalujeme .NET Core SDK verze nástroje . Po vydání nové verze .NET Core SDK může trvat několik týdnů, než ji zavezeme do všech datových center, ve Azure Pipelines běží. Nemusíte čekat, až toto začáteční dokončíme. Pomocí instalačního programu nástrojů .NET Core, jak je vysvětleno v těchto pokynech, můžete nainstalovat požadovanou verzi .NET Core SDK na agenty hostované Microsoftem.

Začínáte Azure Pipelines? Pokud ano, doporučujeme před přechodem na jiné oddíly vyzkoušet tuto část.