Aracılığıyla paylaş

.NET SDK iş yükü kümeleri

  • Makale

İş yükü kümeleri özelliği, bir grup .NET SDK iş yükünü temsil eden bir sürüm numarası sağlar. Yükleme, güncelleştirme ve geri yükleme komutları, aşağıdaki avantajları sağlamak için iş yükü kümesi güncelleştirme modunda bu numarayı kullanır:

  • Yüklü iş yükü sürümleri için değişiklik temposunu siz denetlersiniz. İş yükü kümeleri kullanılmadan alternatif işlem modu, gevşek bildirimler güncelleştirme modu olarak adlandırılır. Bu modda iş yükleri, tek tek iş yüklerinin yeni sürümleri yapılandırılmış NuGet akışlarına yayımlandıkçe otomatik olarak güncelleştirilir. workload-set Güncelleştirme modunda, siz bu sürümü açıkça değiştirene kadar iş yükleri belirli bir iş yükü kümesi sürümünde kalır.
  • Aynı anda gelen ve birlikte çalıştığı bilinen iş yükü sürümlerinin bir bileşimini yükleyip güncelleştirebilirsiniz.
  • Ekibinizdeki herkesin her zaman aynı iş yükü sürümleri üzerinde çalıştığından emin olabilirsiniz.
  • Hangi iş yükü sürümünde olmak istediğinizi belirtmek için geri alma dosyası kullanmanız gerekmez.

İş yükü kümelerini kullanmanın bazı yolları şunlardır:

  • Komutu belirli bir iş yükü kümesi sürümüne "sabitleyin" install .
  • Yüklü iş yüklerini kullanılabilir en son iş yükü kümesi sürümüne güncelleştirin.
  • Belirtilen iş yükü kümesi sürümüne güncelleştirin.
  • global.json iş yükü kümesi sürümünü belirtin.
  • Geçerli güncelleştirme modunuzu ve iş yükü kümesi sürümünüzü denetleyin.

Ayrıca iş yükü kümelerini yoksayarak her bir iş yükünün en son sürümünü yüklemeyi, güncelleştirmeyi veya geri yüklemeyi seçebilirsiniz.

Önkoşullar

  • .NET 8.0.400 SDK veya üzeri.

    8.0.400 SDK'da komutlar yalnızca dotnet workload açıkça seçildiğinde iş yükü tarafından ayarlanan güncelleştirme modundadır.

Yükleme komutunu "sabitleme"

dotnet workload install Komutu belirtilen iş yükü kümesi sürümüyle güncelleştirme modunda "sabitler" install seçeneğine sahip --version bir komutworkload-set. Komutu artık en yeni iş yükünü gevşek bildirimlere göre otomatik olarak yüklemez.

Komutu "sabitlemek" için install :

  1. İş yükü kümesi sürümünü seçin. Örneğin, 9.0.100-preview.7.24414.1.

  2. bir iş yükü seçin. Örneğin, aspire.

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

    Bu komut çalıştırıldığında:

    • Henüz seçili değilse güncelleştirme modunu seçer workload-set .
    • Belirtilen sürüme sahip iş yükü kümesini alır.
    • İş yükü kümesinden belirtilen iş yükünün bildirim sürümünü alır.
    • İş yükünün bildirim sürümünü yükler.
    • İşlem tamamlandığında güncelleştirme modunda kalır workload-set .

  4. Yüklenecek başka bir iş yükü seçin, örneğin maui-ios.

  5. dotnet workload install maui-ios

    Bu komut, önceki install komut örneği bu iş yükü kümesini sabitlediğinden, iş yükü kümesi sürümünden iş yükü sürümünü 9.0.100-preview.7.24414.1kullanarak iş yükünü yüklermaui-ios.

ile --version install veya update belirtilen sürüme sabitlenir install , ancak update belirli bir iş yükü kümesi sürümüne değil, yalnızca güncelleştirme modu için workload-set yapılandırılır. Ardından seçeneği olmadan --version çalıştırırsanızdotnet workload update, update komutu:

  • İş yüklerini kullanılabilir en son iş yükü kümesi sürümüne güncelleştirir.
  • komutu "Kaldır" install komutu.
  • Güncelleştirme modunda workload-set kalır.

En son iş yükü kümesini kullanarak güncelleştirme

Yüklü iş yüklerini yapılandırılan akışlarda kullanılabilen en son iş yükü kümesi sürümüne güncelleştirmek için aşağıdaki komutları çalıştırın:

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

    Yukarıdaki komut yalnızca şu anda bildirim güncelleştirme modundaysanız gereklidir. Bilmiyorsanız geçerli güncelleştirme modunu denetleyin.

  2. dotnet workload update

    workload-set Güncelleştirme modunda, iş yükü kümesi sürümünü global.json belirtmediğiniz sürece bu komut iş yüklerini en son iş yükü kümesi sürümüne güncelleştirir.

