DotNetCoreCLI@2 – .NET Core v2-Aufgabe

Erstellen, Testen, Verpacken oder Veröffentlichen einer .NET-Anwendung oder Ausführen eines benutzerdefinierten .NET CLI-Befehls.

Syntax

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    #azureSubscription: # string. Alias: ConnectedServiceName. Azure Resource Manager connection. 
    command: 'build' # 'build' | 'push' | 'pack' | 'publish' | 'restore' | 'run' | 'test' | 'custom'. Required. Command. Default: build.
    #publishWebProjects: true # boolean. Optional. Use when command = publish. Publish web projects. Default: true.
    #projects: # string. Optional. Use when command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false. Path to project(s) or solution(s). 
    #custom: # string. Required when command = custom. Custom command. 
    #arguments: # string. Optional. Use when command = build || command = publish || command = run || command = test || command = custom. Arguments. 
    #restoreArguments: # string. Optional. Use when command = restore. Arguments. 
    #publishTestResults: true # boolean. Optional. Use when command = test. Publish test results and code coverage. Default: true.
    #testRunTitle: # string. Optional. Use when command = test. Test run title. 
    #zipAfterPublish: true # boolean. Optional. Use when command = publish. Zip published projects. Default: true.
    #modifyOutputPath: true # boolean. Optional. Use when command = publish. Add project's folder name to publish path. Default: true.
    #packagesToPush: '$(Build.ArtifactStagingDirectory)/*.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/*.nupkg.
    #nuGetFeedType: 'internal' # 'internal' | 'external'. Required when command = push. Target feed location. Default: internal.
    #publishVstsFeed: # string. Alias: feedPublish. Required when command = push && nuGetFeedType = internal. Target feed. 
    #publishFeedCredentials: # string. Alias: externalEndpoint. Required when command = push && nuGetFeedType = external. NuGet server. 
    #packagesToPack: '**/*.csproj' # string. Alias: searchPatternPack. Required when command = pack. Path to csproj or nuspec file(s) to pack. Default: **/*.csproj.
    #configuration: '$(BuildConfiguration)' # string. Alias: configurationToPack. Optional. Use when command = pack. Configuration to Package. Default: $(BuildConfiguration).
    #packDirectory: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package Folder. Default: $(Build.ArtifactStagingDirectory).
    #nobuild: false # boolean. Optional. Use when command = pack. Do not build. Default: false.
    #includesymbols: false # boolean. Optional. Use when command = pack. Include Symbols. Default: false.
    #includesource: false # boolean. Optional. Use when command = pack. Include Source. Default: false.
    #requestTimeout: '300000' # string. Set timeout for package download request. Default: 300000.
  # Feeds and authentication
    #feedsToUse: 'select' # 'select' | 'config'. Alias: selectOrConfig. Required when command = restore. Feeds to use. Default: select.
    #vstsFeed: # string. Alias: feedRestore. Optional. Use when selectOrConfig = select && command = restore. Use packages from this Azure Artifacts feed. Select from the dropdown or enter [project name/]feed name. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select && command = restore. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config && command = restore. Path to NuGet.config. 
    #externalFeedCredentials: # string. Alias: externalEndpoints. Optional. Use when selectOrConfig = config && command = restore. Credentials for feeds outside this organization/collection. 
  # Advanced
    #noCache: false # boolean. Optional. Use when command = restore. Disable local cache. Default: false.
    #restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory. 
    #verbosityRestore: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Normal.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal && command = push. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
    #versionEnvVar: # string. Required when versioningScheme = byEnvVar && command = pack. Environment variable. 
    #majorVersion: '1' # string. Alias: requestedMajorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Major. Default: 1.
    #minorVersion: '0' # string. Alias: requestedMinorVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Minor. Default: 0.
    #patchVersion: '0' # string. Alias: requestedPatchVersion. Required when versioningScheme = byPrereleaseNumber && command = pack. Patch. Default: 0.
  # Advanced
    #buildProperties: # string. Optional. Use when command = pack. Additional build properties. 
    #verbosityPack: 'Normal' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Normal.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack && command != pack && command != push && command != restore. Working directory.

