Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Use essa tarefa para restaurar, empacotar ou enviar pacotes NuGet por push ou executar um comando NuGet. Essa tarefa dá suporte a feeds NuGet.org e autenticados, como o Azure Artifacts e o MyGet. Essa tarefa também usa NuGet.exe e funciona com aplicativos do .NET Framework. Para aplicativos .NET Core e .NET Standard, use a tarefa .NET Core.
Tip
Use NuGetAuthenticate@1 em seu pipeline antes desta tarefa. Para obter mais informações, consulte Por que meu pipeline de build está falhando e solicitando autenticação de SSO (Sign-On único)?
Syntax
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
inputs:
command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
#packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.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.
#allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
#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).
#packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
#arguments: # string. Required when command = custom. Command and arguments.
# 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/TFS 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.
#disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
#restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory.
#verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
# Advanced
#publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
#verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
# Pack options
#versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
#includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
#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.
#packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
#includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
#toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
# Advanced
#buildProperties: # string. Optional. Use when command = pack. Additional build properties.
#basePath: # string. Optional. Use when command = pack. Base path.
#verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
# NuGet v2
# Restore, pack, or push NuGet packages, or run a NuGet command. Supports NuGet.org and authenticated feeds like Azure Artifacts and MyGet. Uses NuGet.exe and works with .NET Framework apps. For .NET Core and .NET Standard apps, use the .NET Core task.
- task: NuGetCommand@2
inputs:
command: 'restore' # 'restore' | 'pack' | 'push' | 'custom'. Required. Command. Default: restore.
restoreSolution: '**/*.sln' # string. Alias: solution. Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
#packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg' # string. Alias: searchPatternPush. Required when command = push. Path to NuGet package(s) to publish. Default: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.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.
#allowPackageConflicts: false # boolean. Optional. Use when command = push && nuGetFeedType = internal. Allow duplicates to be skipped. Default: false.
#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).
#packDestination: '$(Build.ArtifactStagingDirectory)' # string. Alias: outputDir. Optional. Use when command = pack. Package folder. Default: $(Build.ArtifactStagingDirectory).
#arguments: # string. Required when command = custom. Command and arguments.
# 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/TFS 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.
#disableParallelProcessing: false # boolean. Optional. Use when command = restore. Disable parallel processing. Default: false.
#restoreDirectory: # string. Alias: packagesDirectory. Optional. Use when command = restore. Destination directory.
#verbosityRestore: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = restore. Verbosity. Default: Detailed.
# Advanced
#publishPackageMetadata: true # boolean. Optional. Use when command = push && nuGetFeedType = internal. Publish pipeline metadata. Default: true.
#verbosityPush: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = push. Verbosity. Default: Detailed.
# Pack options
#versioningScheme: 'off' # 'off' | 'byPrereleaseNumber' | 'byEnvVar' | 'byBuildNumber'. Required when command = pack. Automatic package versioning. Default: off.
#includeReferencedProjects: false # boolean. Optional. Use when versioningScheme = off && command = pack. Include referenced projects. Default: false.
#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.
#packTimezone: 'utc' # 'utc' | 'local'. Optional. Use when versioningScheme = byPrereleaseNumber && command = pack. Time zone. Default: utc.
#includeSymbols: false # boolean. Optional. Use when command = pack. Create symbols package. Default: false.
#toolPackage: false # boolean. Optional. Use when command = pack. Tool Package. Default: false.
# Advanced
#buildProperties: # string. Optional. Use when command = pack. Additional build properties.
#basePath: # string. Optional. Use when command = pack. Base path.
#verbosityPack: 'Detailed' # 'Quiet' | 'Normal' | 'Detailed'. Optional. Use when command = pack. Verbosity. Default: Detailed.
Inputs
command
-
Comando
string. Required. Valores permitidos: restore, pack, push, custom. Valor padrão: restore.
Especifica o comando NuGet a ser executado. Use o valor custom para adicionar argumentos ou usar um comando diferente.
restoreSolution
-
Caminho para solução, packages.configou project.json
Alias de entrada: solution.
string. Necessário quando command = restore. Valor padrão: **/*.sln.
Especifica o caminho para a solução, packages.configou project.json arquivo que faz referência aos pacotes a serem restaurados.
feeds feedsToUse - para usar
Alias de entrada: selectOrConfig.
string. Necessário quando command = restore. Valores permitidos: select (Feed(s) eu seleciono aqui), config (Feeds no meu NuGet.config). Valor padrão: select.
Especifica um feed do Azure Artifacts e/ou NuGet.org para a tarefa a ser usada com o valor select. Como alternativa, você pode confirmar um arquivo NuGet.config no repositório de código-fonte e definir seu caminho como o valor usando o valor config.
vstsFeed
-
Usar pacotes deste feed do Azure Artifacts/TFS. Selecione na lista suspensa ou insira [nome do projeto/]nome do feed.
Alias de entrada: feedRestore.
string. Optional. Use quando selectOrConfig = select && command = restore.
Especifica o feed selecionado no NuGet.configgerado. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para especificar um feed aqui.
vstsFeed
-
Usar pacotes deste feed do Azure Artifacts/TFS
Alias de entrada: feedRestore.
string. Optional. Use quando selectOrConfig = select && command = restore.
Especifica o feed selecionado no NuGet.configgerado. Você deve ter o Gerenciamento de Pacotes instalado e licenciado para especificar um feed aqui.
includeNuGetOrg
-
Usar pacotes de NuGet.org
boolean. Optional. Use quando selectOrConfig = select && command = restore. Valor padrão: true.
Inclui NuGet.org no NuGet.configgerado.
nugetConfigPath
-
caminho para NuGet.config
string. Optional. Use quando selectOrConfig = config && command = restore.
Especifica o caminho para o NuGet.config em seu repositório que determina os feeds dos quais restaurar pacotes.
externalFeedCredentials
-
Credenciais para feeds fora desta organização/coleção
Alias de entrada: externalEndpoints.
string. Optional. Use quando selectOrConfig = config && command = restore.
Especifica as credenciais a serem usadas para registros externos localizados no NuGet.configselecionado. Esse é o nome da conexão de serviço do NuGet. Para feeds nesta organização ou coleção, deixe isso em branco; As credenciais do build são usadas automaticamente.
noCache
-
Desabilitar de cache local
boolean. Optional. Use quando command = restore. Valor padrão: false.
Impede que o NuGet use pacotes de caches de computador locais quando definido como true.
disableParallelProcessing
-
Desabilitar de processamento paralelo
boolean. Optional. Use quando command = restore. Valor padrão: false.
Impede que o NuGet instale vários pacotes em processos paralelos quando definido como true.
restoreDirectory
-
Diretório de destino
Alias de entrada: packagesDirectory.
string. Optional. Use quando command = restore.
Especifica a pasta na qual os pacotes estão instalados. Se nenhuma pasta for especificada, os pacotes serão restaurados em uma pasta packages/ ao lado da solução selecionada, packages.configou project.json.
verbosityRestore
-
Verbosidade
string. Optional. Use quando command = restore. Valores permitidos: Quiet, Normal, Detailed. Valor padrão: Detailed.
Especifica a quantidade de detalhes exibida na saída.
packagesToPush
-
caminho para pacotes NuGet para publicar
Alias de entrada: searchPatternPush.
string. Necessário quando command = push. Valor padrão: $(Build.ArtifactStagingDirectory)/**/*.nupkg;!$(Build.ArtifactStagingDirectory)/**/*.symbols.nupkg.
Especifica o padrão a ser correspondido ou o caminho para nupkg arquivos a serem carregados. Vários padrões podem ser separados por ponto-e-vírgula.
nuGetFeedType
-
local do feed de destino
string. Necessário quando command = push. Valores permitidos: internal (esta organização/coleção), external (servidor NuGet externo (incluindo outras contas/coleções)). Valor padrão: internal.
Especifica se o feed de destino é um feed/coleção interno ou um servidor NuGet externo.
publishVstsFeed
-
Feed de destino
Alias de entrada: feedPublish.
string. Necessário quando command = push && nuGetFeedType = internal.
Especifica um feed hospedado nesta conta. Você deve ter o Azure Artifacts instalado e licenciado para selecionar um feed aqui.
publishPackageMetadata
-
Publicar de metadados de pipeline
boolean. Optional. Use quando command = push && nuGetFeedType = internal. Valor padrão: true.
Altera o número de versão do subconjunto de pacotes alterados em um conjunto de pacotes publicados continuamente.
allowPackageConflicts
-
Permitir que duplicatas sejam ignoradas
boolean. Optional. Use quando command = push && nuGetFeedType = internal. Valor padrão: false.
Relata o êxito da tarefa mesmo se alguns de seus pacotes forem rejeitados com 409 erros de conflito.
No momento, essa opção só está disponível em agentes do Azure Pipelines e do Windows. Se NuGet.exe encontrar um conflito, a tarefa falhará. Essa opção não funcionará e a publicação falhará se você estiver dentro de um ambiente de proxy.
publishFeedCredentials
-
Servidor NuGet
Alias de entrada: externalEndpoint.
string. Necessário quando command = push && nuGetFeedType = external.
Especifica a conexão de serviço NuGet que contém as credenciais do servidor NuGet externo.
verbosityPush
-
Verbosidade
string. Optional. Use quando command = push. Valores permitidos: Quiet, Normal, Detailed. Valor padrão: Detailed.
Especifica a quantidade de detalhes exibida na saída.
packagesToPack
-
Caminho para arquivo csproj ou nuspec para empacotar
Alias de entrada: searchPatternPack.
string. Necessário quando command = pack. Valor padrão: **/*.csproj.
Especifica o padrão que a tarefa usa para pesquisar diretórios csproj 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: **\*.csproj;!**\*.Tests.csproj.
Configuração do configuration - para empacotar
Alias de entrada: configurationToPack.
string. Optional. Use quando command = pack. Valor padrão: $(BuildConfiguration).
Especifica a configuração a ser empacotada ao usar um arquivo csproj.
packDestination
-
Pasta de pacotes
Alias de entrada: outputDir.
string. Optional. Use quando command = pack. Valor padrão: $(Build.ArtifactStagingDirectory).
Especifica a pasta em que a tarefa cria pacotes. Se o valor estiver vazio, a tarefa criará pacotes na raiz de origem.
versioningScheme
-
de controle de versão automático do pacote
string. Necessário quando command = pack. Valores permitidos: off, byPrereleaseNumber (Usar a data e a hora), byEnvVar (Usar uma variável de ambiente), byBuildNumber (Use o número de build). Valor padrão: off.
Aplica o controle de versão automático do pacote dependendo do valor especificado. Essa cadeia de caracteres não pode ser usada com includeReferencedProjects. Os valores permitidos são:
-
byPrereleaseNumber- Usar ade data e hora: a tarefa gerará uma versão semverem conformidade formatada comoX.Y.Z-ci-datetime, em que você especificará os valores de X, Y e Z. -
byEnvVar- Usar uma variável de ambiente: a tarefa usará uma variável de ambiente especificada e contém o número de versão que você deseja usar. -
byBuildNumber- Usar o número de build: a tarefa usará o número de build para ver a versão do pacote.
Note
Em Geral, defina o formato de build como $(BuildDefinitionName)_$(Year:yyyy).$(Month).$(DayOfMonth)$(Rev:.r).
includeReferencedProjects
-
Incluir projetos referenciados
boolean. Optional. Use quando versioningScheme = off && command = pack. Valor padrão: false.
Inclui projetos referenciados como dependências ou como parte do pacote. Não pode ser usado com o controle de versão automático do pacote. Se um projeto referenciado tiver um arquivo nuspec correspondente que tenha o mesmo nome do projeto, esse projeto referenciado será adicionado como uma dependência. Caso contrário, o projeto referenciado será adicionado como parte do pacote. Saiba mais sobre usando o comando de pacote da CLI do NuGet para criar pacotes NuGet.
versionEnvVar
-
Variável de ambiente
string. Necessário quando versioningScheme = byEnvVar && command = pack.
Especifica o nome da variável sem $, $envou %.
majorVersion
-
Principal
Alias de entrada: requestedMajorVersion.
string. Necessário quando versioningScheme = byPrereleaseNumber && command = pack. Valor padrão: 1.
A X versão X.Y.Z.
minorVersion
-
Menor
Alias de entrada: requestedMinorVersion.
string. Necessário quando versioningScheme = byPrereleaseNumber && command = pack. Valor padrão: 0.
A Y versão X.Y.Z.
patchVersion
-
Remendo
Alias de entrada: requestedPatchVersion.
string. Necessário quando versioningScheme = byPrereleaseNumber && command = pack. Valor padrão: 0.
A Z versão X.Y.Z.
packTimezone
-
Fuso horário
string. Optional. Use quando versioningScheme = byPrereleaseNumber && command = pack. Valores permitidos: utc, local (hora local do agente). Valor padrão: utc.
Especifica o fuso horário desejado usado para produzir a versão do pacote. Selecionar utc é recomendável se você estiver usando agentes de build hospedados, pois sua data e hora podem ser diferentes.
includeSymbols
-
Criar pacote de símbolos
boolean. Optional. Use quando command = pack. Valor padrão: false.
Especifica que o pacote contém fontes e símbolos. Quando usado com um arquivo .nuspec, isso cria um arquivo de pacote NuGet regular e o pacote de símbolos correspondente.
toolPackage
-
Pacote de ferramentas
boolean. Optional. Use quando command = pack. Valor padrão: false.
Determina se os arquivos de saída do projeto devem estar na pasta de ferramentas.
buildProperties
-
propriedades de build adicionais
string. Optional. Use quando command = pack.
Especifica uma lista de pares token=valor, separados por ponto-e-vírgula, em que cada ocorrência de $token$ no arquivo .nuspec será substituída pelo valor fornecido. Os valores podem ser cadeias de caracteres entre aspas.
basePath
-
Caminho base
string. Optional. Use quando command = pack.
Especifica o caminho base dos arquivos definidos no arquivo nuspec.
verbosityPack
-
Verbosidade
string. Optional. Use quando command = pack. Valores permitidos: Quiet, Normal, Detailed. Valor padrão: Detailed.
Especifica a quantidade de detalhes exibida na saída.
arguments
-
comando e argumentos
string. Necessário quando command = custom.
Especifica o comando e os argumentos que serão passados para NuGet.exe para execução. Se o NuGet 3.5 ou posterior for usado, comandos autenticados como list, restoree publish em qualquer feed nesta organização ou coleção à qual o Serviço de Build de Coleção de Projetos tem acesso serão autenticados automaticamente.
Opções de controle de tarefa
Todas as tarefas têm opções de controle além das suas entradas de tarefas. Para obter mais informações, consulte as opções de Controle de e as propriedades comuns da tarefa.
Variáveis de saída
None.
Remarks
Important
Se você quiser autenticar com Azure Artifacts ou outros repositórios NuGet, deverá usar a tarefa Autenticar do NuGet em vez da NuGetCommand@2 tarefa. A NuGetCommand@2 tarefa não está mais sendo atualizada com novos recursos; apenas bugs críticos são resolvidos.
Use essa tarefa para restaurar, empacotar ou enviar pacotes NuGet por push ou executar comandos NuGet. Essa tarefa usa NuGet.exe e funciona com aplicativos .NET Framework. Se você estiver trabalhando com o .NET Core ou o .NET Standard, use a tarefa do .NET Core , que tem suporte total para todos os cenários de pacote e atualmente tem suporte do dotnet.
Se o código depender de pacotes NuGet e você precisar restaurar essas dependências antes de criar seu projeto com a tarefa de tarefa Build do Visual Studio , poderá usar as tarefas nugetAuthenticate e de linha de comando para restaurar seus pacotes. Coloque ambas as tarefas antes da etapa de compilação para garantir que todas as dependências estejam disponíveis antes do início da compilação. Consulte Restaurar pacotes NuGet para obter mais detalhes.
Ao usar a tarefa de tarefa de build do Visual Studio , certifique-se de deixar o argumento restoreNugetPackages em branco, pois a opção "Restaurar pacotes NuGet" foi preterida na tarefa VSBuild@1 .
Tip
Essa versão da tarefa NuGet usa o NuGet 4.1.0 por padrão. Para selecionar uma versão diferente do NuGet, use o Instalador de Ferramentas.
Esquemas de controle de versão
Para byPrereleaseNumber, a versão será definida com os valores escolhidos para a versão principal, a versão secundária e o patch, além da data e hora, no formato yyyymmdd-hhmmss.
Para byEnvVar, a versão será definida como o valor da variável de ambiente que tem o nome especificado pelo parâmetro versionEnvVar , por exemplo MyVersion , (no $, apenas o nome da variável de ambiente). Verifique se a variável de ambiente está definida como um SemVer adequado, como 1.2.3 ou 1.2.3-beta1.
Para byBuildNumber, a versão será definida usando o número de build da execução do pipeline. Esse é o valor especificado para a propriedade name do pipeline, que é salva na variável de ambiente BUILD_BUILDNUMBER). Verifique se o número de build que está sendo usado contém um SemVer adequado, como 1.0.$(Rev:r). Ao usar byBuildNumber, a tarefa extrairá a versão pontilhada, 1.2.3.4, da cadeia de caracteres do número de compilação e usará apenas essa parte. O restante da cadeia de caracteres será descartada. Se você quiser usar o número de compilação como está, poderá usar byEnvVar conforme descrito acima e definir versionEnvVar como BUILD_BUILDNUMBER.
Migrar de NuGetInstaller@0 ou NuGetRestore@1
NuGetInstaller@0 e NuGetRestore@1 foram preteridos e você deve substituí-los no pipeline por NuGetCommand@2.
Se você estiver usando NuGetInstaller@0 com restoreMode: restore, configure as entradas a seguir ao usar NuGetCommand@2.
| NuGetCommand@2 entrada de tarefa | Value |
|---|---|
command |
restore |
restoreSolution |
Caminho do arquivo .sln |
Se você estiver usando NuGetInstaller@0 com restoreMode: install, configure as entradas a seguir ao usar NuGetCommand@2.
| NuGetCommand@2 entrada de tarefa | Value |
|---|---|
command |
custom |
arguments |
Como seria a aparência do comando de instalação completa na CLI do NuGet. Por exemplo, se você quiser executar o equivalente a nuget install ninject -OutputDirectory c:\proj em seu pipeline, o parâmetro arguments será install ninject -OutputDirectory c:\proj. Se você estiver usando o parâmetro NuGetInstaller@0nuGetRestoreArgs, eles também entrarão em arguments. |
Se você estiver usando NuGetRestore@1, configure as entradas a seguir ao usar NuGetCommand@2.
| NuGetCommand@2 entrada de tarefa | Value |
|---|---|
command |
restore |
restoreSolution |
Caminho do arquivo .sln |
Semelhante ao uso de NuGetRestore@1 ou a opção NuGetInstaller@0restore, NuGetCommand@2 tem entradas para definir o feed, decidir entre select ou config, especificar o caminho para o arquivo NuGet.config e usar pacotes de nuget.org.
Para obter mais informações, consulte os exemplos a seguir.
Suporte para imagens hospedadas do Ubuntu mais recentes
A partir do Ubuntu 24.04, os agentes hospedados pela Microsft não serão enviados com mono, o que é necessário para executar o cliente NuGet subjacente que alimenta NuGetCommand@2. Os usuários dessa tarefa no Ubuntu devem migrar para a tarefa multiplataforma com suporte a longo prazo NuGetAuthenticate@1 com a CLI do .NET.
Migrando para a CLI do .NET no Ubuntu
A tarefa Autenticar do NuGet manipulará a injeção de credenciais nos locais necessários para que as ferramentas do cliente se autentiquem como sua identidade de pipeline. Consulte as seções Exemplos e Comentários para saber mais sobre como usar NuGet Authenticate o dotnet.
Se comandos da CLI do dotnet não der suporte ao seu cenário, relatar isso à equipe da CLI do .NET como um problema. Você pode continuar a fixar sua imagem de agente para Ubuntu 22.04 ouanterior. O suporte ao Ubuntu 22.04 continuará até que o Ubuntu 26.04 seja disponibilizado em geral, não antes de 2026.
Por que meu pipeline de build está falhando e solicitando autenticação de SSO (Sign-On Única)?
As compilações podem falhar se as credenciais tiverem expirado. Para evitar essas falhas, recomendamos usar a tarefa Autenticar NuGet para reinstalar o provedor de credenciais e atualizar automaticamente as credenciais. Isso garante acesso ininterrupto durante a execução do pipeline.
steps:
# Authenticate with NuGet to ensure credentials are refreshed
- task: NuGetAuthenticate@1
# Restore NuGet packages
- task: NuGetCommand@2
inputs:
command: 'restore'
restoreSolution: '**/*.sln'
feedsToUse: 'select'
Examples
Restore
Restaure todas as soluções com pacotes de um feed selecionado.
# Restore from a project scoped feed in the same organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'select'
vstsFeed: 'my-project/my-project-scoped-feed'
includeNuGetOrg: false
restoreSolution: '**/*.sln'
# Restore from an organization scoped feed in the same organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'select'
vstsFeed: 'my-organization-scoped-feed'
restoreSolution: '**/*.sln'
# Restore from a feed in a different organization
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: config
nugetConfigPath: ./nuget.config
restoreSolution: '**/*.sln'
externalFeedCredentials: 'MyServiceConnectionName'
noCache: true
continueOnError: true
# Restore from feed(s) set in nuget.config
- task: NuGetCommand@2
inputs:
command: 'restore'
feedsToUse: 'config'
nugetConfigPath: 'nuget.config'
Package
Crie um pacote NuGet na pasta de destino.
# Package a project
- task: NuGetCommand@2
inputs:
command: 'pack'
packagesToPack: '**/*.csproj'
packDestination: '$(Build.ArtifactStagingDirectory)'
Transmitir
Note
Os artefatos de pipeline são baixados para o diretório Pipeline.Workspace e para o diretório System.ArtifactsDirectory para pipelines de lançamento clássicos.
packagesToPush valor pode ser definido como $(Pipeline.Workspace)/**/*.nupkg ou $(System.ArtifactsDirectory)/**/*.nupkg respectivamente.
Enviar por push/publicar um pacote em um feed definido em seu NuGet.config.
# Push a project - task: NuGetCommand@2 inputs: command: 'push' packagesToPush: '$(Build.ArtifactStagingDirectory)/**/*.nupkg' feedsToUse: 'config' nugetConfigPath: '$(Build.WorkingDirectory)/NuGet.config'Enviar por push/publicar um pacote em um feed com escopo da organização
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-organization-scoped-feed'Enviar por push/publicar um pacote em um feed com escopo do projeto
# Push a project - task: NuGetCommand@2 inputs: command: 'push' nuGetFeedType: 'internal' publishVstsFeed: 'my-project/my-project-scoped-feed'Enviar por push/publicar um pacote para NuGet.org
# Push a project - task: NuGetCommand@2 inputs: command: 'push' feedsToUse: 'config' includeNugetOrg: 'true'
Custom
Execute qualquer outro comando NuGet além dos padrão: pack, push e restore.
# list local NuGet resources.
- task: NuGetCommand@2
displayName: 'list locals'
inputs:
command: custom
arguments: 'locals all -list'
Requirements
| Requirement | Description |
|---|---|
| Tipos de tubulação | YAML, build clássico, versão clássica |
| Funciona em | Agente, DeploymentGroup |
| Demands | None |
| Capabilities | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| Restrições de comando | Any |
| Variáveis configuráveis | Any |
| Versão do agente | 2.144.0 ou superior |
| Categoria de tarefa | Package |
| Requirement | Description |
|---|---|
| Tipos de tubulação | YAML, build clássico, versão clássica |
| Funciona em | Agente, DeploymentGroup |
| Demands | None |
| Capabilities | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
| Restrições de comando | Any |
| Variáveis configuráveis | Any |
| Versão do agente | 2.115.0 ou superior |
| Categoria de tarefa | Package |