Bagikan melalui


Menerbitkan paket NuGet dari baris perintah (dotnet)

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

Panduan ini memandu Anda mengonfigurasi proyek Anda untuk menerbitkan paket NuGet menggunakan antarmuka baris perintah dotnet.

Prasyarat

Produk Persyaratan
Azure DevOps - Organisasi Azure DevOps .
- Proyek Azure DevOps .
- Umpan Azure Artefak.
- Unduh dan instal Penyedia Kredensial Azure Artifacts.
- Unduh dan instal .NET Core SDK (2.1.400+).

Sambungkan ke umpan

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

  2. Pilih Artefak, lalu pilih umpan Anda dari menu tarik turun.

  3. Pilih Hubungkan ke umpan, lalu pilih dotnet dari bagian NuGet di sebelah kiri.

  4. Buat file nuget.config di folder yang sama dengan file csproj atau file sln Anda. Salin cuplikan XML berikut dan tempelkan ke file baru Anda, ganti tempat penampung dengan informasi yang relevan:

  • Umpan cakupan organisasi:

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <packageSources>
        <clear />
        <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
      </packageSources>
    </configuration>
    
  • Umpan khusus proyek

    <?xml version="1.0" encoding="utf-8"?>
    <configuration>
      <packageSources>
        <clear />
        <add key="<FEED_NAME>" value="https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json" />
      </packageSources>
    </configuration>
    
  1. Masuk ke server Azure DevOps Anda, lalu navigasikan ke proyek Anda.

  2. Pilih Artefak, lalu pilih umpan Anda.

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

  4. Ikuti instruksi di bagian penyiapan Proyek untuk menyambungkan ke umpan Anda.

    Cuplikan layar yang menunjukkan cara menghubungkan ke umpan menggunakan dotnet di Azure DevOps Server 2020 dan 2022.

Nota

dotnet tidak didukung di Azure DevOps Server 2019.

Menerbitkan paket ke umpan di organisasi yang sama

Jalankan perintah berikut untuk menerbitkan paket ke umpan Anda. Gantikan placeholder dengan nilai yang tepat.

dotnet nuget push --source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --api-key <ANY_STRING> <PACKAGE_PATH> 

Contoh:

dotnet nuget push --source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --api-key AZ bin/MyPackage.5.0.2.nupkg

Nota

api-key diperlukan, tetapi Anda dapat memberikan string apa pun sebagai nilainya saat menerbitkan ke umpan Azure Artifacts.

Memublikasikan paket ke umpan di organisasi lain

Untuk menerbitkan paket NuGet Anda ke umpan di organisasi Azure DevOps yang berbeda, Anda harus terlebih dahulu membuat token akses pribadi (PAT) di organisasi target.

  1. Buka organisasi yang menghosting umpan target dan buat token akses pribadi (PAT) dengan Packaging>Read & write cakupan.

  2. Ganti tempat penampung <PERSONAL_ACCESS_TOKEN> dengan token akses pribadi Anda, lalu jalankan perintah berikut untuk menambahkan sumber paket Anda ke file nuget.config Anda. Pastikan file ini disimpan dengan aman dan tidak diperiksa ke kontrol sumber.

    dotnet nuget add source https://pkgs.dev.azure.com/<ORGANIZATION_NAME>/<PROJECT_NAME>/_packaging/<FEED_NAME>/nuget/v3/index.json --name <SOURCE_NAME> --username <USER_NAME> --password <PERSONAL_ACCESS_TOKEN> --configfile <PATH_TO_NUGET_CONFIG_FILE>
    
  3. Jalankan perintah berikut untuk menerbitkan paket Anda:

    dotnet nuget push --source <SOURCE_NAME> --api-key <ANY_STRING> <PACKAGE_PATH>
    

Contoh:

dotnet nuget add source https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.config

dotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg

Nota

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