Compartilhar via

DotNetCoreCLI@2 - .NET Tarefa Core v2

Construa, teste, empacote ou publique um aplicativo .NET, ou execute um comando .NET CLI personalizado.

Sintaxe

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

Entradas

azureSubscription - Azure Resource Manager conexão
Alias de entrada: . .

Especifique uma conexão de serviço Azure Resource Manager configurada com federação de identidade de carga de trabalho para usar AzurePipelinesCredential nos testes de integração. Para obter mais informações, consulte Usar o AzurePipelinesCredential em testes de integração.

Nota

Essa entrada só dá suporte a conexões de serviço do ARM configuradas para usar a federação de identidade de carga de trabalho.


comando
. Necessário. Valores permitidos: , (push nuget), , , , , , . Valor padrão: .

O comando dotnet a ser executado. Especifique para adicionar argumentos ou usar um comando não listado aqui.

Importante

A tarefa NuGet Authenticate é a nova forma recomendada de autenticação com Azure Artifacts e outros repositórios NuGet. Os comandos restore e push desta tarefa .NET Core CLI não recebem mais novos recursos e apenas bugs críticos são corrigidos. Consulte comentários para obter detalhes.


Publicar projetos Web
. Opcional. Use quando . Valor padrão: .

Se essa entrada estiver definida como , o valor da propriedade será ignorado e a tarefa tentará localizar os projetos Web no repositório e executar o comando de publicação neles. Os projetos Web são identificados pela presença de um arquivo ou uma pasta no diretório. Na ausência de um arquivo web.config ou uma pasta wwwroot, projetos que usam um SDK web, como Microsoft.NET.Sdk.Web, são selecionados.


Caminho para projetos ou solução
. Opcional. Use quando .

O caminho para o ou arquivo a ser usado. Você pode usar curingas (por exemplo, para todos os arquivos em todas as subpastas). Para obter mais informações, consulte a referência de padrões de correspondência de arquivo .

Esse caminho é relativo à raiz do repositório, independentemente da configuração de .


caminho para projetos
. Opcional. Use quando .

O caminho para os arquivos a serem usados. Você pode usar curingas (por exemplo, para todos os arquivos em todas as subpastas). Para obter mais informações, consulte a referência de padrões de correspondência de arquivo .

Esse caminho é relativo à raiz do repositório, independentemente da configuração de .


de comando personalizado
. Necessário quando .

O comando a ser passado para para execução. Para obter uma lista completa dos comandos disponíveis, consulte a documentação da CLI do dotnet.


argumentos
. Opcional. Use quando .

Especifica os argumentos para o comando selecionado. Por exemplo, configuração de build, pasta de saída e runtime. Os argumentos dependem do comando selecionado.

Atualmente, essa entrada aceita apenas argumentos para , , , e . Se você quiser adicionar argumentos para um comando não listado, use .


argumentos
. Opcional. Use quando .

Grava os argumentos adicionais a serem passados para o comando .


Publicar resultados do teste e cobertura de código
. Opcional. Use quando . Valor padrão: .

Habilitar essa opção gerará um arquivo TRX em e os resultados serão publicados no servidor.

Para VSTest, essa opção se adiciona aos argumentos da linha de comando. Para o Microsoft.Testing.Platform, quando detectado como executor de teste em , essa opção se adiciona aos argumentos da linha de comando.

A cobertura de código pode ser coletada adicionando a opção (para VSTest) ou (para Microsoft.Testing.Platform) aos argumentos da linha de comando.


Título da execução de teste
. Opcional. Use quando .

Fornece um nome para a execução de teste.


de projetos publicados Zip
. Opcional. Use quando . Valor padrão: .

Se essa entrada estiver definida como , as pastas criadas pelo comando de publicação serão compactadas e excluídas.


Adicionar o nome da pasta do projeto para publicar o caminho
. Opcional. Use quando . Valor padrão: .

Se essa entrada for definida como , as pastas criadas pelo comando de publicação terão o nome do arquivo de projeto prefixado em seus nomes de pasta quando o caminho de saída for especificado explicitamente em argumentos. Isso será útil se você quiser publicar vários projetos na mesma pasta.


