Compartilhar via

Conectar-se aos feeds do Azure Artifacts (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 privadamente com sua equipe ou usuários específicos. Além disso, você pode criar feeds públicos para tornar os pacotes publicamente acessíveis, permitindo compartilhá-los abertamente com qualquer pessoa na Internet. Este artigo orientará você durante a conexão com o feed do Azure Artifacts.

Pré-requisitos

  • Uma organização do Azure DevOps e um projeto. Crie uma organização ou um projeto se ainda não tiver feito isso.

  • Um feed do Azure Artifacts. Criar um novo feed se você ainda não tiver um.

  • Instale a versão mais recente do NuGet .

  • Instale o provedor de credenciais Azure Artifacts.

Configuração do projeto

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

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

  3. Selecione Conectar para alimentare 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á-los.

  5. Adicione um arquivo nuget.config ao seu projeto; coloque-o na mesma pasta que seu arquivo csproj ou sln, em seguida, cole o snippet fornecido dentro dele. O snippet deve ser estruturado da seguinte maneira:

    • Feed do projeto com escopo:

      <?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 da organização com escopo:

      <?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 do Azure DevOps e navegue até o projeto.

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

  3. Selecione Conectar ao Feede 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 do Azure DevOps e navegue até o projeto.

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

  3. Selecione Conectar ao Feed e 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 do Azure Artifacts requer NuGet 4.8.0.5385 ou superior.

Para obter um desempenho ideal, o Azure Artifacts recomenda usar a versão do NuGet 5.5.x ou posterior, pois inclui correções de bug cruciais relacionadas a cancelamentos e tempos limite.

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

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

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

  3. Selecione Conectar para alimentare selecione NuGet.exe no painel esquerdo.

  4. Copie a URL de origem e substitua /v3/index.json por /v2. A URL de origem atualizada deve ser semelhante à seguinte:

    • Feed do projeto com escopo:

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

    • Feed da organização com escopo:

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

  5. Crie um token de acesso pessoal e verifique se você o definiu 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 seu 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 à ID do Microsoft Entra, primeiro você deverá 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>

Autenticar o feed NuGet com a Entidade de Serviço

Para autenticar com uma entidade de serviço, primeiro você deve instalar o Provedor de Credenciais Artifacts.

Defina a variável de ambiente ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS conforme mostrado abaixo, especificando a URL do feed, a ID do aplicativo (cliente) da entidade de serviço e o nome da entidade ou o caminho do arquivo do certificado da entidade de serviço. (Apenas um deles é necessário entre o nome da entidade do certificado ou do caminho do arquivo.)

No PowerShell, insira o código a seguir.

$env:ARTIFACTS_CREDENTIALPROVIDER_FEED_ENDPOINTS = @'{
    "endpointCredentials": [
        {
            "endpoint": "<FEED_URL>",
            "clientId": "<SERVICE_PRINCIPAL_APPLICATION_(CLIENT)_ID>",
            "clientCertificateSubjectName": "<SERVICE_PRINCIPAL_CERTIFICATE_NAME>",
            "clientCertificateFilePath": "<SERVICE_PRINCIPAL_CERTIFICATE_PATH>"
        }
    ]
}
'@