Condividi tramite

Set di carichi di lavoro di .NET SDK

  • Articolo

La funzionalità set di carichi di lavoro fornisce un numero di versione che rappresenta un gruppo di carichi di lavoro .NET SDK. I comandi di installazione, aggiornamento e ripristino usano questo numero in modalità di aggiornamento del set di carico di lavoro per offrire i vantaggi seguenti:

  • È possibile controllare la frequenza delle modifiche per le versioni del carico di lavoro installate. La modalità alternativa dell'operazione senza usare i set di carico di lavoro è detta modalità di aggiornamento dei manifesti separati. In questa modalità, i carichi di lavoro vengono aggiornati automaticamente man mano che vengono rilasciate nuove versioni dei singoli carichi di lavoro in tutti i feed NuGet configurati. In workload-set modalità di aggiornamento, i carichi di lavoro rimangono in una versione specifica del set di carico di lavoro fino a quando non si modifica esplicitamente tale versione.
  • È possibile installare e aggiornare una combinazione di versioni del carico di lavoro che vengono fornite contemporaneamente e che sono note per collaborare.
  • È possibile assicurarsi che tutti i membri del team lavorino sempre sulle stesse versioni del carico di lavoro.
  • Non è necessario usare un file di rollback per specificare la versione del carico di lavoro che si vuole usare.

Ecco alcuni modi in cui puoi utilizzare i set di carichi di lavoro:

  • "Aggiungi" il comando install a una versione specifica del set di carico di lavoro.
  • Aggiornare i carichi di lavoro installati alla versione più recente disponibile del set di carico di lavoro.
  • Eseguire l'aggiornamento a una versione specificata del set di carico di lavoro.
  • Specificare la versione del set di carico di lavoro in global.json.
  • Controllare la modalità di aggiornamento corrente e la versione del set di carico di lavoro.

È comunque possibile scegliere di installare, aggiornare o ripristinare la versione più recente di ogni singolo carico di lavoro, ignorando i set di carichi di lavoro.

Prerequisiti

  • .NET 8.0.400 SDK o versione successiva.

    Nella versione 8.0.400 SDK, i comandi dotnet workload sono in modalità di aggiornamento del set di carico di lavoro solo quando è selezionata in modo esplicito.

"Aggiungi" il comando install

Comando dotnet workload install con l'opzione --version "pins" il install comando in workload-set modalità di aggiornamento con la versione del set di carico di lavoro specificata. Il comando non installa più automaticamente il carico di lavoro più recente in base a manifesti separati.

Per "aggiungere" il comando install:

  1. Scegliere una versione del set di carichi di lavoro. Ad esempio: 9.0.100-preview.7.24414.1.

  2. Scegliere un carico di lavoro. Ad esempio: aspire.

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

    Quando questo comando viene eseguito:

    • Seleziona workload-set la modalità di aggiornamento se non è già selezionata.
    • Ottiene il set di carico di lavoro con la versione specificata.
    • Dal set di carico di lavoro ottiene la versione manifesto del carico di lavoro specificato.
    • Installa la versione del manifesto del carico di lavoro.
    • Rimane in workload-set modalità di aggiornamento al termine.

  4. Scegliere un altro carico di lavoro da installare, ad esempio maui-ios.

  5. dotnet workload install maui-ios

    Questo comando installa il maui-ios carico di lavoro usando la versione del carico di lavoro dalla versione 9.0.100-preview.7.24414.1del set di carico di lavoro , dal momento che l'esempio di comando precedente install ha aggiunto il set di carico di lavoro.

L'uso di --version con o install update pin install alla versione specificata, ma update è configurato solo per workload-set la modalità di aggiornamento, non per una versione specifica del set di carico di lavoro. Se quindi si esegue dotnet workload update senza l'opzione --version , il update comando :

  • Aggiorna i carichi di lavoro alla versione più recente disponibile del set di carico di lavoro.
  • "Sblocca" il comando install.
  • Rimane in workload-set modalità di aggiornamento.

Aggiornare usando il set di carico di lavoro più recente

Per aggiornare i carichi di lavoro installati alla versione più recente del set di carico di lavoro disponibile nei feed configurati, eseguire i comandi seguenti:

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

    Il comando precedente è necessario solo se si è attualmente in modalità di aggiornamento dei manifesti. Se non si sa, controllare la modalità di aggiornamento corrente.

  2. dotnet workload update

    In workload-set modalità di aggiornamento, questo comando aggiorna i carichi di lavoro alla versione più recente del set di carico di lavoro, a meno che non sia stata specificata la versione del set di carico di lavoro in global.json.