feeds para usar
Alias de entrada: . . Necessário quando . Valores permitidos: (Feed(s) eu seleciono aqui), (Feeds no meu NuGet.config). Valor padrão: .

Você pode selecionar um feed de Azure Artifacts e/ou NuGet.org aqui, ou pode comprometer um arquivo nuget.config no seu repositório de código-fonte e definir seu caminho usando a entrada nugetConfigPath.


vstsFeed - Utilize pacotes deste feed Azure Artifacts. Selecione no menu suspenso ou insira [nome do projeto/]nome do feed.
Alias de entrada: . . Opcional. Use quando .

Inclui o feed selecionado no gerado. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para selecionar um feed aqui. são usados para feeds com escopo de projeto. Somente é usado para feeds com escopo da organização. Observação: não há suporte para o comando .


vstsFeed - Utilize pacotes deste feed Azure Artifacts
Alias de entrada: . . Opcional. Use quando .

Inclui o feed selecionado no gerado. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para selecionar um feed aqui. são usados para feeds com escopo de projeto. Somente é usado para feeds com escopo da organização. Observação: não há suporte para o comando de teste.


Usar pacotes de NuGet.org
. Opcional. Use quando . Valor padrão: .

Inclui no gerado.


caminho para NuGet.config
. Opcional. Use quando .

O em seu repositório que especifica os feeds dos quais restaurar pacotes.


Credenciais para feeds fora desta organização/coleção
Alias de entrada: . . Opcional. Use quando .

O nome da conexão de serviço a ser usada para registros externos listados na seleção . Para feeds dentro da mesma organização ou coleção, deixe essa entrada em branco; As credenciais do build são usadas automaticamente.


Desabilitar de cache local
. Opcional. Use quando . Valor padrão: .

Impede que o NuGet use pacotes de caches de computador locais.


de diretório de destino
Alias de entrada: . . Opcional. Use quando .

Especifica a pasta na qual os pacotes estão instalados. Se nenhuma pasta for especificada, os pacotes serão restaurados no cache de pacotes NuGet padrão.


verbosity
. Opcional. Use quando . Valores permitidos: , , , , , . Valor padrão: .

Especifica a quantidade de detalhes exibida na saída do comando .


verbosity
. Opcional. Use quando . Valores permitidos: , , , , , . Valor padrão: .

Especifica a quantidade de detalhes exibida na saída do comando .


caminho para pacotes NuGet para publicar
Alias de entrada: . . Necessário quando . Valor padrão: .

O padrão a ser correspondido ou o caminho para arquivos a serem carregados. Vários padrões podem ser separados por um ponto-e-vírgula e você pode tornar um padrão negativo prefixando-o com . Exemplo: .


local do feed de destino
. Necessário quando . Valores permitidos: (esta organização/coleção), (servidor NuGet externo (incluindo outras organizações/coleções)). Valor padrão: .

Especifica se o feed de destino é interno ou externo.


de feed de destino do
Alias de entrada: . . Necessário quando .

Especifica um feed hospedado nesta organização. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para selecionar um feed aqui.


Publicar de metadados de pipeline
. Opcional. Use quando . Valor padrão: .

