Bagikan melalui


Mulai Cepat: Mulai menggunakan paket NuGet di Azure Artifacts

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

Azure Artifacts memungkinkan pengembang menerbitkan dan mengunduh paket NuGet dari sumber seperti umpan dan registri publik. Dengan Azure Artifacts, Anda dapat membuat umpan yang:

  • Privat, sehingga Anda dapat berbagi paket dengan tim dan pengguna tertentu.
  • Publik, sehingga Anda dapat berbagi paket secara terbuka dengan siapa pun di internet.

Dalam panduan mulai cepat ini, Anda belajar cara:

  • Buat umpan baru.
  • Siapkan proyek Anda dan sambungkan ke umpan Anda.
  • Menerbitkan paket NuGet.
  • Unduh paket dari umpan Anda.

Prasyarat

Membuat umpan

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

  2. Pilih Artefak, lalu pilih Buat Umpan.

  3. Untuk Nama, masukkan nama deskriptif untuk umpan Anda.

    Untuk Visibilitas, pilih opsi untuk menunjukkan siapa yang dapat melihat paket dalam umpan.

    Jika Anda ingin menyertakan paket dari sumber publik, pilih kotak centang di bawah Sumber upstream.

    Untuk Cakupan, tentukan apakah cakupan umpan Anda adalah proyek atau 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 Umpan.

  3. Untuk Nama, masukkan nama deskriptif untuk umpan Anda.

    Untuk Visibilitas, pilih opsi untuk menunjukkan siapa yang dapat melihat paket dalam umpan.

    Jika Anda ingin menyertakan paket dari sumber publik, pilih kotak centang di bawah Sumber upstream.

    Untuk Cakupan, tentukan apakah cakupan umpan Anda adalah proyek atau organisasi.

  1. Pilih Buat setelah selesai.

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

  1. Pilih Buat setelah selesai.

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

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

  2. Pilih Artefak, lalu pilih Umpan baru.

  3. Untuk Nama, masukkan nama deskriptif untuk umpan Anda.

    Untuk Visibilitas, pilih opsi untuk menunjukkan siapa yang dapat melihat paket dalam umpan.

    Jika Anda ingin menyertakan paket dari sumber publik, pilih opsi Gunakan paket dari sumber publik melalui umpan ini.

  4. Pilih Buat setelah selesai.

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

Catatan

Secara default, umpan yang baru dibuat memiliki nilai Build Service proyek mereka yang diatur ke Umpan dan Pembaca Upstream (Kolaborator).

Menyambungkan 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 kiri. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan Nuget.exe, pastikan Anda menginstal semua prasyarat.

    Cuplikan layar yang memperlihatkan tombol untuk menyambungkan ke umpan.

  4. Ikuti instruksi di bagian Penyiapan proyek untuk mengonfigurasi file nuget.config Anda dan mengautentikasi dengan Azure Artifacts.

    Cuplikan layar yang memperlihatkan instruksi di layar untuk menyiapkan proyek.

  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 kiri.

  4. Ikuti instruksi di bagian Penyiapan proyek untuk menyambungkan ke umpan Anda.

    Cuplikan layar yang memperlihatkan instruksi di layar untuk menyiapkan proyek NuGet di Azure DevOps Server 2020 dan 2022.

  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 dari panel kiri.

  4. Ikuti instruksi untuk menambahkan URL sumber paket Anda ke nuget.config.

    Cuplikan layar yang memperlihatkan instruksi di layar untuk menyiapkan proyek NuGet di Azure DevOps Server 2019.

Mengunduh paket

1. Dapatkan URL sumber paket

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

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

  3. Pilih NuGet dari panel kiri, lalu salin nilai URL sumber Paket Anda.

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

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

  3. Pilih Visual Studio dari panel kiri, lalu salin URL Sumber Anda.

    Cuplikan layar yang memperlihatkan URL sumber.

2. Menyiapkan Visual Studio

  1. Di Visual Studio, pilih Opsi Alat>.

  2. Perluas bagian Pengelola Paket NuGet, lalu pilih Sumber Paket.

  3. Masukkan nilai Nama umpan dan URL Sumber, lalu pilih tanda plus hijau (+) untuk menambahkan sumber.

  4. Jika Anda mengaktifkan sumber upstream di umpan Anda, kosongkan kotak centang nuget.org .

  5. Pilih OK saat sudah selesai.

    Cuplikan layar yang memperlihatkan pilihan untuk menyiapkan Visual Studio di Windows.

3. Unduh paket

  1. Di Visual Studio, klik kanan proyek Anda, lalu pilih Kelola Paket NuGet.

  2. Pilih Telusuri, lalu pilih umpan Anda dari menu dropdown Sumber paket.

    Cuplikan layar yang memperlihatkan pilihan sumber paket di Visual Studio.

  3. Gunakan bilah pencarian untuk mencari paket dari umpan Anda.

Catatan

Menggunakan NuGet Package Explorer untuk mencari paket di sumber upstream tidak didukung.

Menerbitkan paket

Untuk menerbitkan paket Anda ke umpan Anda, jalankan perintah berikut. Anda dapat memasukkan string apa pun untuk ApiKey argumen .

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

Contoh:

  • Umpan cakupan 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 cakupan 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.