Condividi tramite

DotNetCoreCLI@2 - .NET compito Core v2

Compila, testa, impacchettare o pubblicare un'applicazione .NET, oppure eseguire un comando CLI .NET personalizzato.

Sintassi

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

Ingressi

azureSubscription - Azure Resource Manager connessione
Alias di input: . .

Specifica una connessione di servizio Azure Resource Manager configurata con la federazione dell'identità del carico di lavoro per utilizzare AzurePipelinesCredential nei test di integrazione. Per altre informazioni, vedere Usare AzurePipelinesCredential nei test di integrazione.

Nota

Questo input supporta solo le connessioni al servizio ARM configurate per l'uso della federazione delle identità del carico di lavoro.


comando
. Obbligatorio. Valori consentiti: , (push nuget), , , , , , . Valore predefinito: .

Comando dotnet da eseguire. Specificare per aggiungere argomenti o usare un comando non elencato qui.

Importante

Il compito NuGet Authenticate è il nuovo modo raccomandato per autenticarsi con Azure Artifacts e altri repository NuGet. I comandi restore e push di questo compito di .NET Core CLI non accettano più nuove funzionalità e vengono affrontati solo i bug critici. Per informazioni dettagliate, vedere le osservazioni.


Pubblicare progetti Web
. Opzionale. Usare quando . Valore predefinito: .

Se questo input è impostato su , il valore della proprietà viene ignorato e l'attività tenta di trovare i progetti Web nel repository ed eseguire il comando publish su di essi. I progetti Web sono identificati dalla presenza di un file o di una cartella nella directory. In assenza di un file web.config o di una cartella wwwroot, vengono selezionati progetti che utilizzano un SDK web, come Microsoft.NET.Sdk.Web.


percorso di progetti o soluzioni
. Opzionale. Usare quando .

Percorso del o dei file di da usare. È possibile usare caratteri jolly ,ad esempio per tutti i file in tutte le sottocartelle. Per altre informazioni, vedere il riferimento ai criteri di corrispondenza dei file .

Questo percorso è relativo alla radice del repository indipendentemente dall'impostazione .


percorso ai progetti
. Opzionale. Usare quando .

Percorso dei file di da usare. È possibile usare caratteri jolly ,ad esempio per tutti i file in tutte le sottocartelle. Per altre informazioni, vedere il riferimento ai criteri di corrispondenza dei file .

Questo percorso è relativo alla radice del repository indipendentemente dall'impostazione .


comando personalizzato
. Obbligatorio quando .

Comando da passare a per l'esecuzione. Per un elenco completo dei comandi disponibili, vedere la documentazione dell'interfaccia della riga di comando dotnet .


argomenti
. Opzionale. Usare quando .

Specifica gli argomenti per il comando selezionato. Ad esempio, la configurazione di compilazione, la cartella di output e il runtime. Gli argomenti dipendono dal comando selezionato.

Questo input attualmente accetta solo argomenti per , , , e . Se si desidera aggiungere argomenti per un comando non elencato, usare .


argomenti
. Opzionale. Usare quando .

Scrive gli argomenti aggiuntivi da passare al comando .


Pubblicare i risultati dei test e i di code coverage
. Opzionale. Usare quando . Valore predefinito: .

L'abilitazione di questa opzione genererà un file TRX in e i risultati verranno pubblicati nel server.

Per VSTest, questa opzione si aggiunge agli argomenti della riga di comando. Per Microsoft.Testing.Platform, quando viene rilevato come test runner in , questa opzione si aggiunge agli argomenti della riga di comando.

La copertura del codice può essere raccolta aggiungendo l'opzione (per VSTest) o (per Microsoft.Testing.Platform) agli argomenti della riga di comando.


Titolo esecuzione test
. Opzionale. Usare quando .

Fornisce un nome per l'esecuzione del test.


progetti pubblicati zip
. Opzionale. Usare quando . Valore predefinito: .

Se questo input è impostato su , le cartelle create dal comando di pubblicazione verranno compresse ed eliminate.


Aggiungere il nome della cartella del progetto per pubblicare il percorso
. Opzionale. Usare quando . Valore predefinito: .

Se questo input è impostato su , le cartelle create dal comando publish avranno il nome del file di progetto preceduto dai relativi nomi di cartella quando il percorso di output viene specificato in modo esplicito negli argomenti. Ciò è utile se si desidera pubblicare più progetti nella stessa cartella.


