Erstellen ASP.NET Apps mit .NET Framework

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019 | TFS 2018

Hinweis

In Microsoft Team Foundation Server (TFS) 2018 und früheren Versionen werden Build- und Release-Pipelines als Definitionen bezeichnet, Ausführungen werden als Builds bezeichnet, Dienstverbindungen werden als Dienstendpunkte bezeichnet, Stages werden als Umgebungen bezeichnet und Aufträge werden als Phasen bezeichnet.

Hinweis

Dieser Artikel konzentriert sich auf das Erstellen .NET Framework Projekte mit Azure Pipelines. Hilfe zu .NET Core-Projekten finden Sie unter .NET Core.

Erstellen Ihrer ersten Pipeline

Sind Sie neu bei Azure-Pipelines? Wenn dies der Fall ist, empfehlen wir Ihnen, diesen Abschnitt zu versuchen, bevor Sie zu anderen Abschnitten wechseln.

Beziehen des Codes

Fork the following repo at GitHub:

Importieren Sie dieses Repo in Ihr Git-Repo in Azure DevOps Server 2019:

Importieren Sie dieses Repo in Ihr Git-Repo in TFS:

https://github.com/Microsoft/devops-project-samples.git

Das Beispiel-Repo enthält mehrere verschiedene Projekte, und die Beispielanwendung für diesen Artikel befindet sich unter:

https://github.com/Microsoft/devops-project-samples

Sie verwenden den Code in /dotnet/aspnet/webapp/. Ihre azure-pipelines.yml Datei muss innerhalb des Ordners ausgeführt werden, damit der dotnet/aspnet/webapp/Application Build erfolgreich abgeschlossen wird.

Die Beispiel-App ist eine Visual Studio-Lösung mit zwei Projekten:

  • Ein ASP.NET Webanwendungsprojekt, das auf .NET Framework 4.5 ausgerichtet ist
  • Projekt "Einheitstest"

Anmelden bei Azure Pipelines

Melden Sie sich bei Azure-Pipelines an. Nach der Anmeldung wechselt Ihr Browser zu https://dev.azure.com/my-organization-name und zeigt Ihr Azure DevOps-Dashboard an.

Erstellen Sie in Ihrer ausgewählten Organisation ein Projekt. Sollten in Ihrer Organisation noch keine Projekte vorhanden sein, wird der Bildschirm Erstellen Sie als ersten Schritt ein Projekt. angezeigt. Wählen Sie andernfalls die Schaltfläche "Neues Projekt " in der oberen rechten Ecke des Dashboards aus.

Hinweis

Dieses Szenario funktioniert auf TFS, aber einige der folgenden Anweisungen entsprechen möglicherweise nicht genau der Version von TFS, die Sie verwenden. Außerdem müssen Sie einen selbst gehosteten Agent einrichten, möglicherweise auch Software installieren. Wenn Sie ein neuer Benutzer sind, haben Sie möglicherweise eine bessere Lernerfahrung, indem Sie diese Prozedur zuerst mithilfe einer kostenlosen Azure DevOps-Organisation ausprobieren. Ändern Sie dann den Auswahlgeber in der oberen linken Ecke dieser Seite von Team Foundation Server in Azure DevOps.

  • Nachdem Sie über den Beispielcode in Ihrem eigenen Repository verfügen, erstellen Sie eine Pipeline mithilfe der Anweisungen in der ersten Pipeline erstellen und die ASP.NET Vorlage auswählen. Dadurch werden automatisch die Aufgaben hinzugefügt, die zum Erstellen des Codes im Beispiel-Repository erforderlich sind.

  • Speichern Sie die Pipeline und Warteschlange, um es in Aktion anzuzeigen.

Buildumgebung

Sie können Azure-Pipelines verwenden, um Ihre .NET Framework Projekte zu erstellen, ohne eine eigene Infrastruktur einzurichten. Die von Microsoft gehosteten Agents in Azure Pipelines verfügen über mehrere freigegebene Versionen von Visual Studio, um Ihnen beim Erstellen Ihrer Projekte zu helfen.

  • Verwenden windows-2019 von Windows Server 2019 mit Visual Studio 2019

Sie können auch einen selbst gehosteten Agent verwenden, um Ihre Builds auszuführen. Dies ist hilfreich, wenn Sie über ein großes Repository verfügen und den Quellcode nicht auf einen neuen Computer für jeden Build herunterladen möchten.

Ihre Builds werden auf einem selbst gehosteten Agent ausgeführt. Stellen Sie sicher, dass Sie die erforderliche Version des Visual Studio auf dem Agent installiert haben.

Erstellen mehrerer Konfigurationen

Es ist oft erforderlich, Ihre App in mehreren Konfigurationen zu erstellen. Die folgenden Schritte erweitern das obige Beispiel, um die App auf vier Konfigurationen zu erstellen: [Debug, x86], [Debug, x64], [Release, x86], [Release, x64].

  1. Klicken Sie auf die Registerkarte "Variablen ", und ändern Sie diese Variablen:

    • BuildConfiguration = debug, release
    • BuildPlatform = x86, x64
  2. Wählen Sie Aufgaben aus, und klicken Sie auf den Agentauftrag , um die Optionen für den Auftrag zu ändern:

    • Wählen Sie "Multikonfiguration" aus.
    • Geben Sie Multiplizierer an:BuildConfiguration, BuildPlatform
  3. Wählen Sie Parallel aus, wenn Sie über mehrere Build-Agents verfügen und parallel Ihre Konfigurations-/Plattformpaare erstellen möchten.

Wiederherstellen von Abhängigkeiten

Sie können die NuGet-Aufgabe verwenden, um NuGet-Paketabhängigkeiten zu installieren und zu aktualisieren. Sie können NuGet-Pakete auch aus Azure-Artefakten, NuGet.org oder einem anderen externen oder internen NuGet-Repository mit der NuGet-Aufgabe herunterladen.

Dieser Code stellt eine Lösung aus einem projektbezogenen Feed in derselben Organisation wiederhergestellt.

# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    vstsFeed: 'my-project/my-project-scoped-feed'
    includeNuGetOrg: false
    restoreSolution: '**/*.sln'