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

Serviços de DevOps do Azure | 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 de Artefatos do Azure 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 ao público, permitindo que você os compartilhe abertamente com qualquer pessoa na internet. Este artigo irá guiá-lo através da ligação ao seu feed de Artefactos do Azure.

Pré-requisitos

• Uma organização e um projeto do Azure DevOps. Crie uma organização ou um projeto , caso ainda não o tenha feito.

• Um feed de Artefatos do Azure. Crie um novo feed se ainda não tiver um.

• Instale a versão mais recente do NuGet.

• Instale o Provedor de Credenciais de Artefatos do Azure.

Configuração do projeto

1. Entre em 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. Se esta for a primeira vez que utiliza os Artefactos do Azure com NuGet.exe, certifique-se de que instalou os pré-requisitos, caso contrário selecione Obter as ferramentas no canto superior direito para as instalar.

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 assim:

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

Importante

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

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

Configuração do projeto herdado

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

1. Entre em 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 defini-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 fonte 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ê deve 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> 
   

Artigos relacionados

• Publicar e restaurar pacotes NuGet (NuGet.exe)
• Publicar pacotes NuGet com o Azure Pipelines
• Use pacotes de NuGet.org