pendorongan dotnet nuget

Artikel
05/09/2023

Artikel ini berlaku untuk: ️ .NET Core 3.1 SDK dan versi yang lebih baru

Nama

dotnet nuget push - Mendorong paket ke server dan menerbitkannya.

Sinopsis

dotnet nuget push [<ROOT>] [-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>]

dotnet nuget push -h|--help

Deskripsi

Perintah dotnet nuget push mendorong paket ke server dan menerbitkannya. Perintah push menggunakan server dan detail kredensial 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 yang dipilih 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, kemudian Anda dapat menggunakan dotnet nuget push untuk sisanya. Untuk informasi selengkapnya, lihat Umpan lokal.

Argumen

ROOT

Menentukan jalur file ke paket yang akan didorong.

Opsi

-d|--disable-buffering

Menonaktifkan buffering saat mendorong ke server HTTP(S) untuk mengurangi penggunaan memori.
--force-english-output

Memaksa aplikasi untuk 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. Tersedia sejak SDK .NET Core 3.0.

-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 apa pun 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.

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"
```
Catatan

Jika perintah ini tidak berhasil, mungkin karena bug yang ada di versi SDK yang lebih lama (.NET Core 2.1 SDK dan versi yang lebih lama). Untuk memperbaikinya, tingkatkan versi SDK Anda atau jalankan perintah berikut: dotnet nuget push "**/*.nupkg"

Catatan

Tanda kutip penutup diperlukan untuk shell seperti bash yang melakukan globbing file. Untuk informasi selengkapnya, lihat NuGet/Home#4393.
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 push Azure Artifacts.

Bagikan melalui