Condividi tramite

az fleet updaterun

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione fleet per l'interfaccia della riga di comando di Azure (versione 2.61.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az fleet updaterun . Altre informazioni sulle estensioni.

Comandi per gestire le esecuzioni degli aggiornamenti.

Comandi

Nome Descrizione Tipo Status
az fleet updaterun create

Crea o aggiorna un'esecuzione di aggiornamento.

 Estensione Disponibilità generale
az fleet updaterun delete

Elimina un'esecuzione di aggiornamento.

 Estensione Disponibilità generale
az fleet updaterun list

Elenca le esecuzioni di aggiornamento di una flotta.

 Estensione Disponibilità generale
az fleet updaterun show

Mostra un'esecuzione di aggiornamento.

 Estensione Disponibilità generale
az fleet updaterun skip

Imposta le destinazioni da ignorare all'interno di un oggetto UpdateRun.

 Estensione Disponibilità generale
az fleet updaterun start

Avvia un'esecuzione di aggiornamento.

 Estensione Disponibilità generale
az fleet updaterun stop

Arresta un'esecuzione di aggiornamento.

 Estensione Disponibilità generale
az fleet updaterun wait

Attendere che una risorsa di esecuzione dell'aggiornamento raggiunga uno stato desiderato.

 Estensione Disponibilità generale

az fleet updaterun create

Crea o aggiorna un'esecuzione di aggiornamento.

az fleet updaterun create --fleet-name
                          --name
                          --resource-group
                          --upgrade-type {ControlPlaneOnly, Full, NodeImageOnly}
                          [--kubernetes-version]
                          [--no-wait]
                          [--node-image-selection {Consistent, Latest}]
                          [--stages]
                          [--update-strategy-name]

Esempio

Creare un'esecuzione di aggiornamento per una flotta con tipo di aggiornamento "Completo".

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type Full --kubernetes-version 1.25.0 --node-image-selection Latest

Creare un'esecuzione di aggiornamento per una flotta con il tipo di aggiornamento "NodeImageOnly".

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type NodeImageOnly --node-image-selection Latest

Creare un'esecuzione di aggiornamento per una flotta con tipo di aggiornamento completo e fasi.

az fleet updaterun create -g MyResourceGroup -f MyFleet -n MyUpdateRun --upgrade-type Full --kubernetes-version 1.25.0 --node-image-selection Latest --stages ./test/stages.json

    The following JSON structure represents example contents of the parameter '--stages ./test/stages.json'.
    A stages array is composed of one or more stages, each containing one or more groups.
    Each group contains the 'name' property, which represents the group to which a cluster belongs (see 'az fleet member create --help').
    Stages have an optional 'afterStageWaitInSeconds' integer property, acting as a delay between stage execution.
    {
        "stages": [
            {
                "name": "stage1",
                "groups": [
                    {
                        "name": "group-a1"
                    },
                    {
                        "name": "group-a2"
                    },
                    {
                        "name": "group-a3"
                    }
                ],
                "afterStageWaitInSeconds": 3600
            },
            {
                "name": "stage2",
                "groups": [
                    {
                        "name": "group-b1"
                    },
                    {
                        "name": "group-b2"
                    },
                    {
                        "name": "group-b3"
                    }
                ]
            },
        ]
    }

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--upgrade-type

Specificare il tipo di aggiornamento dei membri. I valori accettabili sono 'Full', 'ControlPlaneOnly' e 'NodeImageOnly'.

Valori accettati: ControlPlaneOnly, Full, NodeImageOnly

Parametri facoltativi

--kubernetes-version

Specificare la versione di kubernetes per aggiornare i membri a, quando --upgrade-type è impostato su 'Full' o 'ControlPlaneOnly'. Il formato accettabile è x.x.x (ad esempio 1.2.3).

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--node-image-selection

Selezione immagine nodo è un'opzione che consente di scegliere la modalità di aggiornamento dei nodi dei cluster.

Valori accettati: Consistent, Latest
--stages

Percorso di un file JSON che definisce le fasi per aggiornare una flotta. Per informazioni di riferimento, vedere esempi.

--update-strategy-name

Nome della strategia di aggiornamento da usare per l'esecuzione dell'aggiornamento. Se non specificato, verrà usata la strategia di aggiornamento predefinita.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun delete

Elimina un'esecuzione di aggiornamento.

az fleet updaterun delete --fleet-name
                          --name
                          --resource-group
                          [--no-wait]
                          [--yes]

Esempio

Eliminare un'esecuzione di aggiornamento.

az fleet updaterun delete -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun list

Elenca le esecuzioni di aggiornamento di una flotta.

az fleet updaterun list --fleet-name
                        --resource-group

Esempio

Visualizzare i dettagli di un'esecuzione dell'aggiornamento.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun show

Mostra un'esecuzione di aggiornamento.

az fleet updaterun show --fleet-name
                        --name
                        --resource-group

Esempio

Visualizzare i dettagli di un'esecuzione dell'aggiornamento.

az fleet updaterun show -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun skip

Imposta le destinazioni da ignorare all'interno di un oggetto UpdateRun.

az fleet updaterun skip --fleet-name
                        --name
                        --resource-group
                        [--no-wait]
                        [--targets]

Esempio

Impostare due destinazioni da ignorare.

az fleet updaterun skip -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun --targets Group:my-group-name Stage:my-stage-name

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
--targets
Anteprima

Elenco delimitato da spazi di destinazioni da ignorare. Le destinazioni devono essere nel formato "targetType:targetName", ad esempio Group:MyGroup. I tipi di destinazione validi sono ('Member', 'Group', 'Stage', 'AfterStageWait'). Il tipo di destinazione fa distinzione tra maiuscole e minuscole.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun start

Avvia un'esecuzione di aggiornamento.

az fleet updaterun start --fleet-name
                         --name
                         --resource-group
                         [--no-wait]

Esempio

Avviare un'esecuzione di aggiornamento.

az fleet updaterun start -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun stop

Arresta un'esecuzione di aggiornamento.

az fleet updaterun stop --fleet-name
                        --name
                        --resource-group
                        [--no-wait]

Esempio

Arrestare un'esecuzione dell'aggiornamento.

az fleet updaterun stop -g MyFleetResourceGroup -f MyFleetName -n NameofUpdateRun

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--name -n

Specificare il nome per l'esecuzione dell'aggiornamento.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az fleet updaterun wait

Attendere che una risorsa di esecuzione dell'aggiornamento raggiunga uno stato desiderato.

Se un'operazione su un'esecuzione di aggiornamento è stata interrotta o è stata avviata con --no-wait, usare questo comando per attendere il completamento.

az fleet updaterun wait --fleet-name
                        --resource-group
                        --update-run-name
                        [--created]
                        [--custom]
                        [--deleted]
                        [--exists]
                        [--interval]
                        [--timeout]
                        [--updated]

Parametri necessari

--fleet-name -f

Specificare il nome della flotta.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--update-run-name

Nome della risorsa UpdateRun. Obbligatorio.

Parametri facoltativi

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.