Usar pacotes da Galeria NuGet

  • Artigo

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

Com as fontes upstream do Azure Artifacts, os desenvolvedores podem consumir pacotes de registros públicos, como nuget.org e npmjs.com. Este artigo irá guiá-lo através do processo de configuração do seu projeto e usando a linha de comando para consumir efetivamente pacotes NuGet da Galeria NuGet. Neste artigo, vai aprender a:

  • Habilite fontes upstream para seu feed
  • Adicionar a Galeria NuGet como uma fonte upstream
  • Conecte-se ao seu feed
  • Instalar pacotes a partir do nuget.org

Pré-requisitos

Ativar fontes upstream no seu feed

Se você não tiver um feed, siga estas etapas para criar um novo e marque a caixa de seleção fontes upstream para habilitá-los. Se você já tiver um feed, poderá ir para a próxima etapa para adicionar a Galeria NuGet como uma fonte upstream.

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

  2. Selecione Artefatos e, em seguida, selecione Criar feed para criar um novo feed.

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode visualizar os pacotes dentro do feed). Especifique o Escopo do seu feed e, se desejar incluir pacotes de fontes públicas, marque a caixa de seleção Fontes upstream.

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um feed de necessidades.

Nota

Por padrão, os feeds recém-criados têm o Serviço de Criação do projeto definido como Feed e Leitor Upstream (Colaborador).

Se você marcou a caixa de seleção fontes upstream ao criar seu feed, a Galeria NuGet deve ter sido adicionada automaticamente. Caso contrário, adicione-o manualmente seguindo estas etapas:

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

  2. Selecione Artefatos e, em seguida, selecione seu feed.

  3. Selecione o botão ícone de engrenagem do ícone de engrenagem para navegar até as configurações do Feed.

  4. Selecione Fontes Upstream e, em seguida, selecione Adicionar Upstream para adicionar uma nova fonte upstream.

  5. Selecione Fonte pública e, em seguida, selecione Galeria NuGet no menu suspenso.

  6. Selecione Guardarquando terminar e, em seguida, selecione Guardar mais uma vez no canto superior direito para guardar as alterações.

Nota

O local do índice de serviço para nuget.org é https://api.nuget.org/v3/index.json.

Ligar ao feed

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

  2. Selecione Artefatos e, em seguida, selecione seu feed.

  3. Selecione Ligar ao feed e, em seguida, selecione NuGet.exe.

  4. Adicione um arquivo nuget.config na mesma pasta que seu arquivo .csproj ou .sln . Cole o trecho XML fornecido em seu arquivo. Se você usar os exemplos abaixo, substitua os espaços reservados pelos valores apropriados para seu cenário.

    • Feed com escopo da organização:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

    • Feed com escopo do projeto:

      <?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <clear />
    <add key="<SOURCE_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
  </packageSources>
</configuration>

Com nosso projeto agora configurado para autenticar com nosso feed, agora podemos continuar a instalar pacotes da Galeria NuGet upstream. Neste exemplo, instalaremos a biblioteca de log de diagnóstico Serilog :

  1. Navegue até a Galeria NuGet em https://www.nuget.org/.

  2. Procure o pacote Serilog e selecione-o para navegar até a página de detalhes.

  3. Selecione a guia Gerenciador de Pacotes e copie o comando. No nosso exemplo, o comando é o seguinte:

    NuGet\Install-Package Serilog -Version 3.1.2-dev-02097

  4. Abra seu projeto no Visual Studio e selecione Ferramentas>NuGet Package Manager Package Manager>Console para abrir a janela do console.

  5. Cole o comando na janela Console do Gerenciador de Pacotes e pressione Enter para instalar o pacote.

Nota

Para salvar pacotes de upstreams, você deve ter a função Feed e Upstream Reader (Colaborador) ou superior. Para obter mais informações, consulte Permissões.

Ver pacotes guardados

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

  2. Selecione Artefatos e, em seguida, selecione seu feed no menu suspenso.

  3. Selecione a fonte da Galeria NuGet no menu suspenso para filtrar pacotes desse upstream.

  4. O pacote Serilog , instalado na etapa anterior, já está disponível em nosso feed. Os Artefatos do Azure salvaram automaticamente uma cópia em nosso feed quando executamos o comando install.

    Uma captura de tela mostrando o pacote que foi salvo do upstream.