Bagikan melalui

Set beban kerja .NET SDK

  • Artikel

Fitur set beban kerja menyediakan nomor versi yang mewakili sekelompok beban kerja .NET SDK. Perintah instal, perbarui, dan pulihkan menggunakan nomor ini dalam mode pembaruan set beban kerja untuk memberikan manfaat berikut:

  • Anda mengontrol irama perubahan untuk versi beban kerja yang diinstal. Mode operasi alternatif tanpa menggunakan set beban kerja disebut mode pembaruan manifes longgar. Dalam mode ini, beban kerja diperbarui secara otomatis karena versi baru beban kerja individual dirilis ke umpan NuGet yang dikonfigurasi. Dalam workload-set mode pembaruan, beban kerja tetap berada di versi set beban kerja tertentu hingga Anda secara eksplisit mengubah versi tersebut.
  • Anda dapat menginstal dan memperbarui kombinasi versi beban kerja yang dikirim pada saat yang sama dan diketahui bekerja sama.
  • Anda dapat memastikan bahwa semua orang di tim Anda selalu mengerjakan versi beban kerja yang sama.
  • Anda tidak perlu menggunakan file putar kembali untuk menentukan versi beban kerja apa yang ingin Anda gunakan.

Berikut adalah beberapa cara Anda dapat menggunakan set beban kerja:

  • "Sematkan" install perintah ke versi set beban kerja tertentu.
  • Perbarui beban kerja yang diinstal ke versi set beban kerja terbaru yang tersedia.
  • Perbarui ke versi set beban kerja tertentu.
  • Tentukan versi set beban kerja di global.json.
  • Periksa mode pembaruan Anda saat ini dan versi set beban kerja.

Dan Anda masih dapat memilih untuk menginstal, memperbarui, atau memulihkan ke versi terbaru setiap beban kerja individual, mengabaikan set beban kerja.

Prasyarat

  • .NET 8.0.400 SDK atau yang lebih baru.

    Dalam 8.0.400 SDK, dotnet workload perintah berada dalam mode pembaruan set beban kerja hanya ketika dipilih secara eksplisit.

"Sematkan" perintah instal

dotnet workload install Perintah dengan --version opsi "menyematkaninstall" perintah dalam workload-set mode pembaruan dengan versi set beban kerja yang ditentukan. Perintah tidak lagi secara otomatis menginstal beban kerja terbaru berdasarkan manifes longgar.

Untuk "menyematkan install " perintah:

  1. Pilih versi set beban kerja. Contohnya,9.0.100-preview.7.24414.1.

  2. Pilih beban kerja. Contohnya,aspire.

  3. dotnet workload install aspire --version 9.0.100-preview.7.24414.1

    Ketika perintah ini berjalan:

    • Ini memilih workload-set mode pembaruan jika belum dipilih.
    • Ini mendapatkan set beban kerja yang memiliki versi yang ditentukan.
    • Dari set beban kerja, ia mendapatkan versi manifes dari beban kerja yang ditentukan.
    • Ini menginstal versi manifes beban kerja.
    • Ini tetap dalam workload-set mode pembaruan ketika selesai.

  4. Pilih beban kerja lain untuk diinstal, seperti maui-ios.

  5. dotnet workload install maui-ios

    Perintah ini menginstal maui-ios beban kerja menggunakan versi beban kerja dari versi 9.0.100-preview.7.24414.1set beban kerja , karena contoh perintah sebelumnya menyematkan install set beban kerja tersebut.

Menggunakan --version dengan atau install update menyematkan install ke versi yang ditentukan, tetapi update hanya dikonfigurasi untuk workload-set mode pembaruan, bukan ke versi set beban kerja tertentu. Jika Anda kemudian menjalankan dotnet workload update tanpa --version opsi , update perintah :

  • Memperbarui beban kerja ke versi set beban kerja terbaru yang tersedia.
  • "Lepaskan" install perintah .
  • Tetap dalam workload-set mode pembaruan.

Perbarui menggunakan set beban kerja terbaru

Untuk memperbarui beban kerja yang diinstal ke versi set beban kerja terbaru yang tersedia pada umpan yang dikonfigurasi, jalankan perintah berikut:

  1. dotnet workload config --update-mode workload-set

    Perintah sebelumnya diperlukan hanya jika Anda saat ini berada dalam mode pembaruan manifes. Jika Anda tidak tahu, periksa mode pembaruan saat ini.

  2. dotnet workload update

    Dalam workload-set mode pembaruan, perintah ini memperbarui beban kerja ke versi set beban kerja terbaru, kecuali Anda telah menentukan versi set beban kerja di global.json.

