Freigeben über

DotNetCoreCLI@2 - .NET Core v2 Aufgabe

Bauen, testen, paketieren oder veröffentlichen Sie eine .NET-Anwendung oder führen Sie einen benutzerdefinierten .NET-CLI-Befehl aus.

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. Publish pipeline metadata. Default: true.
  # Pack options
    #versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber' | 'bySemVerBuildNumber'. 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. Working directory.

# .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. 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. Working directory.

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    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.
  # 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. 
    #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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. 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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.

# .NET Core v2
# Build, test, package, or publish a .NET application, or run a custom .NET CLI command.
- task: DotNetCoreCLI@2
  inputs:
    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). 
    #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.
  # 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. 
    #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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = restore. Verbosity. Default: Detailed.
  # Advanced
    #publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. 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: 'Detailed' # '-' | 'Quiet' | 'Minimal' | 'Normal' | 'Detailed' | 'Diagnostic'. Optional. Use when command = pack. Verbosity. Default: Detailed.
  # Advanced
    #workingDirectory: # string. Optional. Use when command != restore && command != push && command != pack. Working directory.

Eingänge

azureSubscription - Azure Resource Manager Verbindung
Eingabealias: . .

Geben Sie eine Azure Resource Manager Serviceverbindung an, die mit der Workload Identity Federation 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.


Befehl
. Erforderlich. Zulässige Werte: , (Nuget-Push), , , , , , . Standardwert: .

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

Wichtig

Die Aufgabe NuGet Authenticate ist die neue empfohlene Methode zur Authentifizierung mit Azure Artifacts und anderen NuGet-Repositories. Die restore und push-Befehle dieser .NET Core CLI-Aufgabe übernehmen keine neuen Funktionen mehr, und es werden nur noch kritische Fehler behoben. Ausführliche Informationen finden Sie in den Hinweisen.


Webprojekte veröffentlichen
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Wenn diese Eingabe auf festgelegt ist, wird der wert der 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 Datei oder eines Ordners im Verzeichnis identifiziert. In Ermangelung einer web.config-Datei oder eines wwwroot-Ordners werden Projekte, die ein Web-SDK wie Microsoft.NET.Sdk.Web verwenden, ausgewählt.


Pfad zu Projekt(en) oder Projektmappen
. Wahlfrei. Wird verwendet, wenn .

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

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


Pfad zu Projekt(en)
. Wahlfrei. Wird verwendet, wenn .

Der Pfad zu den zu verwendenden -Dateien. Sie können Wildcards (z. B. für alle Dateien in allen Unterordnern) verwenden. Weitere Informationen finden Sie im Dateiabgleichsmuster.

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


benutzerdefinierten Befehl
. Erforderlich, wenn .

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


Argumente
. Wahlfrei. Wird verwendet, wenn .

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 , , , und . Wenn Sie Argumente für einen nicht aufgeführten Befehl hinzufügen möchten, verwenden Sie .


Argumente
. Wahlfrei. Wird verwendet, wenn .

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


Veröffentlichen von Testergebnissen und Codeabdeckung
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Wenn Sie diese Option aktivieren, wird eine TRX-Datei in generiert, und die Ergebnisse werden auf dem Server veröffentlicht.

Für VSTest hängt diese Option den Kommandozeilenargumenten an. Für Microsoft.Testing.Platform gilt diese Option, wenn sie als Testrunner in erkannt wird, an die Kommandozeilen-Argumente.

Codeabdeckung kann durch Hinzufügen der (für VSTest) oder (für Microsoft.Testing.Platform) Option zu den Kommandozeilenargumenten erfasst werden.


Titel der Testausführung
. Wahlfrei. Wird verwendet, wenn .

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


veröffentlichten Projekte
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


Hinzufügen des Ordnernamens des Projekts zum Veröffentlichen des Pfads
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Wenn diese Eingabe auf festgelegt 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.


Feeds für die Verwendung von
Eingabealias: . . Erforderlich, wenn . Zulässige Werte: (Feed(e) Ich wähle hier aus), (Feeds in meinem NuGet.config). Standardwert: .