feed da usare
Alias di input: . . Obbligatorio quando . Valori consentiti: (feed selezionati qui), (feed nel NuGet.config). Valore predefinito: .

Puoi selezionare un feed da Azure Artifacts e/o NuGet.org qui, oppure puoi fare commit di un file nuget.config nel repository del codice sorgente e impostarne il percorso usando l'input nugetConfigPath.


vstsFeed - Usa i pacchetti da questo feed Azure Artifacts. Seleziona dal menu a tendina o inserisci [nome progetto/]nome feed.
Alias di input: . . Opzionale. Usare quando .

Include il feed selezionato nel generato. Per selezionare un feed, è necessario che Gestione pacchetti sia installato e concesso in licenza. vengono usati per i feed con ambito progetto. Solo viene usato per i feed con ambito organizzazione. Nota: questo non è supportato per il comando .


vstsFeed - Usa i pacchetti da questo feed Azure Artifacts
Alias di input: . . Opzionale. Usare quando .

Include il feed selezionato nel generato. Per selezionare un feed, è necessario che Gestione pacchetti sia installato e concesso in licenza. vengono usati per i feed con ambito progetto. Solo viene usato per i feed con ambito organizzazione. Nota: questo non è supportato per il comando di test.


Usare pacchetti da NuGet.org
. Opzionale. Usare quando . Valore predefinito: .

Include nel generato.


Percorso di NuGet.config
. Opzionale. Usare quando .

Il nel repository che specifica i feed da cui ripristinare i pacchetti.


Credenziali per i feed esterni a questa organizzazione/raccolta
Alias di input: . . Opzionale. Usare quando .

Nome della connessione al servizio da usare per i registri esterni elencati nell'oggetto selezionato . Per i feed all'interno della stessa organizzazione o raccolta, lasciare vuoto questo input; le credenziali della compilazione vengono usate automaticamente.


Disabilitare la cache locale
. Opzionale. Usare quando . Valore predefinito: .

Impedisce a NuGet di usare pacchetti dalle cache del computer locale.


directory di destinazione
Alias di input: . . Opzionale. Usare quando .

Specifica la cartella in cui vengono installati i pacchetti. Se non viene specificata alcuna cartella, i pacchetti vengono ripristinati nella cache predefinita dei pacchetti NuGet.


dettagliato
. Opzionale. Usare quando . Valori consentiti: , , , , , . Valore predefinito: .

Specifica la quantità di dettagli visualizzati nell'output per il comando .


dettagliato
. Opzionale. Usare quando . Valori consentiti: , , , , , . Valore predefinito: .

Specifica la quantità di dettagli visualizzati nell'output per il comando .


percorso dei pacchetti NuGet da pubblicare
Alias di input: . . Obbligatorio quando . Valore predefinito: .

Modello di corrispondenza o percorso per file da caricare. Più modelli possono essere separati da un punto e virgola ed è possibile rendere un criterio negativo anteponendolo a . Esempio: .


percorso feed di destinazione
. Obbligatorio quando . Valori consentiti: (questa organizzazione/raccolta), (server NuGet esterno (incluse altre organizzazioni/raccolte)). Valore predefinito: .

Specifica se il feed di destinazione è interno o esterno.


feed di destinazione
Alias di input: . . Obbligatorio quando .

Specifica un feed ospitato in questa organizzazione. Per selezionare un feed, è necessario che Gestione pacchetti sia installato e concesso in licenza.


Pubblicare i metadati della pipeline
. Opzionale. Usare quando . Valore predefinito: .