İş yükü kümesi sürümüne güncelleştirme

global.json'de belirtmiyorsanız güncelleştirilecek iş yükü kümesi sürümünü belirtmek için komutunun update seçeneğini kullanın--version:

  1. İş yükü kümesi sürümünü seçin. Örneğin, 8.0.400.

  2. dotnet workload update --version 8.0.400

    workload-set henüz seçili değilse güncelleştirme modu seçilir.

İş yükü kümesi sürümü için global.json kullanma

Bir deponun iş yükü kümesi sürümünü belirtmek üzere bir dosya kullanmak global.json için:

  1. İş yükü kümesi sürümünü seçin. Örneğin, 9.0.100-preview.7.24414.1.

  2. Aşağıdaki örneğe benzer bir global.json dosya oluşturun:

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

Geçerli dizin aynı depoda ve CLI güncelleştirme modundayken workload-set , install, updateve restore komutları belirtilen iş yükü kümesi sürümü için iş yüklerini yükler. global.json dosyanız yoksa ve güncelleştirme modundaysanız workload-set , restore bildirim güncelleştirme modundan güncelleştirme moduna workload-set geçtiğinizde oluşturulan iş yükü kümesi sürümünü yükler.

global.json dosyasında iş yükü kümesi sürümüne sahipseniz, komutunu çalıştırmamış config veya kullanmamış --versionolsanız bile iş yükü komutları modundadırworkload-set. global.json dosyası bunları geçersiz kılar. Bu durumda seçeneğini kullanmak --version için komutunu global.json dosyasını içeren yolun dışında çalıştırın.

global.json'da iş yükü kümesi sürümünü belirtmezseniz komutunu kullanarak restore seçeneğini kullanabilirsiniz--version. Bu durumda komut, restore iş yüklerini workload-set belirtilen iş yükü kümesi sürümüne geri yüklemeden önce güncelleştirme modunu seçer.

Bildirim güncelleştirme modunda, restore iş yüklerini her bir iş yükünün en son sürümüne yükler veya güncelleştirir.

Güncelleştirme modunu ve sürümünü denetleyin

Geçerli güncelleştirme modunu görmek için komutunu bağımsız değişken olmadan seçeneğiyle --update-mode çalıştırınconfig. Mod veya workload-set manifestsşeklindedir. Örneğin:

dotnet workload config --update-mode

workload-set

Geçerli iş yükü kümesi sürümünü görmek için komutunu çalıştırın dotnet workload --version. bir iş yükü kümesi yüklüyse, 9.0.100-preview.7.24414.1 veya 8.0.402 gibi bir sürüm görürsünüz. Örneğin:

dotnet workload --version

9.0.100-preview.7.24414.1

Bildirim modunda veya güncelleştirme moduna geçtikten workload-set sonra iş yükü kümesi sürümü henüz oluşturulmamışsa biçiminde <feature band>-manifests.<hash>bir sürüm görürsünüz. Örneğin:

dotnet workload --version

9.0.100-manifests.cf958b56

İş yükü kümesi sürümü seçme

İş yükü kümeleri, .NET SDK'sının her sürümüyle nuget.org için paket kimliği Microsoft.NET.Workloads.<feature band>altında yayımlanır. SDK'nın kararlı bir sürümü için her zaman eşleşen bir iş yükü kümesi sürümü vardır. Dolayısıyla 8.0.400 SDK bir 8.0.400 iş yükü kümesi yükleyebilir ve 401 bir 401 kümesi yükleyebilir. Genel olarak, kararlı bir SDK için eşleşen iş yükü kümesini yüklemenizi öneririz.

Önizleme sürümleri için, paketin BENIOKU sekmesinde ilgili iş yükü kümesi sürümünü bulun. Örneğin, .NET 9 Preview 7 paketi için BENIOKU sekmesine bakın.

Gelecekte, iş yükü kümesi sürümlerinin listesini ve bunların neler içerdiğini görebilirsiniz.

İş yükü kümelerini yoksayma

Yapılandırılan akışlarda bulunan her bir iş yükünün en son sürümünü yüklemek veya güncelleştirmek için, iş yükü config komutunu çalıştırarak bildirim güncelleştirme modunu seçin ve kullanın:

dotnet workload config --update-mode manifests

.NET 8.0.4xx SDK'sında bildirim modu varsayılandır. Bu sürümde bildirim modunu yalnızca daha önce açıkça güncelleştirme modunu seçtiyseniz açıkça seçmeniz workload-set gerekir.

İlgili içerik