Menerbitkan dan memulihkan paket NuGet dari baris perintah (NuGet.exe)

Layanan Azure DevOps | Azure DevOps Server 2022 - Azure DevOps Server 2019

Dengan Azure Artifacts, Anda dapat menerbitkan paket NuGet ke umpan publik dan privat, memungkinkan Anda membagikannya dengan orang lain berdasarkan pengaturan visibilitas umpan Anda. Artikel ini akan memandu Anda menyambungkan ke umpan Azure Artifacts Anda dan menerbitkan dan memulihkan paket NuGet Anda.

Prasyarat

• Organisasi Azure DevOps dan proyek. Buat organisasi atau proyek jika Anda belum melakukannya.

• Umpan Artefak Azure. Buat umpan baru jika Anda belum memilikinya .

• Penyedia Kredensial Azure Artifacts.

• Versi NuGet terbaru.

Hubungkan ke umpan

1. Masuk ke organisasi Azure DevOps Anda, lalu navigasikan ke proyek Anda.

2. Pilih Artefak, lalu pilih umpan Anda dari menu dropdown.

3. Pilih Koneksi untuk umpan, lalu pilih NuGet.exe dari panel navigasi kiri.

4. Tambahkan file nuget.config ke proyek Anda, di folder yang sama dengan file .csproj atau .sln Anda. Tempelkan cuplikan XML yang disediakan ke dalam file Anda. Cuplikan akan terlihat seperti berikut ini:

   • Umpan cakupan organisasi:

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

   • Umpan cakupan proyek:

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

Menerbitkan paket

Jalankan perintah berikut untuk menerbitkan paket Anda ke umpan Anda. Ganti tempat penampung dengan informasi yang relevan:

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

Contoh:

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

Catatan

ApiKey diperlukan, tetapi Anda dapat menggunakan nilai arbitrer apa pun saat mendorong ke umpan Azure Artifacts.

Menerbitkan paket dari sumber eksternal

1. Buat token akses pribadi (PAT) dengan cakupan baca dan tulis kemasan.

2. Tambahkan sumber paket Anda ke file nuget.config Anda. Ini akan menambahkan PAT Anda ke file nuget.config Anda. Simpan file ini di lokasi yang aman, dan pastikan Anda tidak memeriksanya ke kontrol sumber.

   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. Terbitkan paket NuGet Anda ke umpan Anda:

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

Contoh:

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

Catatan

Jika organisasi Anda menggunakan firewall atau server proksi, pastikan Anda mengizinkan URL dan alamat IP Domain Artefak Azure.

Memulihkan paket

Jalankan perintah berikut di direktori proyek Anda untuk memulihkan paket Anda:

nuget.exe restore

Artikel terkait

• Menggunakan paket dari NuGet.org
• Menerbitkan paket ke NuGet.org
• Menerbitkan paket NuGet dengan Azure Pipelines