Sie können entweder einen Feed aus Azure Artifacts und/oder NuGet.org auswählen, oder Sie können eine Datei nuget.config in Ihr Quellcode-Repository eintragen und ihren Pfad mit dem Input nugetConfigPath festlegen.


Verwenden Sie Pakete aus diesem Azure Artifacts-Feed. Wählen Sie aus dem Dropdown-Menü oder geben Sie [Projektname/]Feedname.
Eingabealias: . . Wahlfrei. Wird verwendet, wenn .

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


Pakete aus diesem Azure Artifacts Feed
Eingabealias: . . Wahlfrei. Wird verwendet, wenn .

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


Verwenden von Paketen aus NuGet.org
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Enthält in die generierte .


Pfad zu NuGet.config
. Wahlfrei. Wird verwendet, wenn .

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


Anmeldeinformationen für Feeds außerhalb dieser Organisation/Sammlung
Eingabealias: . . Wahlfrei. Wird verwendet, wenn .

Der Name der Dienstverbindung, die für externe Registrierungen verwendet werden soll, die in der ausgewählten Liste aufgeführt sind. Lassen Sie diese Eingabe für Feeds innerhalb derselben Organisation oder Sammlung leer; die Anmeldeinformationen des Builds werden automatisch verwendet.


Deaktivieren des lokalen Caches
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Verhindert, dass NuGet Pakete aus lokalen Computercaches verwendet.


Zielverzeichnis
Eingabealias: . . Wahlfrei. Wird verwendet, wenn .

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


Ausführlichkeit
. Wahlfrei. Wird verwendet, wenn . Zulässige Werte: , , , , , . Standardwert: .

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


Ausführlichkeit
. Wahlfrei. Wird verwendet, wenn . Zulässige Werte: , , , , , . Standardwert: .

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


Pfad zu NuGet-Paketen zum Veröffentlichen von
Eingabealias: . . Erforderlich, wenn . Standardwert: .

Das Muster, das mit 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: .


Zielfeedspeicherort
. Erforderlich, wenn . Zulässige Werte: (Diese Organisation/Sammlung), (externer NuGet-Server (einschließlich anderer Organisationen/Sammlungen)). Standardwert: .

Gibt an, ob der Zielfeed intern oder extern ist.


Zielfeed-
Eingabealias: . . Erforderlich, wenn .

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


Veröffentlichen von Pipelinemetadaten
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


NuGet-Server-
Eingabealias: . . Erforderlich, wenn .

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


Pfad zu csproj- oder nuspec-Dateien zum Packen
Eingabealias: . . Erforderlich, wenn . Standardwert: .

Das Muster zum Suchen nach oder 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: .


Konfiguration zum Packen
Eingabealias: . . Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


Paketordner-
Eingabealias: . . Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


nicht erstellen
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


Symbole einschließen
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

Erstellt NuGet-Symbolpakete. Diese Aufgabe entspricht dem Befehlszeilenparameter.


Source- einschließen
. Wahlfrei. Wird verwendet, wenn . Standardwert: .

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


automatische Paketversionsverwaltung
. Erforderlich, wenn . Erlaubte Werte: , (Verwenden Sie Datum und Uhrzeit), (Verwenden Sie eine Umgebungsvariable), (Verwenden Sie die Build-Nummer), (Verwenden Sie die vollständige SemVer-Build-Nummer). Standardwert: .

Dieser Vorgang kann nicht mit eingeschlossenen referenzierten Projekten verwendet werden. Wenn Sie auswählen, generiert dies eine SemVer--kompatible Version, die als formatiert ist, wobei Sie , und auswählen.

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

Wenn Sie auswählen, verwendet dies die Buildnummer, um Ihr Paket zu versionieren. Hinweis: Legen Sie unter das Buildnummernformat auf fest.


automatische Paketversionsverwaltung
. Erforderlich, wenn . Zulässige Werte: , (Datum und Uhrzeit verwenden), (Umgebungsvariable verwenden), (Buildnummer verwenden). Standardwert: .