Memperbarui ke versi set beban kerja

Untuk menentukan versi set beban kerja yang akan diperbarui saat Anda tidak menentukannya di global.json, gunakan --version opsi update perintah:

  1. Pilih versi set beban kerja. Contohnya,8.0.400.

  2. dotnet workload update --version 8.0.400

    workload-set mode pembaruan akan dipilih jika belum dipilih.

Menggunakan global.json untuk versi set beban kerja

Untuk menggunakan global.json file guna menentukan versi set beban kerja untuk repositori:

  1. Pilih versi set beban kerja. Contohnya,9.0.100-preview.7.24414.1.

  2. Buat global.json file yang terlihat seperti contoh berikut:

    {
  "sdk": {
    "workloadVersion": "9.0.100-preview.7.24414.1"
  }
}

Dengan direktori saat ini di repositori yang sama dan CLI dalam workload-set mode pembaruan, installperintah , , updatedan restore menginstal beban kerja untuk versi set beban kerja yang ditentukan. Jika Anda tidak memiliki file global.json dan Anda berada dalam workload-set mode pembaruan, restore perintah menginstal versi set beban kerja yang dibuat saat Anda beralih dari mode pembaruan manifes ke workload-set mode pembaruan.

Jika Anda memiliki versi set beban kerja dalam file global.json, perintah beban kerja dalam workload-set mode bahkan jika Anda belum menjalankan config perintah atau menggunakan --version. File global.json mengambil alih file tersebut. Untuk menggunakan --version opsi dalam hal ini, jalankan perintah di luar jalur yang berisi file global.json.

Jika Anda tidak menentukan versi set beban kerja di global.json, Anda dapat menggunakan --version opsi dengan restore perintah . Dalam hal ini, restore perintah memilih workload-set mode pembaruan sebelum memulihkan beban kerja ke versi set beban kerja yang ditentukan.

Dalam mode pembaruan manifes, restore instal atau perbarui beban kerja ke versi terbaru dari setiap beban kerja individu.

Periksa mode dan versi pembaruan

Untuk melihat mode pembaruan saat ini, jalankan config perintah dengan --update-mode opsi tanpa argumen. Modenya adalah workload-set atau manifests. Contohnya:

dotnet workload config --update-mode

workload-set

Untuk melihat versi set beban kerja saat ini, jalankan dotnet workload --version. Jika set beban kerja diinstal, Anda akan melihat versi seperti 9.0.100-preview.7.24414.1 atau 8.0.402. Contohnya:

dotnet workload --version

9.0.100-preview.7.24414.1

Dalam mode manifes, atau jika versi set beban kerja belum dibuat setelah beralih ke workload-set mode pembaruan, Anda akan melihat versi dalam bentuk <feature band>-manifests.<hash>. Contohnya:

dotnet workload --version

9.0.100-manifests.cf958b56

Pilih versi set beban kerja

Set beban kerja diterbitkan ke nuget.org dengan setiap rilis .NET SDK, di bawah ID Microsoft.NET.Workloads.<feature band>paket . Untuk versi SDK yang stabil, selalu ada versi set beban kerja yang cocok. Jadi 8.0.400 SDK dapat menginstal set beban kerja 8.0.400, dan 401 dapat menginstal set 401. Secara umum, kami sarankan Anda menginstal beban kerja yang cocok yang ditetapkan untuk SDK yang stabil.

Untuk rilis pratinjau, temukan versi set beban kerja yang sesuai di tab README paket. Misalnya, lihat tab README untuk paket Pratinjau .NET 9 7.

Di masa mendatang, Anda akan dapat melihat daftar versi set beban kerja dan apa yang dikandungnya.

Abaikan set beban kerja

Untuk menginstal, atau memperbarui ke, versi terbaru dari setiap beban kerja individu yang tersedia pada umpan yang dikonfigurasi, pilih dan gunakan mode pembaruan manifes dengan menjalankan perintah beban config kerja:

dotnet workload config --update-mode manifests

Dalam .NET 8.0.4xx SDK, mode manifes adalah default. Dalam versi ini, Anda perlu memilih mode manifes secara eksplisit hanya jika Anda secara eksplisit memilih workload-set mode pembaruan sebelumnya.

Konten terkait