Share via


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 diferentes fontes, como feeds e registros públicos. Com os Artefatos do Azure, você pode criar feeds que podem ser privados, permitindo que você compartilhe pacotes com sua equipe e usuários específicos, ou públicos, permitindo que você os compartilhe abertamente com qualquer pessoa na Internet.

Neste artigo, você aprenderá a:

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

Pré-requisitos

Criar Feed

  1. Entre na 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 exibir 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 Códigos-fonte upstream.

  4. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed nos Serviços de DevOps do Azure.

  1. Entre no servidor de DevOps do Azure e navegue até o 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 exibir 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 Códigos-fonte upstream.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2022.

  1. Selecione Criar quando terminar.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2020.

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

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

  3. Insira um Nome descritivo para seu feed e defina sua Visibilidade (indicando quem pode exibir pacotes dentro do feed). Se você deseja 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.

    Uma captura de tela mostrando como criar um novo feed no Azure DevOps 2019.

Observação

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

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 no menu suspenso.

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

    Uma captura de tela mostrando o botão conectar ao feed.

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

    Uma captura de tela mostrando como configurar seu projeto.

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

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

  3. Selecione Conectar ao Feed e selecione NuGet.exe à esquerda.

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

    Uma captura de tela mostrando como configurar seu projeto NuGet no Server 2020 e no Server 2022.

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

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

  3. Selecione Conectar ao Feed e selecione NuGet à esquerda.

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

    Uma captura de tela mostrando como configurar seu projeto NuGet no Server 2019.

Baixar os pacotes

1. Obtenha a URL de origem do pacote

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

  2. Selecione Artefatos, selecione seu feed no menu suspenso e selecione Conectar ao feed.

  3. Selecione NuGet à esquerda e copie o URL de origem do pacote.

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

  2. Selecione Artefatos, selecione seu feed no menu suspenso e selecione Conectar ao feed.

  3. Selecione Visual Studio no painel de navegação esquerdo e copie a URL de origem .

    Uma captura de tela mostrando o URL de origem.

2. Configurar o Visual Studio

  1. No Visual Studio, selecione Ferramentas e, em seguida , Opções.

  2. Expanda a seção Gerenciador de Pacotes NuGet e selecione Códigos-fonte do pacote.

  3. Insira o Nome do feed e a URL de origem e selecione o sinal verde (+) para adicionar uma origem.

  4. Se você ativou fontes upstream em seu feed, desmarque a caixa de seleção nuget.org.

  5. Selecione OK ao concluir.

    Uma captura de tela mostrando como configurar o estúdio visual no Windows.

3. Baixar pacotes

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

  2. Selecione Procurar e, em seguida, selecione seu feed no menu suspenso Origem do pacote.

    Uma captura de tela mostrando como selecionar a origem do pacote no Visual Studio.

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

Observação

Não há suporte para o uso do Gerenciador de Pacotes NuGet para procurar pacotes em códigos-fonte upstream.

Publicar pacotes

Execute o seguinte comando para publicar o pacote no feed. Você pode inserir qualquer cadeia de caracteres para o argumento ApiKey .

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