Publique pacotes NuGet a partir da linha de comandos usando NuGet.exe

Serviços de DevOps do Azure | Azure DevOps Server | Azure DevOps Server 2022

Este artigo guia-o como ligar-se ao seu feed e publicar pacotes utilizando dois fluxos de autenticação: o Artefactos do Azure Credential Provider para feeds na sua própria organização, e um token de acesso pessoal (PAT) para feeds alojados numa organização diferente.

Pré-requisitos

  • An Azure DevOps organization.
  • An Azure DevOps project.
  • Um feed do Artefactos do Azure.
  • nuget.exe versão 4.8.0.5385 ou posterior. A Artefactos do Azure recomenda o NuGet 5.5.x ou versões posteriores para a melhor compatibilidade e fiabilidade.
  • Para publicar pacotes, deve ser um Feed Publisher (Contribuidor) ou superior.

Configurar o fornecedor de credenciais do Artefactos do Azure

O Artefactos do Azure Credential Provider permite a autenticação segura dos seus feeds Artefactos do Azure. Para o utilizar com o nuget.exe, tem primeiro de o adicionar ao caminho de pesquisa de plug-ins do NuGet. Para mais detalhes, consulte Instalação e descoberta de plugins. Depois de adicionar o plugin, siga os passos de instalação do seu sistema operativo:

Use um dos seguintes métodos para instalar o Artefactos do Azure Credential Provider:

Instalação manual

  1. Descarregue a versão mais recente Microsoft.NetFx48.NuGet.CredentialProvider.zip.

  2. Extraia o arquivo zip.

  3. Copie a netfx pasta do arquivo extraído para %UserProfile%/.nuget/plugins/. A netfx pasta é necessária para nuget.exe compatibilidade.

Instale usando o script auxiliar

Em alternativa, pode usar o script de ajuda automática para uma instalação simplificada. Certifique-se de que tem PowerShell 5.1 ou mais recente e depois execute:

iex "& { $(irm https://aka.ms/install-artifacts-credprovider.ps1) } -AddNetfx"

Para mais informações, consulte o repositório Artefactos do Azure Credential Provider.

Conectar-se a um feed

Antes de poderes publicar os teus pacotes, configura o teu projeto e liga-te ao teu feed da seguinte forma:

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

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

  3. Selecione Ligar ao feede, em seguida, selecione NuGet.exe no painel de navegação esquerdo.

  4. Adiciona um ficheiro nuget.config ao teu projeto, na mesma pasta do que o teu ficheiro .csproj ou .sln. Cole o trecho XML fornecido em seu arquivo. O trecho deve ter a seguinte aparência:

    • Feed com âmbito 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>
      
    • Feed com escopo de 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>
      
  1. Entre no servidor de DevOps do Azure e navegue até o projeto.

  2. Selecione Artefatose, em seguida, selecione o seu feed.

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

  4. Adicione um ficheiro nuget.config ao seu projeto, na mesma pasta que o seu ficheiro .csproj ou .sln, e depois cole o excerto de XML fornecido no seu ficheiro.

Publicar num feed da mesma organização

Depois de configurar nuget.config e autenticar usando o Artefactos do Azure Credential Provider, execute o seguinte comando para publicar um pacote no seu feed. Substituir os marcadores de posição pelos valores apropriados:

nuget push <PACKAGE_PATH> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -ApiKey <ANY_STRING>

Example:

nuget push MyPackage.5.0.2.nupkg -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ

Observação

O Artefactos do Azure Credential Provider trata da autenticação real para o push, mas o NuGet ainda requer um -ApiKey valor para aceitar o comando. Artefactos do Azure ignora o valor que forneces, por isso qualquer cadeia não vazia serve.

Publicar num feed de outra organização

Se o feed de destino estiver numa organização Azure DevOps diferente, crie um PAT nessa organização e adicione o feed como fonte no seu nuget.config ficheiro.

  1. Crie um token de acesso pessoal (PAT) na organização de destino com o âmbito Empacotamento>.

  2. Execute o comando seguinte para adicionar o feed como fonte. Este comando adiciona o seu PAT ao nuget.config, por isso guarde o ficheiro em segurança e não o adicione ao controlo de código-fonte.

    nuget sources Add -Name <SOURCE_NAME> -Source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json -UserName <USER_NAME> -Password <PERSONAL_ACCESS_TOKEN> -config <PATH_TO_NUGET_CONFIG_FILE>
    
  3. Publique o pacote usando o nome de origem que acabou de adicionar.

    nuget push <PACKAGE_PATH> -Source <SOURCE_NAME> -ApiKey <ANY_STRING>
    

Example:

nuget sources Add -Name "MySource" -Source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json -UserName MyUserName -Password YourPersonalAccessToken -config ./nuget.config
nuget push nupkgs/mypackage.1.1.8.nupkg -Source MySource -ApiKey AZ

Observação

Se a sua organização utilizar um firewall ou servidor proxy, autorize os URLs de domínio e endereços IP do Artefactos do Azure.

Troubleshooting

O prompt de autenticação não aparece

Certifique-se de que o Artefactos do Azure Credential Provider está instalado e que está a usar a versão 4.8.0.5385 NuGet ou posterior. Para os passos de configuração, consulte Ligar aos feeds do Artefactos do Azure com o NuGet.exe.

A publicação falha porque a versão já existe

As versões dos pacotes no Artefactos do Azure são imutáveis. Depois de publicar uma versão, não pode sobrescrevê-la nem reutilizar o mesmo número de versão, mesmo que apague o pacote. Atualiza a versão do pacote, reconstrói o pacote e depois publica-o novamente.

A publicação falha atrás de um firewall ou proxy

Permita os URLs de domínio e endereços IP do Artefactos do Azure e, em seguida, tente novamente a operação de publicação.

A publicação falha com um erro 403

Este erro normalmente significa que a sua conta não tem permissões de publicação no feed. Precisa de, pelo menos, a função Publicador de feed (Contribuidor) para publicar pacotes. Peça ao proprietário do feed para atualizar a sua função e tente novamente.