Compartilhar via


Conectar-se aos feeds do Azure Artifacts (dotnet)

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Usando o Azure Artifacts, você pode publicar perfeitamente seus pacotes NuGet nos feeds do Azure Artifacts para compartilhá-los com outras pessoas de forma privada ou pública com base nas configurações de visibilidade do feed. Este guia orientará você na configuração do projeto para autenticar com o feed do Azure Artifacts usando a interface de linha de comando do dotnet.

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.

  • Baixe e instale o provedor de credenciais .

  • Baixe e instale o SDK do .NET Core (2.1.400+).

Conectar-se ao feed

  1. Selecione Artefatos e, em seguida, selecione o feed no menu suspenso.

  2. Selecione Conectar-se ao feed e, depois, dotnet na seção NuGet.

    Uma captura de tela mostrando como se conectar a um feed com dotnet.

  3. Siga as instruções na configuração do Projeto para configurar seu arquivo nuget.config. A estrutura do arquivo deve ser semelhante a esta:

    • Feed do projeto com escopo:

      <?xml version="1.0" encoding="utf-8"?>
      <configuration>
        <packageSources>
          <clear />
          <add key="<FEED_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="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
        </packageSources>
      </configuration>
      
  1. Entre em sua coleçã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 selecione dotnet no painel de navegação esquerdo.

  4. Siga as instruções na seção Configuração do projeto para configurar o arquivo nuget.config e conectar-se ao seu feed.

    Uma captura de tela mostrando como se conectar a um feed com dotnet no Azure DevOps Server 2020 e 2022.

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>"
        }
    ]
}
'@