Eingänge

azureSubscription - Azure Resource Manager-Verbindung
Eingabealias: ConnectedServiceName. string.

Geben Sie eine Azure Resource Manager-Dienstverbindung an, die mit dem Workload-Identitätsverbund konfiguriert ist, um AzurePipelinesCredential- in Integrationstests zu verwenden. Weitere Informationen finden Sie unter Verwenden von AzurePipelinesCredential in Integrationstests.

Anmerkung

Diese Eingabe unterstützt nur ARM-Dienstverbindungen, die für die Verwendung des Workload-Identitätsverbunds konfiguriert sind.

command - Command
string. Erforderlich. Zulässige Werte: build, push (Nuget-Push), pack, publish, restore, run, test, custom. Standardwert: build.

Der auszuführende Dotnet-Befehl. Geben Sie custom an, um Argumente hinzuzufügen oder einen befehl zu verwenden, der hier nicht aufgeführt ist.

Wichtig

Die NuGet Authenticate Aufgabe ist die neue empfohlene Methode zum Authentifizieren mit Azure Artifacts und anderen NuGet-Repositorys. Die Befehle restore und push dieser .NET Core CLI-Aufgabe übernehmen keine neuen Features mehr, und nur wichtige Fehler werden behoben. Ausführliche Informationen finden Sie in den Hinweisen.

publishWebProjects - Webprojekte veröffentlichen
boolean. Wahlfrei. Wird verwendet, wenn command = publish. Standardwert: true.

Wenn diese Eingabe auf truefestgelegt ist, wird der wert der projects Eigenschaft übersprungen, und die Aufgabe versucht, die Webprojekte im Repository zu finden und den Veröffentlichungsbefehl darauf auszuführen. Webprojekte werden durch das Vorhandensein einer web.config Datei oder eines wwwroot Ordners im Verzeichnis identifiziert. Wenn keine web.config Datei oder ein wwwroot Ordner vorhanden ist, werden Projekte ausgewählt, die ein Web SDK wie Microsoft.NET.Sdk.Webverwenden.

projects - Pfad zu Projekt(en) oder Projektmappen
string. Wahlfrei. Wird verwendet, wenn command = build || command = restore || command = run || command = test || command = custom || publishWebProjects = false.

