Bagikan melalui


Menerbitkan dan mengunduh paket NuGet dengan Azure Artifacts

Layanan Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Azure Artifacts memungkinkan pengembang menerbitkan dan mengunduh paket NuGet dari umpan atau registri publik. Umpan dapat bersifat privat, memungkinkan Anda berbagi paket dengan pengguna tertentu, atau publik, membuat paket Anda dapat diakses oleh siapa saja di internet.

Artikel ini memandu Anda membuat umpan, mengonfigurasi proyek Anda, dan menerbitkan dan mengunduh paket NuGet.

Prasyarat

Produk Persyaratan
Azure DevOps - Sebuah organisasi Azure DevOps .
- Proyek Azure DevOps.
- Unduh dan instal Penyedia Kredensial Azure Artifacts.
- Instal versi NuGet terbaru.

Membuat umpan

  1. Masuk ke organisasi Azure DevOps Anda dan navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih Buat Kanal.

  3. Berikan Nama untuk umpan Anda, pilih opsi Visibilitas yang menentukan siapa yang dapat melihat paket Anda, periksa Sertakan paket dari sumber publik umum jika Anda ingin menyertakan paket dari sumber seperti nuget.org atau npmjs.com, dan untuk Cakupan, putuskan apakah umpan harus dicakup ke proyek Anda atau seluruh organisasi.

  4. Pilih Buat setelah selesai.

    Cuplikan layar yang memperlihatkan pilihan untuk membuat umpan baru di Azure DevOps Services.

  1. Masuk ke server Azure DevOps Anda, lalu buka proyek Anda.

  2. Pilih Artefak, lalu pilih Buat Kanal.

  3. Berikan Nama untuk umpan Anda, pilih opsi Visibilitas yang menentukan siapa yang dapat melihat paket Anda, periksa Sertakan paket dari sumber publik umum jika Anda ingin menyertakan paket dari sumber seperti nuget.org atau npmjs.com, dan untuk Cakupan, putuskan apakah umpan harus dicakup ke proyek Anda atau seluruh organisasi.

  1. Pilih Buat setelah selesai.

    Cuplikan layar yang memperlihatkan pilihan untuk membuat umpan baru di Azure DevOps 2022.

Catatan

Secara default, Layanan Build untuk proyek (misalnya: projectName Build Service (orgName)) diberi peran Umpan dan Pembaca Upstream (Kolaborator) saat umpan baru dibuat.

Menyambung ke umpan

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

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

  3. Pilih Sambungkan ke umpan, lalu pilih NuGet.exe dari panel navigasi kiri. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan Nuget.exe, pastikan Anda telah menginstal prasyarat.

  4. Ikuti instruksi yang disediakan di bawah bagian Penyiapan proyek untuk menyiapkan file nuget.config Anda dan menyambungkan ke umpan Azure Artifacts Anda.

    Cuplikan layar yang menampilkan cara menyiapkan proyek Anda dan menyambungkan ke umpan Anda di Azure DevOps Services.

  1. Masuk ke server Azure DevOps Anda, lalu buka proyek Anda.

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

  3. Pilih Sambungkan ke umpan, lalu pilih NuGet.exe dari panel navigasi kiri.

  4. Ikuti instruksi yang disediakan di bawah bagian Penyiapan proyek untuk menyiapkan file nuget.config Anda dan menyambungkan ke umpan Azure Artifacts Anda.

    Cuplikan layar yang menampilkan cara menyiapkan proyek Anda dan menyambungkan ke umpan Anda di Azure DevOps Server 2020 dan 2022.

Rilis paket ke saluran Anda

Untuk menerbitkan paket ke umpan Anda, jalankan perintah berikut. Parameter ApiKey diperlukan, tetapi Anda dapat menggunakan string arbitrer apa pun sebagai nilainya.

nuget.exe push -Source <SOURCE_NAME> -ApiKey key <PACKAGE_PATH>

Contoh

  • Umpan lingkup proyek

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/MyProject/_packaging/MyFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    
  • Umpan lingkup organisasi:

    nuget.exe push -Source https://pkgs.dev.azure.com/myOrganization/_packaging/myFeed/nuget/v3/index.json -ApiKey AZ release/myDemoPackage.1.0.0.nupkg
    

Catatan

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

Mengunduh paket dari umpan Anda

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

nuget.exe restore

Catatan

Mencari paket di sumber upstream menggunakan NuGet Package Explorer tidak didukung.