Compartilhar via


Início Rápido: Introdução aos pacotes NuGet no Azure Artifacts

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

O Azure Artifacts permite que os desenvolvedores publiquem e baixem pacotes NuGet de fontes como feeds e registros públicos. Com o Azure Artifacts, você pode criar feeds que são:

  • Privado, para que você possa compartilhar pacotes com sua equipe e usuários específicos.
  • Público, para que você possa compartilhar pacotes abertamente com qualquer pessoa na internet.

Neste guia de início rápido, você aprende a:

  • Criar um novo feed.
  • Configure seu projeto e conecte-se ao seu feed.
  • Publique pacotes NuGet.
  • Baixe pacotes do seu feed.

Pré-requisitos

Criar um feed

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

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

  3. Forneça um Nome para o feed, escolha a opção Visibilidade que define quem pode visualizar seus pacotes, marque Incluir pacotes de fontes públicas comuns se você quiser incluir pacotes de fontes como nuget.org ou npmjs.come, para Escopo, decida se o feed deve ser definido no escopo do seu projeto ou de toda a organização.

  4. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed em Azure DevOps Services.

  1. Entre no servidor Azure DevOps e vá para o projeto.

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

  3. Forneça um Nome para o feed, escolha a opção Visibilidade que define quem pode exibir seus pacotes, verifique Incluir pacotes de fontes públicas comuns se você quiser incluir pacotes de fontes como nuget.org ou npmjs.com e, para Escopo, decida se o feed deve ser definido como escopo para seu projeto ou toda a organização.

  1. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2022.

  1. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2020.

  1. Entre no servidor Azure DevOps e vá para o projeto.

  2. Selecione Artefatos e, em seguida, selecione Novo 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, selecione a opção Usar pacotes de fontes públicas por meio deste feed .

  4. Selecione Criar quando terminar.

    Captura de tela que mostra as seleções para criar um novo feed no Azure DevOps 2019.

Observação

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

Conectar-se a um feed

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

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

  3. Selecione Conectar ao Feed e, em seguida, selecione NuGet.exe no painel esquerdo. Se esta for a primeira vez que você usa o Azure Artifacts com Nuget.exe, verifique se você instalou todos os pré-requisitos.

    Captura de tela que mostra o botão para se conectar a um feed.

  4. Siga as instruções na seção Configuração do projeto para configurar o arquivo nuget.config e autenticar com o Azure Artifacts.

    Captura de tela que mostra instruções na tela para configurar um projeto.

  1. Entre no servidor Azure DevOps e vá para o projeto.

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

  3. Selecione Conectar ao Feed e, em seguida, selecione NuGet.exe no painel esquerdo.

  4. Siga as instruções na seção Configuração do projeto para se conectar ao seu feed.

    Captura de tela que mostra instruções na tela para configurar um projeto NuGet em Azure DevOps Server 2020 e 2022.

  1. Entre no servidor Azure DevOps e vá para o projeto.

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

  3. Selecione Conectar ao Feed e, em seguida, selecione NuGet no painel esquerdo.

  4. Siga as instruções para adicionar a URL de origem do pacote a nuget.config.

    Captura de tela que mostra instruções na tela para configurar um projeto NuGet em Azure DevOps Server 2019.

Baixar os pacotes

1. Obter a URL de origem do pacote

  1. Entre no servidor do Azure DevOps e navegue até o projeto.

  2. Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.

  3. Selecione NuGet no painel de navegação à esquerda, e copie a URL de origem do pacote .

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

  2. Selecione Artefatos, selecione o feed no menu suspenso e, em seguida, selecione Conectar ao feed.

  3. Selecione Visual Studio no painel de navegação à esquerda e copie sua URL de Origem.

    Uma captura de tela mostrando como localizar a URL de Origem do feed.

2. Configurar o Visual Studio

  1. No Visual Studio, selecione Ferramentas>Opções.

  2. Expanda a seção Gerenciador de Pacotes NuGet e selecione Fontes de Pacote.

  3. Insira o valor do Nome do feed e o URL de origem e clique no sinal de mais verde (+) para adicionar uma origem.

  4. Se você habilitou fontes upstream no feed, desmarque a caixa de seleção nuget.org.

  5. Selecione OK ao concluir.

    Uma captura de tela que mostra as seleções para configurar o Visual Studio no Windows.

3. Baixe pacotes

  1. No Visual Studio, clique com o botão direito do mouse no projeto e selecione Gerenciar Pacotes NuGet.

  2. Selecione Procurar e selecione o feed no menu suspenso Origem do pacote.

    Captura de tela que mostra a seleção de uma fonte de pacote no Visual Studio.

  3. Use a barra de pesquisa para pesquisar pacotes do seu feed.

Observação

Não há suporte para o uso do Explorador de Pacotes NuGet para pesquisar pacotes em fontes upstream.

Publicar pacotes

Para publicar seu pacote em seu feed, execute o comando a seguir. Você pode inserir qualquer cadeia de caracteres para o ApiKey argumento.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Exemplos:

  • Feed do projeto com escopo:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Feed da organização com escopo:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Observação

O ApiKey é necessário, mas você pode usar qualquer valor arbitrário ao publicar em feeds do Azure Artifacts.