Restaurar pacotes NuGet com o Azure Pipelines

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com o NuGet Package Restore você pode instalar toda a dependência do seu projeto sem ter que armazená-los no controle do código-fonte. Isso permite um ambiente de desenvolvimento mais limpo e um tamanho de repositório menor. Você pode restaurar seus pacotes NuGet usando a tarefa de restauração do NuGet, a CLI do NuGet ou a CLI do .NET Core. Este artigo mostrará como restaurar seus pacotes NuGet usando os pipelines Classic e YAML.

Pré-requisitos

• Uma organização Azure DevOps. Crie uma organização, se ainda não tiver uma.
• Um projeto de DevOps do Azure. Se ainda não tiver um, pode criar um novo projeto.
• Um feed de Artefatos do Azure. Crie um novo feed se ainda não tiver um.
• Conecte-se ao feed de Artefatos do Azure: NuGet.exe, dotnet.
• Configure suas permissões de pipeline.

Restaurar pacotes NuGet a partir de um feed

Clássico

1. Navegue até a definição clássica de pipeline e selecione Editar.

2. Selecione + para adicionar uma nova tarefa. Procure NuGet e selecione Adicionar para adicionar a tarefa ao seu pipeline.

3. Nomeie sua tarefa e selecione Restaurar no comando.

4. Selecione Feed(s) que seleciono aqui e selecione seu feed no menu suspenso. Se você quiser usar seu próprio arquivo de configuração, selecione Feeds em meu NuGet.config e insira o caminho para o arquivo NuGet.config e a conexão de serviço se quiser autenticar com feeds fora da sua organização.

5. Se quiser incluir pacotes do NuGet.org, marque a caixa de seleção Usar pacotes de NuGet.org .

6. Selecione Salvar fila & quando terminar.

   

Nota

A restauração clássica do NuGet usa a tarefa NuGetCommand@2 . Por padrão, essa versão usa o NuGet 4.1.0. Use a tarefa Instalador da Ferramenta NuGet se quiser usar uma versão diferente do NuGet.

YAML

- task: NuGetCommand@2
  displayName: NuGet v2 Restore
  inputs:
    command: restore                      
    restoreSolution: '**/*.sln'             ## Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    feedsToUse: 'select'                    ## Required. Feeds to use. 'select' | 'config'. Alias: selectOrConfig. Default: select.
    vstsFeed: '<PROJECT_NAME>/<FEED_NAME>'  ## Required when feedsToUse == Select. Use packages from this Azure Artifacts feed. 
    includeNuGetOrg: true                   ## Use packages from upstream (NuGet.org)

Restaurar pacotes NuGet localmente

Coloque o seu nuget.config na mesma pasta que o seu .csproj ou .slnarquivo. Seu arquivo de configuração deve ser semelhante ao exemplo a seguir:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- remove inherited connection strings -->
    <clear />
    <!-- add an Azure Artifacts feed -->
    <add key="FabrikamFiber" value="https://pkgs.dev.azure.com/microsoftLearnModule/_packaging/FabrikamFiber/nuget/v3/index.json" />
    <!-- Get packages from NuGet.org -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
</configuration>

Para restaurar seus pacotes NuGet, execute o seguinte comando no diretório do projeto:

nuget.exe restore

Restaurar pacotes NuGet de um feed em uma organização diferente

Para restaurar pacotes NuGet de um feed em uma organização diferente do Azure DevOps, você deve usar um token de acesso pessoal para autenticar.

Criar um token de acesso pessoal

1. Navegue até sua organização do Azure DevOps e selecione Configurações do usuário>Tokens de acesso pessoal.

   

2. Crie um token de acesso pessoal com o escopo Empacotamento (leitura) e copie sua PAT para a área de transferência.

   

Restaurar pacotes NuGet

Clássico

1. Navegue até a definição de pipeline e selecione a tarefa de restauração do NuGet. Certifique-se de que está a utilizar a versão 2 da tarefa.

   

2. Selecione Feeds e autenticação e, em seguida, selecione Feeds no meu NuGet.config.

3. Selecione o caminho do arquivo NuGet.config .

4. Selecione Novo para adicionar Credenciais para feeds fora desta organização/coleção.

   

5. Selecione Servidor de DevOps do Azure Externo e insira a URL do feed (verifique se ela corresponde ao que está em seu NuGet.config), seu nome de conexão de serviço e o token de acesso pessoal criado anteriormente. Quando terminar, selecione Guardar.

   

6. Selecione Salvar fila & quando terminar.

YAML

- task: NuGetCommand@2
  displayName: NuGet Restore
  inputs:
    restoreSolution: '**/*.sln'                     ## Required when command = restore. Path to your project's solution, packages.config, or project.json.
    feedsToUse: 'config'                            ## Required. 'select' | 'config'. Default: select.
    nugetConfigPath: 'Deployment/NuGet.config'      ## Required when selectOrConfig = config. Path to your nuget.config file.
    externalFeedCredentials: 'MyServiceConnection'  ## Use when selectOrConfig = config. The name of your service connection. Credentials for feeds outside your organization/collection.  

FAQ

P: Meu pipeline está falhando ao restaurar meus pacotes NuGet?

R: A tarefa de restauração do NuGet pode falhar por vários motivos. O cenário mais comum é quando você adiciona um novo projeto que requer uma estrutura de destino que não é suportada pela versão do NuGet que seu pipeline está usando. Essa falha não ocorre geralmente no ambiente de desenvolvimento local porque o Visual Studio cuida de atualizar sua solução de acordo. Confirme que atualiza a tarefa NuGet para a versão mais recente.

Artigos relacionados

• Publicar em feeds NuGet (YAML/Classic)
• Publicar e consumir artefatos de compilação
• Como reduzir o risco ao usar feeds de pacotes privados