Publicar e restaurar pacotes NuGet a partir da linha de comando (dotnet)

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

Os Artefatos do Azure permitem que você publique e restaure seus pacotes NuGet de e para seu feed, permitindo que você os compartilhe com outras pessoas de acordo com as configurações de visibilidade do seu feed. Este guia orienta você na configuração do seu projeto para publicar ou restaurar pacotes 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 , caso ainda não o tenha feito.

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

• Baixe e instale o Provedor de Credenciais de Artefatos do Azure.

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

Ligar ao feed

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

2. Selecione Conectar ao feed e, em seguida, selecione dotnet na seção NuGet à esquerda.

3. Crie um arquivo nuget.config na mesma pasta que seu arquivo csproj ou sln . Copie o seguinte trecho XML e cole-o em seu novo arquivo, substituindo os espaços reservados pelas informações relevantes:

• Feed com escopo da organização:

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

• Feed com escopo do 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>
  

Publicar pacotes

Execute o seguinte comando para publicar um pacote no seu feed. Substitua os espaços reservados pelas informações apropriadas:

dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH> 

Exemplo: dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg

Nota

O api-key é usado apenas como um espaço reservado.

Publicar pacotes de fontes externas

1. Crie um token de acesso pessoal (PAT) com escopo de leitura e gravação de empacotamento.

2. Substitua o espaço reservado <PERSONAL_ACCESS_TOKEN> pelo seu token de acesso pessoal e execute o seguinte comando para adicionar a origem do pacote ao arquivo nuget.config . Isto adiciona a sua PAT ao seu nuget.config. Certifique-se de armazenar esse arquivo com segurança e não verificá-lo no controle do código-fonte.

   dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>
   

3. Publique o seu pacote:

   dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
   

Exemplo: dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.configdotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg

Nota

Se a sua organização estiver a utilizar uma firewall ou um servidor proxy, certifique-se de que permite os URLs e endereços IP do Domínio de Artefactos do Azure.

Restaurar pacotes

Execute o seguinte comando para restaurar seus pacotes. O --interactive sinalizador é usado para solicitar credenciais ao usuário:

dotnet restore --interactive

Artigos relacionados

• Conectar-se a feeds de Artefatos do Azure (NuGet.exe)
• Publicar pacotes com o Azure Pipelines (YAML/Classic)
• Usar pacotes da Galeria NuGet