Introdução aos pacotes NuGet no Azure Artifacts

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server | 2019 TFS 2018

O Azure Artifacts permite que os desenvolvedores publiquem e baixem pacotes NuGet de diferentes fontes, como feeds e registros públicos. Os feeds de artefato podem ser privados para compartilhar seus pacotes com sua equipe e usuários específicos ou públicos para compartilhá-los publicamente com qualquer pessoa na Internet.

Neste artigo, você aprenderá o seguinte:

  • Como criar um novo feed
  • Como configurar seu projeto e se conectar ao feed
  • Como publicar pacotes NuGet no feed
  • Como baixar pacotes NuGet do feed

Pré-requisitos

Criar um feed

Você pode criar dois tipos de feeds: feeds com escopo de projeto e no escopo da organização. Todos os feeds públicos têm como escopo seu projeto de hospedagem e herdam suas configurações de visibilidade.

  1. Selecione Artefatos e selecione Criar Feed.

    Botão Criar um feed

  2. Dê um nome ao feed e escolha sua visibilidade (quem pode exibir pacotes neste feed), fontes upstream e escopo (no escopo do projeto ou no escopo da organização).

    Caixa de diálogo Novo feed

  3. Selecione Criar quando terminar.

Observação

Por padrão, o Serviço de Build da Coleção de Projetos (com escopo de organização) e o Serviço de Build no nível do projeto (com escopo de projeto) são definidos como Colaborador quando você cria um novo feed.

O Azure Artifacts vem pré-instalado no TFS 2018. Se essa for a primeira vez que você usa o feed, talvez seja solicitado que você atribua uma licença

  1. Vá para Compilar & Versão e selecione Pacotes.

    Ir para o TFS do Azure Artifacts

  2. Selecione + Novo feed.

    Novo botão de feed TFS

  3. Dê ao feed um nome, uma descrição e configure quem pode ler, quem pode contribuir e se você quiser incluir pacotes externos.

    Caixa de diálogo Novo Feed TFS

  4. Selecione Criar quando terminar.

Conectar-se ao feed

  1. No projeto, selecione Artefatos e selecione o feed.

  2. Selecione Connect to feed.

    Conectar-se ao feed

  3. Selecione NuGet.exe.

     conexão de feed deNuGet.exe

  4. Se esta for a primeira vez que usar o Azure Artifacts com Nuget.exe, selecione Obter as ferramentas e siga as instruções para:

    1. Instale a versão mais recente do NuGet.
    2. Instale o Provedor de Credenciais do Azure Artifacts.
  5. Siga as instruções na configuração do Project para adicionar um arquivo nuget .config.

    Configuração do projeto

  1. Selecione Compilar e Liberar>Pacotes.

  2. Selecione o feed no menu suspenso.

  3. Selecione Connect to feed.

    Conectar-se ao feed – TFS

  4. Selecione NuGet e siga as instruções para se conectar ao feed.

    Conectar-se ao feed do NuGet – TFS

Publicar pacotes do NuGet

Execute o comando a seguir em uma janela de prompt de comando com privilégios elevados para configurar seu arquivo nuget.config e publicar seu pacote NuGet no feed. Consulte fontes de nuget e push do nuget para obter mais detalhes:

nuget sources add -Name <SourceName> -Source <SourceURL> -username <UserName> -password <Pat>
nuget push -Source <SourceName> -ApiKey key <PackagePath>

Se você não tiver um pacote NuGet, mas quiser tentar publicar pacotes no feed, instale o pacote de exemplo do HelloWorld da seguinte maneira:

nuget install HelloWorld -ExcludeVersion

Baixar pacotes NuGet

1. Obter a URL de origem do feed

  1. No projeto, selecione Artefatos e selecione o feed.

  2. Selecione Connect to feed.

    Conectar-se ao feed

  3. Selecione o Visual Studio na seção NuGet .

  4. Copie a URL de Origem do feed.

    Copiar URL de origem

  1. Selecione Compilar e Liberar e, em seguida, selecione Pacotes.

  2. Selecione o feed no menu suspenso.

  3. Selecione Connect to feed.

    Conectar-se ao feed

  4. Copie a URL de Origem do feed.

    Copiar URL de origem

2. Configurar o Visual Studio

  1. No Visual Studio, selecione Ferramentas e opções.

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

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

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

  5. Selecione OK.

    Configurar o Visual Studio: Windows

3. Baixar pacotes

  1. No Visual Studio, clique com o botão direito do mouse em seu projeto e selecione Gerenciar Pacotes NuGet.
  2. Selecione Procurar e selecione o feed no menu suspenso de origem do pacote . Selecionar origem do feed
  3. Use a barra de pesquisa para procurar pacotes do feed.

Observação

Não há suporte para pesquisar pacotes em upstreams com o Gerenciador de Pacotes NuGet.