Vytváření ASP.NET aplikací pomocí rozhraní .NET Framework

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Tento článek popisuje, jak vytvořit projekt rozhraní .NET Framework pomocí Azure Pipelines. Projekty .NET Core najdete v tématu Sestavení, testování a nasazení aplikací .NET Core.

Vytvoření projektu Azure DevOps

  1. V organizaci nebo kolekci Azure DevOps vyberte Nový projekt nebo Vytvořit projekt.
  2. Zadejte název projektu.
  3. Vyberte viditelnost projektu.
  4. Vyberte Vytvořit.

Získání ukázkové aplikace

Ukázková aplikace je řešení sady Visual Studio, které používá .NET 4.8. Aplikaci získáte forkem úložiště GitHub na adrese:

https://github.com/Azure-Samples/app-service-web-dotnet-get-started

Vytvoření a sestavení kanálu

Jakmile budete mít ukázkový kód ve vlastním úložišti, vytvořte v projektu Azure DevOps kanál pomocí pokynů v části Vytvoření prvního kanálu.

Vyberte šablonu ASP.NET. Tato volba automaticky přidá soubor azure-pipelines.yml s úlohami potřebnými k sestavení kódu do ukázkového úložiště. Šablona obsahuje VSTest@2 úlohu ke spuštění testů. Ukázkové úložiště neobsahuje testy, takže můžete z kanálu odebrat VSTest@2 úlohu.

Kanál by měl vypadat jako v následujícím příkladu:

# ASP.NET
# Build and test ASP.NET projects.
# Add steps that publish symbols, save build artifacts, deploy, and more:
# https://docs.microsoft.com/azure/devops/pipelines/apps/aspnet/build-aspnet-4

trigger:
- main

pool:
  vmImage: 'windows-latest'

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

# ASP.NET
# Build and test ASP.NET projects.
# Add steps that publish symbols, save build artifacts, deploy, and more:
# https://docs.microsoft.com/azure/devops/pipelines/apps/aspnet/build-aspnet-4

trigger:
- main

pool: 
  name: default

variables:
  solution: '**/*.sln'
  buildPlatform: 'Any CPU'
  buildConfiguration: 'Release'

steps:
- task: NuGetToolInstaller@1

- task: NuGetCommand@2
  inputs:
    restoreSolution: '$(solution)'

- task: VSBuild@1
  inputs:
    solution: '$(solution)'
    msbuildArgs: '/p:DeployOnBuild=true /p:WebPublishMethod=Package /p:PackageAsSingleFile=true /p:SkipInvalidConfigurations=true /p:PackageLocation="$(build.artifactStagingDirectory)"'
    platform: '$(buildPlatform)'
    configuration: '$(buildConfiguration)'

Výběrem možnosti Uložit a spustit a výběrem možnosti Úlohy zobrazíte kanál v akci.

Pokud chcete publikovat artefakty sestavení, přidejte na konec souboru YAML následující úlohu:

- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)'
    artifact: 'myartifact'
    publishLocation: 'pipeline'

- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(Build.ArtifactStagingDirectory)'
    artifactName: drop

Sestavení prostředí

Azure Pipelines můžete použít k sestavení projektů rozhraní .NET Framework, aniž byste museli nastavovat vlastní infrastrukturu. Agenti hostovaní Microsoftem v Azure Pipelines mají několik vydaných verzí sady Visual Studio, které vám pomůžou sestavovat projekty. Používá se windows-2022 pro Windows Server 2022 se sadou Visual Studio 2022.

Ke spuštění sestavení můžete použít také agenta v místním prostředí. Použití místního agenta je užitečné, pokud máte velké úložiště a chcete se vyhnout stahování zdrojového kódu na nový počítač pro každé sestavení.

Vaše sestavení běží na místním agentu. Ujistěte se, že máte v agentu nainstalovanou potřebnou verzi sady Visual Studio.

Sestavení více konfigurací

Možná budete muset vytvořit aplikaci v několika konfiguracích. Následující kroky sestaví ukázkové aplikace ve čtyřech konfiguracích: Debug, x86, Debug, x64, Release, x86a Release, x64.

  1. V uživatelském rozhraní kanálu vyberte kartu Proměnné a upravte následující proměnné:

    • BuildConfiguration = debug, release
    • BuildPlatform = x86, x64
  2. Vyberte Úlohy a pak vyberte úlohu agenta, abyste změnili následující možnosti úlohy:

    • Vyberte vícenásobnou konfiguraci.
    • Určení násobitelů: BuildConfiguration, BuildPlatform
  3. Pokud máte více agentů sestavení a chcete paralelně sestavovat párování konfigurace nebo platformy, vyberte Možnost Paralelní .

Obnovení závislostí

Úlohu NuGet můžete použít k instalaci a aktualizaci závislostí balíčků NuGet. Úlohu NuGet můžete použít také ke stažení balíčků NuGet z Azure Artifacts, NuGet.org nebo jiných externích nebo interních úložišť NuGet.

Následující příklad obnoví řešení z informačního kanálu s oborem projektu ve stejné organizaci.

- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'