Usar pacotes da Galeria do NuGet

Azure DevOps Services | 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 orientará você pelo processo de configuração do projeto e pelo uso da linha de comando para consumir efetivamente pacotes NuGet da Galeria NuGet. Neste artigo, você aprenderá a:

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

Pré-requisitos

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

• Um feed do Azure Artifacts.

• Baixe o NuGet.

• Baixe e instale o Provedor de Credenciais do Azure Artifacts.

Ativar fontes upstream em seu feed

Se você ainda não criou um feed, siga as etapas abaixo para criar um novo e certifique-se de marcar a caixa de seleção de fontes upstream para ativá-los. Se você já tiver um feed, prossiga para a próxima etapa para adicionar a Galeria NuGet como uma fonte upstream.

1. Entre na sua organização do Azure DevOps e vá para o projeto.

2. Selecione Artefatos e, em seguida, selecione Criar Feed.

3. Em Nome, insira um nome descritivo para seu feed.

   Em Visibilidade, selecione uma opção para indicar quem pode visualizar os pacotes no feed.

   Se você quiser incluir pacotes de fontes públicas, marque a caixa de seleção em Fontes upstream.

   Em Escopo, especifique se o escopo do feed é o projeto ou a organização.

4. Selecione Criar quando terminar.

   

Observação

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

Adicionar fonte de upstream da Galeria do NuGet

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

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

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

3. Selecione o botão 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 Adicionar quando terminar e, em seguida, selecione Salvar mais uma vez no canto superior direito para salvar suas alterações.

Conectar-se ao feed

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

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

3. Selecione Conectar ao feed e selecione NuGet.exe.

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

   • Feed no 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 no 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>
     

Instalar pacotes da Galeria do NuGet

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 do NuGet em https://www.nuget.org/.

2. Pesquise 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. Em 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>Gerenciador>de Pacotes NuGet Console do Gerenciador de Pacotes para abrir a janela do console.

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

Observação

Para salvar pacotes de upstreams, você deve ter a função Feed e Leitor Upstream (Colaborador) ou superior. Consulte Gerenciar permissões para obter mais detalhes.

Exibir pacotes salvos

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

2. Selecione Artefatos e, em seguida, selecione o 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. O Azure Artifacts salvou automaticamente uma cópia em nosso feed quando executamos o comando de instalação.

   

Artigos relacionados

• Publicar pacotes NuGet com o Azure Pipelines
• Publicar pacotes no NuGet.org
• Gerenciar permissões