Delen via

.NET SDK-workloadsets

  • Artikel

De functie workloadsets biedt een versienummer dat een groep .NET SDK-workloads vertegenwoordigt. De opdrachten voor installeren, bijwerken en herstellen gebruiken dit aantal in de updatemodus voor werkbelastingsets om de volgende voordelen te bieden:

  • U bepaalt de frequentie van de wijziging voor geïnstalleerde workloadversies. De alternatieve bewerkingsmodus zonder het gebruik van werkbelastingsets wordt de updatemodus voor losse manifesten genoemd. In deze modus worden workloads automatisch bijgewerkt wanneer nieuwe versies van afzonderlijke workloads worden vrijgegeven op geconfigureerde NuGet-feeds. In workload-set de updatemodus blijven workloads bij een specifieke versie van de workloadset totdat u die versie expliciet wijzigt.
  • U kunt een combinatie van workloadversies installeren en bijwerken die tegelijkertijd worden verzonden en waarvan bekend is dat ze samenwerken.
  • U kunt ervoor zorgen dat iedereen in uw team altijd aan dezelfde workloadversies werkt.
  • U hoeft geen terugdraaibestand te gebruiken om op te geven welke workloadversie u wilt gebruiken.

Hier volgen enkele manieren waarop u workloadsets kunt gebruiken:

  • De opdracht vastmaken install aan een specifieke versie van een workloadset.
  • Werk geïnstalleerde workloads bij naar de nieuwste beschikbare versie van de workloadset.
  • Werk bij naar een opgegeven versie van een workloadset.
  • Geef de versie van de workloadset op in global.json.
  • Controleer de huidige updatemodus en de versie van de workloadset.

En u kunt er nog steeds voor kiezen om de nieuwste versie van elke afzonderlijke workload te installeren, bij te werken of te herstellen, waarbij workloadsets worden genegeerd.

Vereisten

  • .NET 8.0.400 SDK of hoger.

    In 8.0.400 SDK bevinden de opdrachten zich alleen in de dotnet workload updatemodus voor workloadsets wanneer deze expliciet is geselecteerd.

De installatieopdracht vastmaken

Een dotnet workload install opdracht met de --version optie 'pint' de opdracht in workload-set de install updatemodus met de opgegeven versie van de workloadset. Met de opdracht wordt de nieuwste workload niet meer automatisch geïnstalleerd op basis van losse manifesten.

De opdracht vastmaken install :

  1. Kies een versie van een workloadset. Bijvoorbeeld: 9.0.100-preview.7.24414.1.

  2. Kies een workload. Bijvoorbeeld: aspire.

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

    Wanneer deze opdracht wordt uitgevoerd:

    • De updatemodus wordt geselecteerd workload-set als dat nog niet is geselecteerd.
    • Hiermee haalt u de workloadset op met de opgegeven versie.
    • Vanuit de werkbelastingset wordt de manifestversie van de opgegeven workload opgehaald.
    • Hiermee wordt de manifestversie van de workload geïnstalleerd.
    • Deze blijft in workload-set de updatemodus wanneer deze klaar is.

  4. Kies een andere workload die u wilt installeren, zoals maui-ios.

  5. dotnet workload install maui-ios

    Met deze opdracht wordt de maui-ios workload geïnstalleerd met behulp van de workloadversie van de versie 9.0.100-preview.7.24414.1van de workloadset, omdat in het voorgaande install opdrachtvoorbeeld die workloadset is vastgemaakt.

Gebruiken --version met een install van beide of update pinnen install op de opgegeven versie, maar update is alleen geconfigureerd voor workload-set de updatemodus, niet voor een specifieke workloadsetversie. Als u vervolgens zonder de --version optie uitvoertdotnet workload update, voert u de update volgende opdracht uit:

  • Hiermee worden workloads bijgewerkt naar de meest recente beschikbare versie van de workloadset.
  • De opdracht losmaken install .
  • Blijft in workload-set de updatemodus.

Bijwerken met de meest recente werkbelastingset

Voer de volgende opdrachten uit om geïnstalleerde workloads bij te werken naar de meest recente versie van de workloadset die beschikbaar is op de geconfigureerde feeds:

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

    De voorgaande opdracht is alleen nodig als u zich momenteel in de updatemodus voor manifesten bevindt. Als u het niet weet, controleert u de huidige updatemodus.

  2. dotnet workload update

    In workload-set de updatemodus worden werkbelastingen bijgewerkt naar de meest recente versie van de workloadset, tenzij u de versie van de workloadset hebt opgegeven in global.json.

