Conectar-se a feeds de Artefatos do Azure (NuGet.exe)

  • 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 várias fontes, incluindo feeds e registros públicos. Você pode usar feeds privados do Azure Artifacts para compartilhar pacotes de forma privada com sua equipe ou usuários específicos. Além disso, você pode criar feeds públicos para tornar os pacotes acessíveis publicamente, permitindo que você os compartilhe abertamente com qualquer pessoa na internet. Este artigo irá guiá-lo através da conexão com seu feed de Artefatos do Azure.

Pré-requisitos

Configuração do projeto

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

  4. Se esta for sua primeira vez usando o Azure Artifacts com NuGet.exe, verifique se você instalou os pré-requisitos, caso contrário, selecione Obter as ferramentas no canto superior direito para instalá-las.

  5. Adicione um arquivo nuget.config ao seu projeto, coloque-o na mesma pasta que o arquivo csproj ou sln e cole o trecho fornecido nele. O trecho deve ser estruturado da seguinte forma:

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

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

  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 no painel de navegação esquerdo.

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

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

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

  3. Selecione Conectar ao Feed e, em seguida, selecione NuGet no painel de navegação esquerdo.

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

Importante

O Provedor de Credenciais de Artefatos do Azure requer NuGet 4.8.0.5385 ou superior.

Para obter o desempenho ideal, o Azure Artifacts recomenda o uso da versão 5.5.x NuGet ou posterior, pois inclui correções de bugs cruciais relacionadas a cancelamentos e tempos limites.

Configuração de projetos legados

Se você estiver usando uma versão mais antiga do NuGet, siga as instruções abaixo para se conectar ao seu feed:

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

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

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

  4. Copie o URL de origem e substitua /v3/index.json por /v2. O URL de origem atualizado deve ser semelhante ao seguinte:

    • Feed com escopo do projeto:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2

    • Feed com escopo da organização:

      https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2

  5. Crie um Token de Acesso Pessoal e certifique-se de escoplá-lo para a organização certa que deseja acessar e selecione um dos seguintes escopos: Empacotamento (leitura), Empacotamento (leitura e gravação) ou Empacotamento (leitura, gravação e gerenciamento).

  6. Execute o seguinte comando em uma janela de prompt de comando para adicionar a origem do feed ao arquivo nuget.config :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>

  7. Se sua organização estiver conectada ao Microsoft Entra ID, você deverá primeiro autenticar com suas credenciais do AD e, em seguida, adicionar seu token de acesso pessoal usando o comando setapikey :

    nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>

nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL>