Introdução aos pacotes NuGet no Azure Artifacts

  • Artigo

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:

  • Criar um novo feed
  • Configurar seu projeto e conectar-se ao seu feed
  • Publicar pacotes do NuGet
  • Baixar pacotes do seu feed

Pré-requisitos

Criar um feed

O Azure Artifacts oferece dois tipos de feeds: feeds com escopo de projeto e feeds com escopo de organização. Se você quiser criar um feed público, comece criando um feed com escopo de projeto e, em seguida, ajuste as configurações de visibilidade do projeto que hospeda seu feed para público. Isso efetivamente tornará seu feed com escopo de projeto acessível ao público.

  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 feed de necessidades.

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 Connect to feed.

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

  4. Selecione NuGet.exe. Se esta for a primeira vez que você usa o Azure Artifacts com Nuget.exe, verifique se você instalou todos os pré-requisitos.

  5. Siga as instruções fornecidas na seção Configuração do projeto para configurar o arquivo nuget.config.

    Uma captura de tela mostrando como configurar seu projeto.

Baixar os pacotes

1. Obtenha o URL de origem do feed

  1. Navegue até o projeto e, em seguida, selecione Artefatos e, em seguida, selecione seu feed.

  2. Selecione Conectar ao feed e, em seguida, selecione Visual Studio no painel de navegação esquerdo.

  3. Copie o 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 fonte do feed.

  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 upstreams.

Publicar pacotes

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

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