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

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Com os Artefatos do Azure, você pode publicar seus pacotes NuGet em feeds públicos e privados, permitindo compartilhá-los com outras pessoas com base nas configurações de visibilidade do seu feed. Este artigo irá guiá-lo através da conexão com seu feed de Artefatos do Azure e publicação e restauração de seus pacotes NuGet.

Pré-requisitos

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

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

• Provedor de credenciais do Azure Artifacts.

• A versão mais recente do NuGet.

Conectar-se ao feed

1. Entre na sua organizaçã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, em seguida, selecione NuGet.exe no painel de navegação esquerdo.

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

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

Publicar pacotes

Execute o comando a seguir para publicar seus pacotes no feed. Substitua os espaços reservados pelas informações relevantes:

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

Exemplo:

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

Observação

O ApiKey é necessário, mas você pode usar qualquer valor arbitrário ao enviar para os feeds do Azure Artifacts.

Publicar pacotes de fontes externas

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

2. Adicione a origem do pacote ao arquivo nuget.config . Isso adicionará seu PAT ao arquivo nuget.config . Armazene esse arquivo em um local seguro e certifique-se de não verificá-lo no controle do 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 seu pacote NuGet em seu feed:

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

Exemplo:

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 -src MySource -ApiKey AZ

Observação

Se sua organização estiver usando um firewall ou um servidor proxy, confirme se permite URLs de domínio e endereços IP do Azure Artifacts.

Restaurar pacotes

Execute o seguinte comando no diretório do projeto para restaurar os pacotes:

nuget.exe restore

Artigos relacionados

• Usar pacotes do NuGet.org
• Publicar pacotes no NuGet.org
• Publicar pacotes NuGet com o Azure Pipelines