Der Pfad zur zu verwendenden .csproj- oder .sln-Datei(n). Sie können Wildcards (z. B. **/*.csproj für alle .csproj Dateien in allen Unterordnern) verwenden. Weitere Informationen finden Sie im Dateiabgleichsmuster.

Dieser Pfad ist relativ zum Stamm des Repositorys, unabhängig von der einstellung workingDirectory.

custom - benutzerdefinierten Befehl
string. Erforderlich, wenn command = custom.

Der Befehl, der zur Ausführung an dotnet.exe übergeben werden soll. Eine vollständige Liste der verfügbaren Befehle finden Sie in der dotnet CLI-Dokumentation.

arguments - Argumente
string. Wahlfrei. Wird verwendet, wenn command = build || command = publish || command = run || command = test || command = custom.

Gibt die Argumente für den ausgewählten Befehl an. Beispiel: Buildkonfiguration, Ausgabeordner und Laufzeit. Die Argumente hängen vom ausgewählten Befehl ab.

Diese Eingabe akzeptiert derzeit nur Argumente für build, publish, run, testund custom. Wenn Sie Argumente für einen nicht aufgeführten Befehl hinzufügen möchten, verwenden Sie custom.

restoreArguments - Argumente
string. Wahlfrei. Wird verwendet, wenn command = restore.

Schreibt die zusätzlichen Argumente, die an den Befehl restore übergeben werden sollen.

publishTestResults - Veröffentlichen von Testergebnissen und Codeabdeckung
boolean. Wahlfrei. Wird verwendet, wenn command = test. Standardwert: true.

Wenn Sie diese Option aktivieren, wird eine test results TRX-Datei in $(Agent.TempDirectory)generiert, und die Ergebnisse werden auf dem Server veröffentlicht.

Diese Option fügt --logger trx --results-directory $(Agent.TempDirectory) an die Befehlszeilenargumente an.

Die Codeabdeckung kann durch Hinzufügen der option --collect "Code coverage" zu den Befehlszeilenargumenten erfasst werden.

testRunTitle - Titel der Testausführung
string. Wahlfrei. Wird verwendet, wenn command = test.

Stellt einen Namen für die Testausführung bereit.

zipAfterPublish - veröffentlichten Projekte
boolean. Wahlfrei. Wird verwendet, wenn command = publish. Standardwert: true.

Wenn diese Eingabe auf truefestgelegt ist, werden vom Veröffentlichungsbefehl erstellte Ordner gezippt und gelöscht.

modifyOutputPath - Hinzufügen des Ordnernamens des Projekts zum Veröffentlichen des Pfads
boolean. Wahlfrei. Wird verwendet, wenn command = publish. Standardwert: true.

Wenn diese Eingabe auf truefestgelegt ist, werden ordner, die vom Veröffentlichungsbefehl erstellt wurden, dem Projektdateinamen vorangestellt, wenn der Ausgabepfad explizit in Argumenten angegeben wird. Dies ist nützlich, wenn Sie mehrere Projekte im selben Ordner veröffentlichen möchten.

feedsToUse - Feeds für die Verwendung von
Eingabealias: selectOrConfig. string. Erforderlich, wenn command = restore. Zulässige Werte: select (Feed(e) Ich wähle hier aus), config (Feeds in meinem NuGet.config). Standardwert: select.

Sie können entweder einen Feed aus Azure Artifacts und/oder NuGet.org hier auswählen, oder Sie können eine nuget.config Datei in Ihr Quellcode-Repository übernehmen und den Pfad mithilfe der nugetConfigPath Eingabe festlegen.

vstsFeed - Verwenden von Paketen aus diesem Azure Artifacts-Feed. Wählen Sie aus der Dropdownliste aus, oder geben Sie [Projektname/]Feedname ein.
Eingabealias: feedRestore. string. Wahlfrei. Wird verwendet, wenn selectOrConfig = select && command = restore.

Schließt den ausgewählten Feed in die generierte NuGet.configein. Sie müssen die Paketverwaltung installiert und lizenziert haben, um hier einen Feed auszuwählen. projectName / feedName werden für projektbezogene Feeds verwendet. Nur FeedName wird für Feeds mit Organisationsbereich verwendet. Hinweis: Dies wird für den Befehl test nicht unterstützt.

includeNuGetOrg - Verwenden von Paketen aus NuGet.org
boolean. Wahlfrei. Wird verwendet, wenn selectOrConfig = select && command = restore. Standardwert: true.

Enthält NuGet.org in die generierte NuGet.config.

nugetConfigPath - Pfad zu NuGet.config
string. Wahlfrei. Wird verwendet, wenn selectOrConfig = config && command = restore.

Der NuGet.config in Ihrem Repository, der die Feeds angibt, aus denen Pakete wiederhergestellt werden sollen.

externalFeedCredentials - Anmeldeinformationen für Feeds außerhalb dieser Organisation/Sammlung
Eingabealias: externalEndpoints. string. Wahlfrei. Wird verwendet, wenn selectOrConfig = config && command = restore.

Die Anmeldeinformationen, die für externe Register verwendet werden sollen, die sich in der ausgewählten NuGet.configbefinden. Lassen Sie diese Eingabe für Feeds in dieser Organisation/Sammlung leer; die Anmeldeinformationen des Builds werden automatisch verwendet.

noCache - Deaktivieren des lokalen Caches
boolean. Wahlfrei. Wird verwendet, wenn command = restore. Standardwert: false.

Verhindert, dass NuGet Pakete aus lokalen Computercaches verwendet.

restoreDirectory - Zielverzeichnis
Eingabealias: packagesDirectory. string. Wahlfrei. Wird verwendet, wenn command = restore.

Gibt den Ordner an, in dem Pakete installiert werden. Wenn kein Ordner angegeben ist, werden Pakete im Standardmäßigen NuGet-Paketcache wiederhergestellt.

verbosityRestore - Ausführlichkeit
string. Wahlfrei. Wird verwendet, wenn command = restore. Zulässige Werte: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Standardwert: Normal.

Gibt die Anzahl der Details an, die in der Ausgabe für den Befehl restore angezeigt werden.

packagesToPush - Pfad zu NuGet-Paketen zum Veröffentlichen von
Eingabealias: searchPatternPush. string. Erforderlich, wenn command = push. Standardwert: $(Build.ArtifactStagingDirectory)/*.nupkg.

Das Muster, das mit nupkg hochzuladenden Dateien übereinstimmt oder pfadet. Mehrere Muster können durch ein Semikolon getrennt werden, und Sie können ein Muster negativ machen, indem Sie es mit !voranstellen. Beispiel: **/*.nupkg;!**/*.Tests.nupkg.

nuGetFeedType - Zielfeedspeicherort
string. Erforderlich, wenn command = push. Zulässige Werte: internal (Diese Organisation/Sammlung), external (externer NuGet-Server (einschließlich anderer Organisationen/Sammlungen)). Standardwert: internal.

Gibt an, ob der Zielfeed intern oder extern ist.

publishVstsFeed - Zielfeed-
Eingabealias: feedPublish. string. Erforderlich, wenn command = push && nuGetFeedType = internal.

Gibt einen in dieser Organisation gehosteten Feed an. Sie müssen die Paketverwaltung installiert und lizenziert haben, um hier einen Feed auszuwählen.

publishPackageMetadata - Veröffentlichen von Pipelinemetadaten
boolean. Wahlfrei. Wird verwendet, wenn command = push && nuGetFeedType = internal && command = push. Standardwert: true.

Ordnet die Metadaten dieser Build-/Releasepipeline (Run #, Quellcodeinformationen) dem Paket zu.

publishFeedCredentials - NuGet-Server-
Eingabealias: externalEndpoint. string. Erforderlich, wenn command = push && nuGetFeedType = external.

Die NuGet-Dienstverbindung, die die Anmeldeinformationen des externen NuGet-Servers enthält.

packagesToPack - Pfad zu csproj- oder nuspec-Dateien zum Packen
Eingabealias: searchPatternPack. string. Erforderlich, wenn command = pack. Standardwert: **/*.csproj.

Das Muster zum Suchen nach .csproj oder .nuspec zu packenden Dateien.

Sie können mehrere Muster durch ein Semikolon trennen, und Sie können ein Muster negativ machen, indem Sie es mit !voranstellen. Beispiel: **/*.csproj;!**/*.Tests.csproj.

configuration - Konfiguration zum Packen
Eingabealias: configurationToPack. string. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: $(BuildConfiguration).

Bei Verwendung einer .csproj-Datei gibt diese Eingabe die zu verpackende Konfiguration an.

packDirectory - Paketordner-
Eingabealias: outputDir. string. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: $(Build.ArtifactStagingDirectory).

Der Ordner, in dem Pakete erstellt werden. Wenn dieser Ordner leer ist, werden Pakete zusammen mit der datei csproj erstellt.

nobuild - nicht erstellen
boolean. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: false.

Gibt an, dass der Vorgang das Projekt vor dem Packen nicht erstellt. Dieser Vorgang entspricht dem --no-build-Parameter des Befehls build.

includesymbols - Symbole einschließen
boolean. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: false.

Erstellt NuGet-Symbolpakete. Diese Aufgabe entspricht dem --include-symbols Befehlszeilenparameter.

includesource - Source- einschließen
boolean. Wahlfrei. Wird verwendet, wenn command = pack. Standardwert: false.

Enthält Quellcode im Paket. Diese Aufgabe entspricht dem --include-source Befehlszeilenparameter.

versioningScheme - automatische Paketversionsverwaltung
string. Erforderlich, wenn command = pack. Zulässige Werte: off, byPrereleaseNumber (Datum und Uhrzeit verwenden), byEnvVar (Umgebungsvariable verwenden), byBuildNumber (Buildnummer verwenden). Standardwert: off.

Dieser Vorgang kann nicht mit eingeschlossenen referenzierten Projekten verwendet werden. Wenn Sie Use the date and timeauswählen, generiert dies eine SemVer--kompatible Version, die als X.Y.Z-ci-datetime formatiert ist, wobei Sie X, Yund Zauswählen.

Wenn Sie Use an environment variableauswählen, müssen Sie eine Umgebungsvariable auswählen und sicherstellen, dass sie die Versionsnummer enthält, die Sie verwenden möchten.

Wenn Sie Use the build numberauswählen, verwendet dies die Buildnummer, um Ihr Paket zu versionieren. Hinweis: Legen Sie unter Optionsdas Buildnummernformat auf $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r)fest.