Associa i metadati della pipeline di compilazione/versione (eseguire #, informazioni sul codice sorgente) al pacchetto.


server NuGet
Alias di input: . . Obbligatorio quando .

La connessione al servizio NuGet che contiene le credenziali del server NuGet esterno.


percorso di file csproj o nuspec da comprimere
Alias di input: . . Obbligatorio quando . Valore predefinito: .

Modello da cercare o file da comprimere.

È possibile separare più modelli con un punto e virgola ed è possibile rendere un criterio negativo anteponendolo a . Esempio: .


configurazione di al pacchetto
Alias di input: . . Opzionale. Usare quando . Valore predefinito: .

Quando si usa un file , questo input specifica la configurazione da creare nel pacchetto.


cartella del pacchetto
Alias di input: . . Opzionale. Usare quando . Valore predefinito: .

Cartella in cui verranno creati i pacchetti. Se questa cartella è vuota, i pacchetti verranno creati insieme al file .


Non compilare
. Opzionale. Usare quando . Valore predefinito: .

Specifica che l'attività non compilerà il progetto prima della compressione. Questa attività corrisponde al parametro del comando .


includere simboli
. Opzionale. Usare quando . Valore predefinito: .

Crea pacchetti NuGet di simboli. Questa attività corrisponde al parametro della riga di comando .


includere di origine
. Opzionale. Usare quando . Valore predefinito: .

Include il codice sorgente nel pacchetto. Questa attività corrisponde al parametro della riga di comando .


controllo automatico delle versioni dei pacchetti
. Obbligatorio quando . Valori consentiti: , (Usa data e ora), (Usa una variabile di ambiente), (Usa il numero di build), (Usa il numero completo di build di SemVer). Valore predefinito: .

Questa attività non può essere utilizzata con i progetti a cui si fa riferimento inclusi. Se si sceglie , verrà generata una versione conforme a SemVerformattata come in cui si sceglie , e .

Se si sceglie , è necessario selezionare una variabile di ambiente e assicurarsi che contenga il numero di versione da usare.

Se si sceglie , verrà usato il numero di build per la versione del pacchetto. Nota: In impostare il formato del numero di build su .


controllo automatico delle versioni dei pacchetti
. Obbligatorio quando . Valori consentiti: , (usare la data e l'ora), (usare una variabile di ambiente), (usare il numero di build). Valore predefinito: .

Questa attività non può essere utilizzata con i progetti a cui si fa riferimento inclusi. Se si sceglie , verrà generata una versione conforme a SemVerformattata come in cui si sceglie , e .

Se si sceglie , è necessario selezionare una variabile di ambiente e assicurarsi che contenga il numero di versione da usare.

Se si sceglie , verrà usato il numero di build per la versione del pacchetto. Nota: In impostare il formato del numero di build su .


Variabile di ambiente
. Obbligatorio quando .

Specifica il nome della variabile senza , o .


principali
Alias di input: . . Obbligatorio quando . Valore predefinito: .

Il nella versione X.Y.Z.


secondaria
Alias di input: . . Obbligatorio quando . Valore predefinito: .

Il nella versione X.Y.Z.


patch
Alias di input: . . Obbligatorio quando . Valore predefinito: .

Il nella versione X.Y.Z.


proprietà di compilazione aggiuntive
. Opzionale. Usare quando .

Specifica un elenco di coppie di , separate da punto e virgola, in cui ogni occorrenza di nel file verrà sostituita con il valore specificato. I valori possono essere stringhe tra virgolette.


dettagliato
. Opzionale. Usare quando . Valori consentiti: , , , , , . Valore predefinito: .

Specifica la quantità di dettagli visualizzati nell'output per il comando .


dettagliato
. Opzionale. Usare quando . Valori consentiti: , , , , , . Valore predefinito: .

Specifica la quantità di dettagli visualizzati nell'output per il comando .


directory di lavoro
. Opzionale. Usare quando .

Directory di lavoro corrente in cui viene eseguito lo script. è la radice del repository (build) o degli artefatti (versione), che è .


Impostare il timeout per la richiesta di download del pacchetto
. Valore predefinito: .

Fornire un valore di timeout per le richieste HTTP effettuate dal compito per ottenere il pacchetto .NET. Il valore è espresso in millisecondi. Il valore predefinito è 300000 millisecondi (5 minuti). Non può essere superiore a 600000 millisecondi (10 minuti).


Opzioni di controllo attività

Tutte le attività hanno opzioni di controllo oltre ai relativi input di attività. Per altre informazioni, vedere Opzioni di controllo e proprietà comuni delle attività.

Variabili di output

Nessuno.

Osservazioni

Importante

Il compito NuGet Authenticate è il nuovo modo raccomandato per autenticarsi con Azure Artifacts e altri repository NuGet. I comandi restore e push di questo compito di .NET Core CLI non accettano più nuove funzionalità e vengono affrontati solo i bug critici.

Usare AzurePipelinesCredential nei test di integrazione

Le librerie Azure Identity per .NET, C++, Go, Java, JavaScript e Python forniscono supporto per la federazione dell'identità del carico di lavoro, così il codice eseguito dai compiti AzureCLI@2 e AzurePowerShell@5 può autenticarsi con Microsoft Entra ID (ad esempio, per accedere Azure) usando la classe AzurePipelinesCredential.

Molti clienti utilizzano librerie client Azure SDK in test di integrazione evocati da altri compiti. I compiti DotNetCoreCLI@2, Maven@4 e VSTest@3 possono accedere alle risorse Azure utilizzando la classe AzurePipelinesCredential.

Puoi impostare la proprietà connectedServiceName su una connessione Azure service configurata con la federazione dell'identità del carico di lavoro. Il richiede SYSTEM_ACCESSTOKEN da impostare.

Nell'esempio seguente viene illustrato l'input nell'attività . e l'utilizzo è simile.

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

Per maggiori informazioni su AzurePipelinesCredential, vedi Migliorare la postura di sicurezza nelle connessioni di servizio Azure con AzurePipelinesCredential.

Perché la compilazione, la pubblicazione o il passaggio di test non riesce a ripristinare i pacchetti?

La maggior parte dei comandi , tra cui , e include un passaggio di implicito. Questo errore avrà esito negativo nei feed autenticati, anche se è stato eseguito un riuscito in un passaggio precedente, perché il passaggio precedente avrà pulito le credenziali usate.

Per risolvere questo problema, aggiungere il flag alla casella di testo .

Inoltre, il comando non riconosce gli argomenti o e i feed specificati in questo modo non verranno inclusi nel file generato quando viene eseguito il passaggio implicito . È consigliabile usare un passaggio esplicito per ripristinare i pacchetti. Il comando rispetta gli argomenti e .

Perché vengono visualizzati avvisi NU1507 con mapping dell'origine del pacchetto anche se durante la compilazione nel computer non sono presenti avvisi?

I vari comandi che eseguono un ripristino NuGet o accedono a un feed NuGet creano un file di temporaneo speciale che aggiunge l'autenticazione NuGet per i feed NuGet di azure artifacts. Il modo in cui questa operazione viene eseguita è in conflitto con lo schema usato dal mapping dell'origine del pacchetto per eseguire il mapping dei pacchetti alle origini e interrompe la configurazione mappin origine pacchetto nel file nel repository. Per risolvere questo conflitto, è possibile usare l'attività autenticazione NuGet per eseguire l'autenticazione e successivamente il comando personalizzato per richiamare il comando dotnet desiderato senza la modifica .

# 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'

Perché è consigliabile archiviare un NuGet.config?

Il controllo di un nel controllo del codice sorgente garantisce che una parte chiave di informazioni necessarie per compilare il progetto, ovvero la posizione dei relativi pacchetti, sia disponibile per ogni sviluppatore che controlla il codice.

Tuttavia, per situazioni in cui un team di sviluppatori lavora su una vasta gamma di progetti, è anche possibile aggiungere un feed Azure Artifacts al NuGet.config globale su ogni macchina dello sviluppatore. In queste situazioni, l'uso dell'opzione nell'attività NuGet replica questa configurazione.

Risoluzione dei problemi

Il progetto che utilizza Entity Framework ha smesso di funzionare su Hosted Agents

.NET Core non ha Entity Framework (EF) integrato. Dovrai installare EF prima di iniziare l'esecuzione oppure aggiungere global.json al progetto con la versione richiesta .NET Core SDK. In questo modo si garantisce che l'SDK corretto venga usato per compilare il progetto EF. Se la versione richiesta non è presente nel computer, aggiungere l'attività alla pipeline per installare la versione richiesta. Per maggiori informazioni, vedi Ottieni il runtime Entity Framework Core.

Esempi

  • esempi di compilazione
  • esempi di push
  • esempi di push
  • esempi di Pack
  • Pubblicare esempi
  • esempi di ripristino
  • esempi di test

Esempi di compilazione

Compilare un progetto

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

Compilare più progetti

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

Esempi di push

Eseguire il push dei pacchetti NuGet nel feed interno

# 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'

Eseguire il push di pacchetti NuGet in feed esterno

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

Esempi di pack

Comprimere un pacchetto NuGetPackage in una directory di output specifica

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

Comprimere un pacchetto di simboli

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

Esempi di pubblicazione

Pubblicare progetti nella cartella specificata

# 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

Esempi di ripristino

#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

Esempi di test

Eseguire test nel repository

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

Fabbisogno

Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.144.0 o versione successiva
Categoria attività Costruire
Requisito Descrizione
Tipi di pipeline YAML, build classica, versione classica
Viene eseguito in Agente
richieste Nessuno
funzionalità di Questa attività non soddisfa alcuna richiesta di attività successive nel processo.
restrizioni dei comandi Qualunque
variabili impostabili Qualunque
Versione dell'agente 2.115.0 o versione successiva
Categoria attività Costruire
  • Last updated on