Memulihkan paket NuGet dengan Azure Pipelines

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

Dengan Pemulihan Paket NuGet, Anda dapat menginstal semua dependensi proyek tanpa harus menyimpannya di kontrol sumber. Ini memungkinkan lingkungan pengembangan yang lebih bersih dan ukuran repositori yang lebih kecil. Anda dapat memulihkan paket NuGet menggunakan tugas pemulihan NuGet, NuGet CLI, atau .NET Core CLI. Artikel ini akan menunjukkan kepada Anda cara memulihkan paket NuGet menggunakan Alur Klasik dan YAML.

Prasyarat

• Organisasi Azure DevOps. Buat organisasi, jika Anda belum memilikinya.
• Proyek Azure DevOps. Jika Anda belum memilikinya, Anda dapat membuat proyek baru.
• Umpan Artefak Azure. Buat umpan baru jika Anda belum memilikinya .
• Koneksi ke umpan Artefak Azure: NuGet.exe, dotnet.
• Siapkan izin alur Anda.

Memulihkan paket NuGet dari umpan

Klasik

1. Navigasi ke definisi alur klasik Anda, lalu pilih Edit.

2. Pilih + untuk menambahkan tugas baru. Cari NuGet, lalu pilih Tambahkan untuk menambahkan tugas ke alur Anda.

3. Beri nama tugas Anda dan pilih Pulihkan dari Perintah.

4. Pilih Umpan yang saya pilih di sini, dan pilih umpan Anda dari menu dropdown. Jika Anda ingin menggunakan file konfigurasi Anda sendiri, pilih Umpan di NuGet.config saya dan masukkan jalur ke file NuGet.config Anda dan koneksi layanan jika Anda ingin mengautentikasi dengan umpan di luar organisasi Anda.

5. Jika Anda ingin menyertakan paket dari NuGet.org, centang kotak Gunakan paket dari NuGet.org .

6. Pilih Simpan & antrean saat Anda selesai.

   

Catatan

Pemulihan NuGet klasik menggunakan tugas NuGetCommand@2 . Secara default, versi ini menggunakan NuGet 4.1.0. Gunakan tugas Penginstal Alat NuGet jika Anda ingin menggunakan versi NuGet yang berbeda.

YAML

- task: NuGetCommand@2
  displayName: NuGet v2 Restore
  inputs:
    command: restore                      
    restoreSolution: '**/*.sln'             ## Required when command = restore. Path to solution, packages.config, or project.json. Default: **/*.sln.
    feedsToUse: 'select'                    ## Required. Feeds to use. 'select' | 'config'. Alias: selectOrConfig. Default: select.
    vstsFeed: '<PROJECT_NAME>/<FEED_NAME>'  ## Required when feedsToUse == Select. Use packages from this Azure Artifacts feed. 
    includeNuGetOrg: true                   ## Use packages from upstream (NuGet.org)

Memulihkan paket NuGet secara lokal

Tempatkan Anda nuget.config di folder yang sama dengan file atau .slnAnda.csproj. File konfigurasi Anda akan terlihat mirip dengan contoh berikut:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <packageSources>
    <!-- remove inherited connection strings -->
    <clear />
    <!-- add an Azure Artifacts feed -->
    <add key="FabrikamFiber" value="https://pkgs.dev.azure.com/microsoftLearnModule/_packaging/FabrikamFiber/nuget/v3/index.json" />
    <!-- Get packages from NuGet.org -->
    <add key="nuget.org" value="https://api.nuget.org/v3/index.json" protocolVersion="3" />
  </packageSources>
</configuration>

Untuk memulihkan paket NuGet Anda, jalankan perintah berikut di direktori proyek Anda:

nuget.exe restore

Memulihkan paket NuGet dari umpan di organisasi yang berbeda

Untuk memulihkan paket NuGet dari umpan di organisasi Azure DevOps yang berbeda, Anda harus menggunakan token akses pribadi untuk mengautentikasi.

Membuat token akses pribadi

1. Navigasi ke organisasi Azure DevOps Anda, lalu pilih Pengaturan>pengguna Token Akses Pribadi.

   

2. Buat token akses pribadi dengan cakupan Packaging (baca) dan salin PAT Anda ke clipboard.

   

Memulihkan paket NuGet

Klasik

1. Navigasi ke definisi alur Anda dan pilih tugas pemulihan NuGet. Pastikan Anda menggunakan tugas versi 2.

   

2. Pilih Umpan dan autentikasi, lalu pilih Umpan di NuGet.config saya.

3. Pilih jalur file NuGet.config Anda.

4. Pilih Baru untuk menambahkan Kredensial untuk umpan di luar organisasi/koleksi ini.

   

5. Pilih Server Azure DevOps Eksternal, lalu masukkan URL umpan Anda (pastikan cocok dengan apa yang ada di NuGet.config), nama koneksi layanan Anda, dan token akses pribadi yang Anda buat sebelumnya. Pilih Simpan saat Anda selesai.

   

6. Pilih Simpan & antrean saat Anda selesai.

YAML

- task: NuGetCommand@2
  displayName: NuGet Restore
  inputs:
    restoreSolution: '**/*.sln'                     ## Required when command = restore. Path to your project's solution, packages.config, or project.json.
    feedsToUse: 'config'                            ## Required. 'select' | 'config'. Default: select.
    nugetConfigPath: 'Deployment/NuGet.config'      ## Required when selectOrConfig = config. Path to your nuget.config file.
    externalFeedCredentials: 'MyServiceConnection'  ## Use when selectOrConfig = config. The name of your service connection. Credentials for feeds outside your organization/collection.  

FAQ

T: Alur saya gagal memulihkan paket NuGet saya?

A: Tugas pemulihan NuGet dapat gagal karena beberapa alasan. Skenario yang paling umum adalah ketika Anda menambahkan proyek baru yang memerlukan kerangka kerja target yang tidak didukung oleh versi NuGet yang digunakan alur Anda. Kegagalan ini umumnya tidak terjadi di lingkungan pengembangan lokal karena Visual Studio mengurus pembaruan solusi Anda yang sesuai. Pastikan Anda meningkatkan tugas NuGet ke versi terbaru.

Artikel terkait

• Terbitkan ke umpan NuGet (YAML/Klasik)
• Menerbitkan dan mengonsumsi artefak build
• Cara mengurangi risiko saat menggunakan umpan paket privat