versionEnvVar - Umgebungsvariablen
string. Erforderlich, wenn versioningScheme = byEnvVar && command = pack.

Gibt den Variablennamen ohne $, $envoder %an.

majorVersion - Haupt-
Eingabealias: requestedMajorVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 1.

Die X in Version X.Y.Z.

minorVersion - neben
Eingabealias: requestedMinorVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 0.

Die Y in Version X.Y.Z.

patchVersion - Patch-
Eingabealias: requestedPatchVersion. string. Erforderlich, wenn versioningScheme = byPrereleaseNumber && command = pack. Standardwert: 0.

Die Z in Version X.Y.Z.

buildProperties - Zusätzliche Buildeigenschaften
string. Wahlfrei. Wird verwendet, wenn command = pack.

Gibt eine Liste von token = value Paaren an, getrennt durch Semikolons, wobei jedes Vorkommen von $token$ in der .nuspec Datei durch den angegebenen Wert ersetzt wird. Werte können Zeichenfolgen in Anführungszeichen sein.

verbosityPack - Ausführlichkeit
string. Wahlfrei. Wird verwendet, wenn command = pack. Zulässige Werte: -, Quiet, Minimal, Normal, Detailed, Diagnostic. Standardwert: Normal.

Gibt die Anzahl der Details an, die in der Ausgabe für den Befehl pack angezeigt werden.

