Koneksi ke umpan Artefak Azure (NuGet.exe)

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

Azure Artifacts memungkinkan pengembang menerbitkan dan mengunduh paket NuGet dari berbagai sumber, termasuk umpan dan registri publik. Anda dapat menggunakan umpan Azure Artifacts privat untuk berbagi paket secara privat dengan tim atau pengguna tertentu. Selain itu, Anda dapat membuat umpan publik untuk membuat paket dapat diakses secara publik, memungkinkan Anda untuk membagikannya secara terbuka dengan siapa pun di internet. Artikel ini akan memandu Anda menyambungkan ke umpan Azure Artifacts 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 .

• Instal versi NuGet terbaru.

• Instal Penyedia Kredensial Azure Artifacts.

Penyusunan proyek

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

4. Jika ini pertama kalinya Anda menggunakan Azure Artifacts dengan NuGet.exe, pastikan Anda telah menginstal prasyarat, jika tidak, pilih Dapatkan alat di sudut kanan atas untuk menginstalnya.

5. Tambahkan file nuget.config ke proyek Anda, letakkan di folder yang sama dengan file csproj atau sln Anda, lalu tempelkan cuplikan yang disediakan ke dalamnya. Cuplikan harus disusun seperti ini:

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

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

Penting

Penyedia Kredensial Azure Artifacts memerlukan NuGet 4.8.0.5385 atau yang lebih tinggi.

Untuk performa optimal, Azure Artifacts merekomendasikan penggunaan versi NuGet atau yang 5.5.x lebih baru karena mencakup perbaikan bug penting yang terkait dengan pembatalan dan batas waktu.

Penyiapan proyek warisan

Jika Anda menggunakan versi NuGet yang lebih lama, ikuti petunjuk di bawah ini untuk menyambungkan ke umpan Anda:

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

4. Salin URL sumber Anda, lalu ganti /v3/index.json dengan /v2. URL sumber yang diperbarui akan menyerupai berikut ini:

   • Umpan cakupan proyek:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

   • Umpan cakupan organisasi:

     https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v2
     

5. Buat Token Akses Pribadi, dan pastikan Anda melingkupinya ke organisasi yang tepat yang ingin Anda akses dan pilih salah satu cakupan berikut: Kemasan (baca), Kemasan (baca dan tulis), atau Kemasan (baca, tulis, dan kelola).

6. Jalankan perintah berikut di jendela prompt perintah untuk menambahkan sumber umpan Anda ke file nuget.config Anda:

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <ANY_STRING_BUT_NOT_NULL> -password <YOUR_PERSONAL_ACCESS_TOKEN>
   

7. Jika organisasi Anda tersambung ke ID Microsoft Entra, Anda harus terlebih dahulu mengautentikasi dengan kredensial AD Anda lalu menambahkan token akses pribadi Anda menggunakan perintah setapikey :

   nuget sources add -name <FEED_NAME> -source <SOURCE_URL> -username <AZURE_ACTIVE_DIRECTORY_USERNAME> -password <AZURE_ACTIVE_DIRECTORY_PASSWORD>
   
   nuget setapikey <YOUR_PERSONAL_ACCESS_TOKEN> -source <SOURCE_URL> 
   

Artikel terkait

• Menerbitkan dan memulihkan paket NuGet (NuGet.exe)
• Menerbitkan paket NuGet dengan Azure Pipelines
• Menggunakan paket dari NuGet.org