Compartilhar via


tarefa NuGetRestore@1 – Restauração do NuGet v1

Use essa tarefa para restaurar pacotes NuGet em preparação para uma etapa de Build do Visual Studio.

Importante

Essa tarefa foi preterida. Os builds que o usam serão interrompidos em 27/11-2023. Alterne para usar a opção do restoreassim que possível. Para obter mais informações, consulte Migrar de NuGetInstaller@0 ou NuGetRestore@1.

Use essa tarefa para restaurar pacotes NuGet em preparação para uma etapa de Build do Visual Studio.

Use essa tarefa para restaurar pacotes NuGet em preparação para uma etapa de Build do Visual Studio.

Sintaxe

# NuGet Restore v1
# Restores NuGet packages in preparation for a Visual Studio Build step.
- task: NuGetRestore@1
  inputs:
    solution: '**/*.sln' # string. Required. Path to solution, packages.config, or project.json. Default: **/*.sln.
    selectOrConfig: 'select' # 'select' | 'config'. Required. Feeds to use. Default: select.
    #feed: # string. Optional. Use when selectOrConfig = select. Use packages from this Azure Artifacts feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config. Path to NuGet.config. 
  # Advanced
    #noCache: false # boolean. Disable local cache. Default: false.
    #packagesDirectory: # string. Destination directory. 
    #verbosity: 'Detailed' # '-' | 'Quiet' | 'Normal' | 'Detailed'. Verbosity. Default: Detailed.
# NuGet Restore v1
# Restores NuGet packages in preparation for a Visual Studio Build step.
- task: NuGetRestore@1
  inputs:
    solution: '**/*.sln' # string. Required. Path to solution, packages.config, or project.json. Default: **/*.sln.
    selectOrConfig: 'select' # 'select' | 'config'. Required. Feeds to use. Default: select.
    #feed: # string. Optional. Use when selectOrConfig = select. Use packages from this VSTS feed. 
    #includeNuGetOrg: true # boolean. Optional. Use when selectOrConfig = select. Use packages from NuGet.org. Default: true.
    #nugetConfigPath: # string. Optional. Use when selectOrConfig = config. Path to NuGet.config. 
  # Advanced
    #noCache: false # boolean. Disable local cache. Default: false.
    #packagesDirectory: # string. Destination directory. 
    #verbosity: 'Detailed' # '-' | 'Quiet' | 'Normal' | 'Detailed'. Verbosity. Default: Detailed.

Entradas

solution - Caminho para solução, packages.configou project.json
string. Obrigatório Valor padrão: **/*.sln.

O caminho para a solução, packages.configou project.json arquivo que faz referência aos pacotes a serem restaurados.


feeds selectOrConfig - para usar
string. Obrigatório Valores permitidos: select (Feed(s) eu seleciono aqui), config (Feeds no meu NuGet.config). Valor padrão: select.

Especifica os feeds a serem usados. Especifique um feed do VSTS e/ou NuGet.org usando o valor select. Especifique vários feeds comprometendo um arquivo nuget.config para o repositório de código-fonte e definindo seu caminho com o valor config.


feed - Usar pacotes deste feed do Azure Artifacts
string. Opcional. Use quando selectOrConfig = select.

Inclui o feed do VSTS especificado no arquivo de NuGet.config gerado.


feed - Usar pacotes deste feed do VSTS
string. Opcional. Use quando selectOrConfig = select.

Inclui o feed do VSTS especificado no arquivo de NuGet.config gerado.


includeNuGetOrg - Usar pacotes de NuGet.org
boolean. Opcional. Use quando selectOrConfig = select. Valor padrão: true.

Inclui o feed de NuGet.org especificado no NuGet.configgerado.


nugetConfigPath - caminho para NuGet.config
string. Opcional. Use quando selectOrConfig = config.

Especifica o caminho para o NuGet.config em seu repositório que especifica os feeds dos quais restaurar pacotes.


noCache - Desabilitar de cache local
boolean. Valor padrão: false.

Impede que o NuGet use pacotes de caches de computador locais. Equivalente ao argumento de linha de comando -NoCache NuGet.exe.


de diretório de destino
string.

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. Equivalente ao argumento de linha de comando -PackagesDirectory NuGet.exe.


verbosity - verbosity
string. Valores permitidos: -, Quiet, Normal, Detailed. Valor padrão: Detailed.

Especifica a quantidade de detalhes exibida na saída.


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

Nenhum.

Observações

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: NuGetRestore@1
  inputs:
    solution: '**/*.sln'

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente, DeploymentGroup
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 Pacote
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agente, DeploymentGroup
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 Pacote