workingDirectory - Arbeitsverzeichnis
string. Wahlfrei. Wird verwendet, wenn command != restore && command != push && command != pack && command != pack && command != push && command != restore.

Das aktuelle Arbeitsverzeichnis, in dem das Skript ausgeführt wird. Empty ist der Stamm des Repositorys (Build) oder Artefakte (Release), das $(System.DefaultWorkingDirectory)ist.

requestTimeout - Timeout für paketdownloadanforderungs- festlegen
string. Standardwert: 300000.

Stellen Sie einen Timeoutwert für HTTP-Anforderungen bereit, die die Aufgabe zum Abrufen des .NET-Pakets vorgibt. Der Wert ist in Millisekunden. Der Standardwert ist 300000 Millisekunden (5 Minuten). Maximal 600000 Millisekunden (10 Minuten).

Aufgabensteuerungsoptionen

Alle Aufgaben verfügen zusätzlich zu ihren Aufgabeneingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerelementoptionen und allgemeinen Aufgabeneigenschaften.

Ausgabevariablen

Nichts.

Bemerkungen

Wichtig

Die NuGet Authenticate Aufgabe ist die neue empfohlene Methode zum Authentifizieren mit Azure Artifacts und anderen NuGet-Repositorys. Die Befehle restore und push dieser .NET Core CLI-Aufgabe übernehmen keine neuen Features mehr, und nur wichtige Fehler werden behoben.

Verwenden von AzurePipelinesCredential in Integrationstests

Die Azure Identity-Bibliotheken für .NET, C++, Go, Java, JavaScript und Python bieten Unterstützung für den Workload-Identitätsverbund, sodass code, der über die AzureCLI@2 und AzurePowerShell@5 Aufgaben ausgeführt wird, sich mit Microsoft Entra-ID (z. B. für den Zugriff auf Azure) mithilfe der AzurePipelinesCredential-Klasse authentifizieren kann.