Dieser Vorgang kann nicht mit eingeschlossenen referenzierten Projekten verwendet werden. Wenn Sie auswählen, generiert dies eine SemVer--kompatible Version, die als formatiert ist, wobei Sie , und auswählen.

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

Wenn Sie auswählen, verwendet dies die Buildnummer, um Ihr Paket zu versionieren. Hinweis: Legen Sie unter das Buildnummernformat auf fest.


Umgebungsvariablen
. Erforderlich, wenn .

Gibt den Variablennamen ohne , oder an.


Haupt-
Eingabealias: . . Erforderlich, wenn . Standardwert: .

Die in Version X.Y.Z.


neben
Eingabealias: . . Erforderlich, wenn . Standardwert: .

Die in Version X.Y.Z.


Patch-
Eingabealias: . . Erforderlich, wenn . Standardwert: .

Die in Version X.Y.Z.


Zusätzliche Buildeigenschaften
. Wahlfrei. Wird verwendet, wenn .

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


Ausführlichkeit
. Wahlfrei. Wird verwendet, wenn . Zulässige Werte: , , , , , . Standardwert: .

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


Ausführlichkeit
. Wahlfrei. Wird verwendet, wenn . Zulässige Werte: , , , , , . Standardwert: .

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


Arbeitsverzeichnis
. Wahlfrei. Wird verwendet, wenn .

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


Timeout für paketdownloadanforderungs- festlegen
. Standardwert: .

Geben Sie einen Timeout-Wert für HTTP-Anfragen bereit, die die Aufgabe stellt, um das .NET-Paket zu erhalten. 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 Aufgabe NuGet Authenticate ist die neue empfohlene Methode zur Authentifizierung mit Azure Artifacts und anderen NuGet-Repositories. Die restore und push-Befehle dieser .NET Core CLI-Aufgabe übernehmen keine neuen Funktionen mehr, und es werden nur noch kritische Fehler behoben.

Verwenden von AzurePipelinesCredential in Integrationstests

Die Azure Identity-Bibliotheken für .NET, C++, Go, Java, JavaScript und Python unterstützen die Federation der Arbeitslast-Identität, sodass Code, der von den AzureCLI@2 und AzurePowerShell@5 Aufgaben ausgeführt wird, sich mit Microsoft Entra ID authentifizieren kann (zum Beispiel zum Zugriff Azure) mit der AzurePipelinesCredential Klasse.

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

Sie können die Eigenschaft connectedServiceName auf eine Azure Service-Verbindung setzen, die mit Workload Identity Federation konfiguriert ist. Für die muss SYSTEM_ACCESSTOKEN festgelegt werden.

Das folgende Beispiel zeigt die Eingabe für den Vorgang. und 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 AzurePipelinesCredential finden Sie unter Verbesserung der Sicherheitslage in Azure Service-Verbindungen mit AzurePipelinesCredential.

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

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

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

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

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 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 -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 Ä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 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.

Für Situationen, in denen ein Entwicklerteam an einer großen Bandbreite von Projekten arbeitet, ist es jedoch auch möglich, einen Azure Artifacts-Feed zum globalen NuGet.config auf jedem Entwicklerrechner hinzuzufügen. In diesen Situationen repliziert die Verwendung der Option in der NuGet-Aufgabe diese Konfiguration.

Fehlerbehebung

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

.NET Core hat kein integriertes Entity Framework(EF). Sie müssen entweder EF installieren, bevor Sie mit der Ausführung beginnen, oder mit der erforderlichen .NET Core SDK-Version global.json zum Projekt 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 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
    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 Vertreter
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
Anforderung Beschreibung
Pipelinetypen YAML, Classic Build, Classic Release
Läuft auf Vertreter
Anforderungen Nichts
Funktionen Dieser Vorgang erfüllt keine Anforderungen für nachfolgende Vorgänge im Auftrag.
Befehlseinschränkungen Jegliche
Settable-Variablen Jegliche
Agentversion 2.115.0 oder höher
Vorgangskategorie Bauen
  • Last updated on