Bijwerken naar een versie van een workloadset

Als u een workloadsetversie wilt opgeven waarnaar u wilt bijwerken wanneer u deze niet opgeeft in global.json, gebruikt u de --version optie van de update opdracht:

  1. Kies een versie van een workloadset. Bijvoorbeeld: 8.0.400.

  2. dotnet workload update --version 8.0.400

    workload-set de updatemodus wordt geselecteerd als deze nog niet is geselecteerd.

Gebruik global.json voor de versie van de workloadset

Een bestand gebruiken global.json om de versie van de workloadset voor een opslagplaats op te geven:

  1. Kies een versie van een workloadset. Bijvoorbeeld: 9.0.100-preview.7.24414.1.

  2. Maak een global.json bestand dat eruitziet als in het volgende voorbeeld:

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

Met de huidige map in dezelfde opslagplaats en de CLI in workload-set de updatemodus installeren de installen updaterestore opdrachten workloads voor de opgegeven versie van de workloadset. Als u geen global.json bestand hebt en u zich in workload-set de updatemodus bevindt, installeert de restore opdracht de versie van de workloadset die is ingesteld toen u bent overgeschakeld van de updatemodus voor manifesten naar workload-set de updatemodus.

Als u een versie van de workloadset in het global.json-bestand hebt, bevinden de workloadopdrachten zich in workload-set de modus, zelfs als u de config opdracht niet hebt uitgevoerd of gebruikt --version. Het global.json bestand overschrijft deze. Als u de --version optie in dat geval wilt gebruiken, voert u de opdracht uit buiten het pad met het global.json-bestand.

Als u de versie van de workloadset niet opgeeft in global.json, kunt u de --version optie met de restore opdracht gebruiken. In dat geval selecteert workload-set de opdracht de restore updatemodus voordat workloads worden hersteld naar de opgegeven versie van de workloadset.

In de updatemodus restore voor manifesten worden workloads geïnstalleerd of bijgewerkt naar de nieuwste versie van elke afzonderlijke workload.

De updatemodus en -versie controleren

Als u de huidige updatemodus wilt zien, voert u de config opdracht uit met de --update-mode optie zonder argument. De modus is workload-set of manifests. Voorbeeld:

dotnet workload config --update-mode

workload-set

Als u de huidige versie van de workloadset wilt zien, voert u het volgende uit dotnet workload --version. Als een workloadset is geïnstalleerd, ziet u een versie zoals 9.0.100-preview.7.24414.1 of 8.0.402. Voorbeeld:

dotnet workload --version

9.0.100-preview.7.24414.1

In de manifestmodus of als de versie van de workloadset nog niet tot stand is gebracht nadat u overschakelt naar workload-set de updatemodus, ziet u een versie in de vorm van <feature band>-manifests.<hash>. Voorbeeld:

dotnet workload --version

9.0.100-manifests.cf958b56

Een workloadsetversie kiezen

Workloadsets worden gepubliceerd naar nuget.org met elke release van de .NET SDK, onder de pakket-id Microsoft.NET.Workloads.<feature band>. Voor een stabiele versie van de SDK is er altijd een overeenkomende versie van de workloadset. 8.0.400 SDK kan dus een 8.0.400-workloadset installeren en 401 kan een 401-set installeren. Over het algemeen raden we u aan om de overeenkomende workloadset voor een stabiele SDK te installeren.

Voor preview-releases zoekt u de bijbehorende versie van de workloadset op het tabblad README van het pakket. Zie bijvoorbeeld het tabblad README voor het .NET 9 Preview 7-pakket.

In de toekomst ziet u een lijst met versies van workloadsets en wat ze bevatten.

Workloadsets negeren

Als u de meest recente versie van elke afzonderlijke workload wilt installeren of bijwerken die beschikbaar is op de geconfigureerde feeds, selecteert en gebruikt u de updatemodus voor manifesten door de workloadopdracht config uit te voeren:

dotnet workload config --update-mode manifests

In .NET 8.0.4xx SDK is de manifestmodus de standaardmodus. In deze versie moet u de manifestmodus alleen expliciet selecteren als u eerder de updatemodus expliciet hebt geselecteerd workload-set .

Gerelateerde inhoud