Viele Kunden verwenden Azure SDK-Clientbibliotheken in Integrationstests, die von anderen Aufgaben aufgerufen werden. Die aufgaben DotNetCoreCLI@2, Maven@4 und VSTest@3 können mithilfe der AzurePipelinesCredential Klasse auf Azure-Ressourcen zugreifen.

Sie können die eigenschaft connectedServiceName auf eine Mit Workload Identity Federation konfigurierte Azure-Dienstverbindung festlegen. Für die AzurePipelinesCredential muss SYSTEM_ACCESSTOKEN festgelegt werden.

Das folgende Beispiel zeigt die connectedServiceName Eingabe für den DotNetCoreCLI@2 Vorgang. VSTest@3 und Maven@4 Verwendung ist ähnlich.

- task: DotNetCoreCLI@2
  inputs:
    command: 'run'
    connectedServiceName: <Azure service connection configured with workload identity federation>
  env:
    SYSTEM_ACCESSTOKEN: $(System.AccessToken)

Weitere Informationen zu AzurePipelinesCredentialfinden Sie unter Verbessern des Sicherheitsstatus in Azure-Dienstverbindungen mit AzurePipelinesCredential.

Warum ist mein Build, mein Veröffentlichungs- oder Testschritt beim Wiederherstellen von Paketen nicht möglich?

Die meisten dotnet Befehle, einschließlich build, publishund test enthalten einen impliziten restore Schritt. Dies schlägt bei authentifizierten Feeds fehl, auch wenn Sie in einem früheren Schritt eine erfolgreiche dotnet restore ausgeführt haben, da der vorherige Schritt die verwendeten Anmeldeinformationen bereinigt hat.

Um dieses Problem zu beheben, fügen Sie das --no-restore Flag zum Textfeld Arguments hinzu.

Darüber hinaus erkennt der Befehl test die Argumente feedRestore oder vstsFeed nicht, und Feeds, die auf diese Weise angegeben sind, werden nicht in die generierte NuGet.config Datei einbezogen, wenn der implizite restore Schritt ausgeführt wird. Es wird empfohlen, dass ein expliziter dotnet restore Schritt zum Wiederherstellen von Paketen verwendet werden. Der Befehl restore berücksichtigt die Argumente feedRestore und vstsFeed.

Warum erhalte ich NU1507-Warnungen mit Paketquellzuordnung obwohl beim Erstellen auf meinem Computer keine Warnungen vorhanden sind?

Die verschiedenen Befehle, die eine NuGet-Wiederherstellung ausführen oder auf einen NuGet-Feed zugreifen, erstellen eine spezielle temporäre NuGet.config Datei, die nuGet-Authentifizierung für Azure-Artefakte NuGet-Feeds hinzufügen. Dies geschieht in Konflikt mit dem Schema, mit dem die Paketquellzuordnung verwendet wird, um die Pakete den Quellen zuzuordnen und die Paketquellzuordnungskonfiguration in der NuGet.config-Datei in Ihrem Repository zu unterbricht. Um diesen Konflikt zu umgehen, können Sie die NuGet Authenticate Aufgabe verwenden, um sich zu authentifizieren und danach den benutzerdefinierten Befehl zum Aufrufen des gewünschten Dotnet-Befehls ohne die NuGet.config Änderung aufzurufen.

# Authenticate Azure DevOps NuGet feed
- task: NuGetAuthenticate@1
  displayName: 'Authenticate Azure DevOps NuGet feed'

# Restore project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'restore'

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'custom'
    custom: 'build'
    arguments: '--no-restore'

Warum sollte ich eine NuGet.configeinchecken?

Wenn Sie eine NuGet.config in die Quellcodeverwaltung überprüfen, wird sichergestellt, dass für jeden Entwickler, der Ihren Code auscheckt, ein Schlüsselteil von Informationen zum Erstellen ihres Projekts – dem Speicherort der Pakete – zur Verfügung steht.

