Restaurar pacotes NuGet com Azure Pipelines (YAML/Classic)

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com a Restauração de Pacote NuGet, você pode instalar todas as dependências do projeto sem precisar armazená-las 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 orientará você na restauração de seus pacotes NuGet usando pipelines clássicos e YAML.

Pré-requisitos

• Crie no Azure DevOps uma organização e um projeto, caso ainda não tenha feito isso.

• Crie um novo feed se você ainda não tiver um.

• Se você estiver usando um agente auto-hospedado, verifique se ele tem o SDK do .NET Core (2.1.400+) .NET Core SDK (2.1.400+) e NuGet (4.8.0.5385+) instalados.

Restaurar pacotes NuGet de um feed na mesma organização

YAML

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines e, em seguida, selecione a definição do pipeline.

3. Selecione Editar e adicione o snippet a seguir ao pipeline YAML.

   steps:
   - task: NuGetAuthenticate@1
   
   - task: NuGetToolInstaller@1
     inputs:
       versionSpec: '*'
       checkLatest: true
   
   - script: nuget restore <SOLUTION_PATH>
   

Clássico

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines, selecione sua definição de pipeline e depois selecione Editar.

3. Selecione + para adicionar uma nova tarefa. Adicione o instalador da ferramenta NuGet, a autenticação do NuGet e as tarefas de linha de comando ao pipeline. Deixe o instalador da ferramenta NuGet e as tarefas de autenticação do NuGet com suas configurações padrão e defina a tarefa de linha de comando da seguinte maneira:

   • Nome de exibição: Restaurar.
   • Script:

     nuget.exe restore <SOLUTION_PATH>
     

4. Selecione Salvar e colocar na fila quando terminar.

Observação

Verifique se a Galeria do NuGet upstream está habilitada em seu feed. Consulte Ativar fontes upstream em um feed existente para obter detalhes.

Restaurar pacotes NuGet de um feed em outra organização

Para restaurar pacotes NuGet de um feed em uma organização diferente do Azure DevOps, primeiro você deve criar um token de acesso pessoal e, em seguida, usá-lo para configurar uma conexão de serviço NuGet.

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 novo token de acesso pessoal com o escopo de leitura Packaging*>. Copie seu PAT, pois você precisará dele na seção a seguir.

3. Selecione Criar quando terminar.

   

Criar uma conexão de serviço

1. Faça logon na organização do Azure DevOps em que o pipeline será executado e navegue até o projeto.

2. Navegue até as configurações do Project Conexões> de serviço.

3. Selecione Nova conexão de serviço e, selecione NuGet, em seguida, selecione Próximo.

4. Selecione Azure DevOps Server Externo como o Método de autenticação e insira a URL do feed de destino. Cole o Token de Acesso Pessoal que você criou anteriormente, forneça um nome para sua conexão de serviço e marque Conceder permissão de acesso a todos os pipelines , se aplicável ao seu cenário.

5. Selecione Salvar ao terminar.

   

Restaurar pacotes

YAML

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines e, em seguida, selecione a definição do pipeline.

3. Selecione Editar e adicione o snippet a seguir ao pipeline YAML.

   - task: NuGetToolInstaller@1
     inputs:
       versionSpec: '*'
       checkLatest: true
   
   - task: NuGetAuthenticate@1
     inputs:
       nuGetServiceConnections: <SERVICE_CONNECTION_NAME>
   
   - script: |
         nuget.exe restore <SOLUTION_PATH>
     displayName: Restore       
   

Clássico

1. Entre na sua organização do Azure DevOps e navegue até seu projeto.

2. Selecione Pipelines, selecione sua definição de pipeline e depois selecione Editar.

3. Selecione + para adicionar uma nova tarefa. Adicione o instalador da ferramenta NuGet, a autenticação do NuGet e as tarefas de linha de comando ao pipeline. Deixe o instalador da ferramenta NuGet com suas configurações padrão e configure as outras tarefas da seguinte maneira:

   1. Tarefa Autenticar NuGet: selecione sua conexão de serviço no menu suspenso Credenciais de conexão de serviço para feeds fora desta organização .

   2. Tarefa de Linha de Comando:

      • Nome de exibição: Restaurar.
      • Script:

        nuget.exe restore <SOLUTION_PATH>
        

4. Selecione Salvar e colocar na fila quando terminar.

Conteúdo relacionado

• Publicar pacotes em feeds internos e externos
• Publicar e baixar artefatos de pipeline
• Use o arquivo .artifactignore