Associa os metadados desse pipeline de build/versão (executar #, informações de código-fonte) ao pacote.


servidor NuGet
Alias de entrada: . . Necessário quando .

O de conexão de serviço do NuGet que contém as credenciais do servidor NuGet externo.


Caminho para arquivo csproj ou nuspec para empacotar
Alias de entrada: . . Necessário quando . Valor padrão: .

O padrão para pesquisar arquivos ou para empacotar.

Você pode separar vários padrões com um ponto-e-vírgula e pode tornar um padrão negativo prefixando-o com . Exemplo: .


configuração de para o pacote
Alias de entrada: . . Opcional. Use quando . Valor padrão: .

Ao usar um arquivo , essa entrada especifica a configuração a ser empacotada.


de pasta do pacote
Alias de entrada: . . Opcional. Use quando . Valor padrão: .

A pasta em que os pacotes serão criados. Se essa pasta estiver vazia, os pacotes serão criados junto com o arquivo .


Não criar
. Opcional. Use quando . Valor padrão: .

Especifica que a tarefa não criará o projeto antes de empacotar. Essa tarefa corresponde ao parâmetro do comando .


incluir símbolos
. Opcional. Use quando . Valor padrão: .

Cria pacotes NuGet de símbolo. Essa tarefa corresponde ao parâmetro de linha de comando .


incluir de origem
. Opcional. Use quando . Valor padrão: .

Inclui o código-fonte no pacote. Essa tarefa corresponde ao parâmetro de linha de comando .


de controle de versão automático do pacote
. Necessário quando . Valores permitidos: , (Use a data e hora), (Use uma variável de ambiente), (Use o número da compilação), (Use o número completo da compilação do SemVer). Valor padrão: .

Essa tarefa não pode ser usada com projetos referenciados incluídos. Se você escolher , isso gerará uma versão em conformidade com o SemVerformatada como em que você escolher , e .

Se você escolher , deverá selecionar uma variável de ambiente e garantir que ela contenha o número de versão que deseja usar.

Se você escolher , isso usará o número de build para versão do pacote. Observação: Em , defina o formato de número de build como .


de controle de versão automático do pacote
. Necessário quando . Valores permitidos: , (Usar a data e a hora), (Usar uma variável de ambiente), (Use o número de build). Valor padrão: .

Essa tarefa não pode ser usada com projetos referenciados incluídos. Se você escolher , isso gerará uma versão em conformidade com o SemVerformatada como em que você escolher , e .

Se você escolher , deverá selecionar uma variável de ambiente e garantir que ela contenha o número de versão que deseja usar.

Se você escolher , isso usará o número de build para versão do pacote. Observação: Em , defina o formato de número de build como .


de variável de ambiente
. Necessário quando .

Especifica o nome da variável sem , ou .


principal
Alias de entrada: . . Necessário quando . Valor padrão: .

O na versão X.Y.Z.


menor de
Alias de entrada: . . Necessário quando . Valor padrão: .

O na versão X.Y.Z.


patch
Alias de entrada: . . Necessário quando . Valor padrão: .

O na versão X.Y.Z.


propriedades de build adicionais
. Opcional. Use quando .

Especifica uma lista de pares , separados por ponto-e-vírgula, em que cada ocorrência de no arquivo será substituída pelo valor fornecido. Os valores podem ser cadeias de caracteres entre aspas.


verbosity
. Opcional. Use quando . Valores permitidos: , , , , , . Valor padrão: .

Especifica a quantidade de detalhes exibida na saída do comando .


verbosity
. Opcional. Use quando . Valores permitidos: , , , , , . Valor padrão: .

Especifica a quantidade de detalhes exibida na saída do comando .


do diretório de trabalho do
. Opcional. Use quando .

O diretório de trabalho atual em que o script é executado. é a raiz do repositório (build) ou artefatos (versão), que é .


Definir tempo limite para de solicitação de download do pacote
. Valor padrão: .

Forneça um valor de tempo para as requisições HTTP que a tarefa faz para obter o pacote .NET. O valor está em milissegundos. O padrão é 300000 milissegundos (5 minutos). Não pode ser mais de 600000 milissegundos (10 minutos).


Opções de controle de tarefa

Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.

Variáveis de saída

Nenhum.

Observações

Importante

A tarefa NuGet Authenticate é a nova forma recomendada de autenticação com Azure Artifacts e outros repositórios NuGet. Os comandos restore e push desta tarefa .NET Core CLI não recebem mais novos recursos e apenas bugs críticos são corrigidos.

Usar o AzurePipelinesCredential em testes de integração

As bibliotecas Azure Identity para .NET, C++, Go, Java, JavaScript e Python fornecem suporte para federação de identidade de carga de trabalho, então o código executado a partir das tarefas AzureCLI@2 e AzurePowerShell@5 pode se autenticar com Microsoft Entra ID (por exemplo, para acessar Azure) usando a classe AzurePipelinesCredential.

Muitos clientes estão usando bibliotecas clientes do SDK do Azure em testes de integração invocados de outras tarefas. As tarefas DotNetCoreCLI@2, Maven@4 e VSTest@3 podem acessar Azure recursos usando a classe AzurePipelinesCredential.

Você pode definir a propriedade connectedServiceName para uma conexão de serviço Azure configurada com federação de identidade de carga de trabalho. O requer que SYSTEM_ACCESSTOKEN seja definido.

O exemplo a seguir mostra a entrada na tarefa . e uso é semelhante.

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

Para mais informações sobre AzurePipelinesCredential, veja Melhorar a postura de segurança em conexões de serviço Azure com AzurePipelinesCredential.

Por que minha etapa de build, publicação ou teste está falhando ao restaurar pacotes?

A maioria dos comandos , incluindo , e incluem uma etapa de implícita. Isso falhará em relação aos feeds autenticados, mesmo que você tenha executado uma bem-sucedida em uma etapa anterior, pois a etapa anterior terá limpado as credenciais usadas.

Para corrigir esse problema, adicione o sinalizador à caixa de texto .

Além disso, o comando não reconhece os argumentos ou e os feeds especificados dessa maneira não serão incluídos no arquivo de gerado quando a etapa de implícita for executada. É recomendável que uma etapa explícita seja usada para restaurar pacotes. O comando respeita os argumentos e .

Por que estou recebendo avisos NU1507 com de mapeamento de origem do pacote, embora ao compilar em meu computador ele não tenha avisos?

Os vários comandos que fazem uma restauração do NuGet ou acessam um feed do NuGet criam um arquivo de temporário especial que adiciona autenticação NuGet para feeds NuGet de artefatos do Azure. A maneira como isso é feito está em conflito com o esquema que o Mapeamento de Origem do Pacote usa para mapear os pacotes para as fontes e quebra a configuração mapeador de origem do pacote no arquivo em seu repositório. Para contornar esse conflito, você pode usar a tarefa Autenticação do NuGet para autenticar e, posteriormente, o comando personalizado para invocar o comando dotnet desejado sem a modificação .

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

Por que devo fazer check-in em um NuGet.config?

Verificar um no controle do código-fonte garante que uma parte fundamental das informações necessárias para criar seu projeto, o local de seus pacotes, esteja disponível para todos os desenvolvedores que fizerem check-out do código.

No entanto, para situações em que uma equipe de desenvolvedores trabalha em uma grande variedade de projetos, também é possível adicionar um feed Azure Artifacts ao NuGet.config global na máquina de cada desenvolvedor. Nessas situações, usar a opção na tarefa NuGet replica essa configuração.

Solucionando problemas

O projeto que usa o Entity Framework parou de funcionar em Agentes Hospedados

.NET Core não possui o Entity Framework (EF) embutido. Você terá que instalar o EF antes de iniciar a execução ou adicionar global.json ao projeto com .NET versão necessária do Core SDK. Isso garantirá que o SDK correto seja usado para criar um projeto EF. Se a versão necessária não estiver presente no computador, adicione a tarefa ao pipeline para instalar a versão necessária. Para mais informações, veja Obtenha o tempo de execução Entity Framework Core.

Exemplos

  • exemplos de build
  • exemplos de push
  • exemplos de push
  • exemplos do pacote
  • Publicar exemplos
  • exemplos de restauração
  • exemplos de teste de

Exemplos de build

Criar um projeto

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

Criar vários projetos

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

Exemplos de push

Enviar pacotes NuGet por push para o 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'

Enviar pacotes NuGet por push para o feed externo

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

Exemplos de pacote

Empacotar um NuGetPackage em um diretório de saída específico

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

Empacotar um pacote de símbolo

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

Publicar exemplos

Publicar projetos na pasta especificada

# 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

Exemplos de restauração

#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

Exemplos de teste

Executar testes em seu repositório

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

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Construir
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.115.0 ou superior
Categoria de tarefa Construir
  • Last updated on