In Situationen, in denen ein Entwicklerteam an einer großen Palette von Projekten arbeitet, ist es jedoch auch möglich, dem globalen NuGet.config auf jedem Entwicklercomputer einen Azure Artifacts-Feed hinzuzufügen. In diesen Situationen repliziert die Verwendung der Option Feeds I select here in der NuGet-Aufgabe diese Konfiguration.

Fehlerbehebung

Project mit Entity Framework funktioniert nicht mehr für gehostete Agents

.NET Core verfügt nicht über ein integriertes Entity Framework(EF). Sie müssen EF entweder installieren, bevor Sie mit der Ausführung beginnen oder dem Projekt mit der erforderlichen .NET Core SDK-Version global.json hinzufügen. Dadurch wird sichergestellt, dass das richtige SDK zum Erstellen des EF-Projekts verwendet wird. Wenn die erforderliche Version auf dem Computer nicht vorhanden ist, fügen Sie der Pipeline die aufgabe UseDotNetV2 hinzu, um die erforderliche Version zu installieren. Weitere Informationen finden Sie unter Get the Entity Framework Core runtime.

Beispiele

• Buildbeispiele
• Pushbeispiele
• Pushbeispiele
• Pack-Beispiele
• Veröffentlichen von Beispielen
• Wiederherstellungsbeispiele
• Testbeispiele

Buildbeispiele

Erstellen eines Projekts

# Build project
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'

Erstellen mehrerer Projekte

# Build multiple projects
- task: DotNetCoreCLI@2
  inputs:
    command: 'build'
    projects: |
      src/proj1/proj1.csproj 
      src/proj2/proj2.csproj 
      src/other/other.sln    # Pass a solution instead of a csproj.

Pushbeispiele

Übertragen von NuGet-Paketen an den internen Feed

# Push non test NuGet packages from a build to internal organization Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    searchPatternPush: '$(Build.ArtifactStagingDirectory)/*.nupkg;!$(Build.ArtifactStagingDirectory)/*.Tests.nupkg'
    feedPublish: 'FabrikamFeed'

NuGet-Pakete an externen Feed übertragen

# Push all NuGet packages from a build to external Feed
- task: DotNetCoreCLI@2
  inputs:
    command: 'push'
    nugetFeedType: 'external'
    externalEndPoint: 'MyNuGetServiceConnection'

Packbeispiele

Packen eines NuGetPackage in ein bestimmtes Ausgabeverzeichnis

# Pack a NuGet package to a test directory
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    outputDir: '$(Build.ArtifactStagingDirectory)/TestDir'

Packen eines Symbolpakets

# Pack a symbol package along with NuGet package
- task: DotNetCoreCLI@2
  inputs: 
    command: 'pack'
    includesymbols: true

Veröffentlichen von Beispielen

Veröffentlichen von Projekten im angegebenen Ordner

# Publish projects to specified folder.
- task: DotNetCoreCLI@2
  displayName: 'dotnet publish'
  inputs:
    command: 'publish'
    publishWebProjects: false
    projects: '**/*.csproj'
    arguments: '-o $(Build.ArtifactStagingDirectory)/Output'
    zipAfterPublish: true
    modifyOutputPath: true

Wiederherstellen von Beispielen

#Restore packages with the .NET Core CLI task
- task: DotNetCoreCLI@2
  displayName: 'dotnet restore'
  inputs:
    command: 'restore'
    feedsToUse: 'select'
    feedRestore: 'projectName/feedName'
    projects: '**/*.csproj'
    includeNuGetOrg: true

Testbeispiele

Ausführen von Tests in Ihrem Repository

# Run tests and auto publish test results.
- task: DotNetCoreCLI@2
  inputs:
    command: 'test'

Anforderungen

Anforderung	Beschreibung
Pipelinetypen	YAML, Classic Build, Classic Release
Läuft auf	Agent
Anforderungen	Nichts
Funktionen	Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen	Jegliche
Settable-Variablen	Jegliche
Agentversion	2.144.0 oder höher
Vorgangskategorie	Bauen