Bagikan melalui


Menerbitkan dan memulihkan paket NuGet dari baris perintah (dotnet)

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

Azure Artifacts memungkinkan Anda menerbitkan dan memulihkan paket NuGet ke dan dari umpan Anda, memungkinkan Anda membagikannya dengan orang lain sesuai dengan pengaturan visibilitas umpan Anda. Panduan ini memandu Anda mengonfigurasi proyek untuk menerbitkan atau memulihkan paket menggunakan antarmuka baris perintah dotnet.

Prasyarat

Hubungkan ke umpan

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

  2. Pilih Koneksi ke umpan, lalu pilih dotnet dari bagian NuGet di sebelah kiri.

  3. Buat file nuget.config di folder yang sama dengan file csproj atau 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 cakupan 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 Koneksi ke Umpan, lalu pilih dotnet dari panel navigasi kiri.

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

    Cuplikan layar memperlihatkan cara menyambungkan ke umpan dengan dotnet di Azure DevOps Server 2020 dan 2022.

Catatan

dotnet tidak didukung di Azure DevOps Server 2019.

Menerbitkan paket

Jalankan perintah berikut untuk menerbitkan paket ke umpan Anda. Ganti tempat penampung dengan informasi yang sesuai:

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

Catatan

hanya api-key digunakan sebagai tempat penampung.

Menerbitkan paket dari sumber eksternal

  1. Buat token akses pribadi (PAT) dengan cakupan baca dan tulis kemasan.

  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. Ini menambahkan PAT Anda ke nuget.config Anda. Pastikan untuk menyimpan file ini dengan aman dan tidak memeriksanya 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. Terbitkan paket Anda:

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

Contoh: dotnet nuget tambahkan sumber https://pkgs.dev.azure.com/MyOrg/MyProject/_packaging/MyFeed/nuget/v3/index.json --name MySource --username MyUserName --password MyPersonalAccessToken --configfile ./nuget.configdotnet nuget push --source MySource --api-key AZ nupkgs/mypackage.1.1.0.nupkg

Catatan

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

Memulihkan paket

Jalankan perintah berikut untuk memulihkan paket Anda. Bendera --interactive digunakan untuk meminta kredensial kepada pengguna:

dotnet restore --interactive