Bagikan melalui

dotnet nuget push

Artikel ini berlaku untuk: ✔️ .NET 6 SDK dan versi yang lebih baru

Nama

dotnet nuget push - Mendorong paket ke server dan menerbitkannya.

Sinopsis

dotnet nuget push [<ROOT>] [--allow-insecure-connections] [-d|--disable-buffering] [--force-english-output]
    [--interactive] [-k|--api-key <API_KEY>] [-n|--no-symbols]
    [--no-service-endpoint] [-s|--source <SOURCE>] [--skip-duplicate]
    [-sk|--symbol-api-key <API_KEY>] [-ss|--symbol-source <SOURCE>]
    [-t|--timeout <TIMEOUT>]
    [--configfile <FILE>]

dotnet nuget push -h|--help

Deskripsi

Perintah dotnet nuget push mendorong paket ke server dan menerbitkannya. Perintah push menggunakan server dan detail info masuk yang ditemukan dalam file konfigurasi NuGet sistem atau rantai file konfigurasi. Untuk informasi selengkapnya tentang file konfigurasi, lihat Mengonfigurasi Perilaku NuGet. Konfigurasi default NuGet diperoleh dengan memuat %AppData%\NuGet\NuGet.config (Windows) atau $HOME/.nuget/NuGet/NuGet.Config (Linux/macOS), lalu memuat nuget.config atau .nuget\nuget.config mulai dari akar drive dan berakhir di direktori saat ini.

Perintah mendorong paket yang ada. Ini tidak membuat paket. Untuk membuat paket, gunakan dotnet pack.

Struktur folder hierarkis

Perintah ini dapat menyimpan paket dalam struktur folder hierarkis, yang direkomendasikan untuk mengoptimalkan performa. Ini menyimpan paket dalam struktur folder hierarkis saat menerbitkan ke folder lokal (umpan), seperti nuget add halnya, jika sudah ada setidaknya satu paket dalam umpan yang berada dalam struktur folder hierarkis. Jika umpan memiliki paket terstruktur folder hierarkis yang sudah ada di dalamnya, dotnet nuget push menghormati struktur tersebut. Jadi, jika Anda ingin menerbitkan ke umpan lokal menggunakan .NET CLI alih-alih NuGet CLI:

  • Sebelum Anda menerbitkan paket pertama, buka folder paket global Anda, di %userprofile%.nuget\packages, dan pilih folder akar id paket. Ini bisa menjadi paket apa pun yang bukan bagian dari kerangka kerja, seperti standar .NET atau ASP.NET.
  • Salin folder paket terpilih ke folder akar umpan lokal.
  • Gunakan dotnet nuget push untuk menerbitkan paket Anda ke umpan lokal.
  • Anda sekarang dapat menghapus folder yang sebelumnya Anda salin, dan Anda dapat dengan bebas menggunakan dotnet nuget push untuk menerbitkan ke umpan lokal Anda.

Atau, gunakan NuGet CLI untuk paket pertama, lalu Anda dapat menggunakan dotnet nuget push sisanya. Untuk informasi selengkapnya, lihat Umpan lokal.

Argumen

  • ROOT

    Menentukan jalur file ke paket yang akan didorong.

Opsi

  • --allow-insecure-connections

    Memungkinkan pendorongan ke sumber HTTP (tidak aman).

  • -d|--disable-buffering

    Menonaktifkan buffering saat mendorong ke server HTTP(S) untuk mengurangi penggunaan memori.

  • --force-english-output

    Memaksa aplikasi berjalan menggunakan budaya berbasis bahasa Inggris yang invarian.

  • -?|-h|--help

    Mencetak deskripsi cara menggunakan perintah.

  • --interactive

    Memungkinkan perintah berhenti dan menunggu input atau tindakan pengguna. Misalnya, untuk menyelesaikan autentikasi.

  • -k|--api-key <API_KEY>

    Kunci API untuk server.

  • -n|--no-symbols

    Tidak mendorong simbol (bahkan jika ada).

  • --no-service-endpoint

    Tidak menambahkan "api/v2/package" ke URL sumber.

  • -s|--source <SOURCE>

    Menentukan URL server. NuGet mengidentifikasi UNC atau sumber folder lokal dan hanya menyalin file di sana alih-alih mendorongnya menggunakan HTTP.

    Penting

    Dimulai dengan NuGet 3.4.2, ini adalah parameter wajib kecuali file konfigurasi NuGet menentukan DefaultPushSource nilai. Untuk informasi selengkapnya, lihat Mengonfigurasi perilaku NuGet.

  • --skip-duplicate

    Saat mendorong beberapa paket ke server HTTP,memperlakukan respons Konflik 409 sebagai peringatan sehingga dorongan lain dapat dilanjutkan.

  • -sk|--symbol-api-key <API_KEY>

    Kunci API untuk server simbol.

  • -ss|--symbol-source <SOURCE>

    Menentukan URL server simbol.

  • -t|--timeout <TIMEOUT>

    Menentukan batas waktu untuk mendorong ke server dalam hitung detik. Default ke 300 detik (5 menit). Menentukan 0 menerapkan nilai default.

  • --configfile

    File konfigurasi NuGet (nuget.config) untuk digunakan. Jika ditentukan, hanya pengaturan dari file ini yang akan digunakan. Jika tidak ditentukan, hierarki file konfigurasi dari direktori saat ini akan digunakan. Untuk informasi selengkapnya, lihat Konfigurasi NuGet Umum.

Contoh

  • Dorong foo.nupkg ke sumber push default yang ditentukan dalam file konfigurasi NuGet, menggunakan kunci API:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a

  • Dorong foo.nupkg ke server NuGet resmi, menentukan kunci API:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://api.nuget.org/v3/index.json

  • Dorong foo.nupkg ke sumber https://customsourcependorongan kustom , menentukan kunci API:

    dotnet nuget push foo.nupkg -k 4003d786-cc37-4004-bfdf-c4f3e8ef9b3a -s https://customsource/

  • Dorong foo.nupkg ke sumber push default yang ditentukan dalam file konfigurasi NuGet:

    dotnet nuget push foo.nupkg

  • Dorong foo.symbols.nupkg ke sumber simbol default:

    dotnet nuget push foo.symbols.nupkg

  • Dorong foo.nupkg ke sumber push default yang ditentukan dalam file konfigurasi NuGet, dengan batas waktu 360 detik:

    dotnet nuget push foo.nupkg --timeout 360

  • Dorong semua file .nupkg di direktori saat ini ke sumber push default yang ditentukan dalam file konfigurasi NuGet:

    dotnet nuget push "*.nupkg"

  • Dorong semua file .nupkg ke sumber push default yang ditentukan dalam file konfigurasi NuGet, bahkan jika respons Konflik 409 dikembalikan oleh server HTTP:

    dotnet nuget push "*.nupkg" --skip-duplicate

  • Dorong semua file .nupkg di direktori saat ini ke direktori umpan lokal:

    dotnet nuget push "*.nupkg" -s c:\mydir

  • Untuk mendorong ke Artefak Azure, lihat dokumentasi pendorongan Azure Artifacts.

  • Last updated on