Eseguire l'aggiornamento a una versione del set di carico di lavoro

Per specificare una versione del set di carico di lavoro da aggiornare a quando non viene specificata in global.json, usare l'opzione --version del update comando :

  1. Scegliere una versione del set di carichi di lavoro. Ad esempio: 8.0.400.

  2. dotnet workload update --version 8.0.400

    workload-set la modalità di aggiornamento verrà selezionata se non è già selezionata.

Usare global.json per la versione del set di carico di lavoro

Per usare un global.json file per specificare la versione del set di carico di lavoro per un repository:

  1. Scegliere una versione del set di carichi di lavoro. Ad esempio: 9.0.100-preview.7.24414.1.

  2. Creare un global.json file simile all'esempio seguente:

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

Con la directory corrente nello stesso repository e l'interfaccia della riga di comando in workload-set modalità di aggiornamento, i installcomandi , updatee restore installano i carichi di lavoro per la versione del set di carico di lavoro specificata. Se non si dispone di un file global.json e si è in workload-set modalità di aggiornamento, il restore comando installa la versione del set di carico di lavoro stabilita quando si passa dalla modalità di aggiornamento dei manifesti alla workload-set modalità di aggiornamento.

Se si dispone di una versione del set di carico di lavoro nel file global.json, i comandi del carico di lavoro sono in workload-set modalità anche se non si esegue il config comando o si usa --version. Il file global.json esegue l'override. Per usare l'opzione --version in questo caso, eseguire il comando all'esterno del percorso contenente il file global.json.

Se non si specifica la versione del set di carico di lavoro in global.json, è possibile usare l'opzione --version con il restore comando . In tal caso, il comando restore seleziona workload-set la modalità di aggiornamento prima di ripristinare i carichi di lavoro nella versione specificata del set di carico di lavoro.

Nella modalità di aggiornamento dei manifesti, restore installa o aggiorna i carichi di lavoro alla versione più recente di ogni singolo carico di lavoro.

Controllare la modalità di aggiornamento e la versione

Per visualizzare la modalità di aggiornamento corrente, eseguire il comando config con l'opzione --update-mode senza un argomento. La modalità è workload-set o manifests. Ad esempio:

dotnet workload config --update-mode

workload-set

Per visualizzare la versione corrente del set di carico di lavoro, eseguire dotnet workload --version. Se è installato un set di carico di lavoro, viene visualizzata una versione come 9.0.100-preview.7.24414.1 o 8.0.402. Ad esempio:

dotnet workload --version

9.0.100-preview.7.24414.1

In modalità manifesti o se la versione del set di carico di lavoro non è ancora stata stabilita dopo il passaggio alla workload-set modalità di aggiornamento, viene visualizzata una versione sotto forma di <feature band>-manifests.<hash>. Ad esempio:

dotnet workload --version

9.0.100-manifests.cf958b56

Scegliere una versione del set di carichi di lavoro

I set di carico di lavoro vengono pubblicati in nuget.org con ogni versione di .NET SDK, sotto l'ID Microsoft.NET.Workloads.<feature band>del pacchetto . Per una versione stabile dell'SDK, è sempre disponibile una versione corrispondente del set di carico di lavoro. Quindi 8.0.400 SDK può installare un set di carico di lavoro 8.0.400 e 401 può installare un set 401. In generale, è consigliabile installare il set di carico di lavoro corrispondente per un SDK stabile.

Per le versioni di anteprima, trovare la versione corrispondente del set di carico di lavoro nella scheda README del pacchetto. Ad esempio, vedere la scheda README per il pacchetto .NET 9 Preview 7.

In futuro sarà possibile visualizzare un elenco delle versioni del set di carico di lavoro e le relative informazioni.

Ignorare i set di carico di lavoro

Per installare o eseguire l'aggiornamento a, la versione più recente di ogni singolo carico di lavoro disponibile nei feed configurati, selezionare e usare la modalità di aggiornamento dei manifesti eseguendo il comando del carico di lavoro config :

dotnet workload config --update-mode manifests

In .NET 8.0.4xx SDK la modalità manifesti è l'impostazione predefinita. In questa versione è necessario selezionare la modalità manifesti in modo esplicito solo se è stata selezionata workload-set in precedenza la modalità di aggiornamento in modo esplicito.

Contenuto correlato