Partilhar via

Conectar aos feeds de artefatos do Azure (dotnet)

  • Artigo

Serviços de DevOps do Azure | 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 que possa compartilhá-los com outras pessoas de forma privada ou pública com base nas configurações de visibilidade do seu feed. Este guia irá orientá-lo na configuração do seu projeto para autenticar-se no feed do Azure Artifacts usando a interface de linha de comando dotnet.

Pré-requisitos

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

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

  • Descarregue e instale o provider de credenciais .

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

Conectar ao feed

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

  2. Selecione Conectar ao feede, em seguida, selecione dotnet na secçã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 o arquivonuget.config. A estrutura do seu ficheiro deve ser semelhante a esta:

    • Feed com escopo de projeto:

      <?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 de âmbito organizacional:

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

  2. Selecione Artefactose, em seguida, selecione o seu feed no menu suspenso.

  3. Selecione Ligar ao Feede, em seguida, selecione dotnet no painel de navegação esquerdo.

  4. Siga as instruções na seção de configuração do Project para configurar seu arquivo de 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 do NuGet com a entidade de serviço

Para autenticar com uma entidade de serviço, deve primeiro instalar o Artifacts Credential Provider.

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 do assunto ou o caminho do arquivo do certificado da entidade de serviço. (Apenas um é necessário entre o nome do assunto do certificado ou o 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>"
        }
    ]
}
'@