Share via

az fleet updaterun

  • Referenz

Hinweis

Diese Referenz ist Teil der Flottenerweiterung für die Azure CLI (Version 2.48.0 oder höher). Die Erweiterung wird automatisch installiert, wenn Sie einen az fleet updaterun-Befehl zum ersten Mal ausführen. Weitere Informationen zu Erweiterungen

Befehle zum Verwalten von Updates werden ausgeführt.

Befehle

Name Beschreibung Typ Status
az fleet updaterun create

Erstellt oder aktualisiert eine Updateausführung.

 Erweiterung Allgemein verfügbar
az fleet updaterun delete

Löscht eine Aktualisierungsausführung.

 Erweiterung Allgemein verfügbar
az fleet updaterun list

Listet die Aktualisierungsläufe einer Flotte auf.

 Erweiterung Allgemein verfügbar
az fleet updaterun show

Zeigt eine Aktualisierungsausführung an.

 Erweiterung Allgemein verfügbar
az fleet updaterun skip

Legt ziele fest, die in einem UpdateRun übersprungen werden sollen.

 Erweiterung Allgemein verfügbar
az fleet updaterun start

Startet eine Aktualisierungsausführung.

 Erweiterung Allgemein verfügbar
az fleet updaterun stop

Beendet die Ausführung eines Updates.

 Erweiterung Allgemein verfügbar
az fleet updaterun wait

Warten Sie, bis eine Aktualisierungsausführungsressource einen gewünschten Zustand erreicht.

 Erweiterung Allgemein verfügbar

az fleet updaterun create

Erstellt oder aktualisiert eine Updateausführung.

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]

Beispiele

Erstellen Sie einen Updatelauf für eine Flotte mit dem Upgradetyp "Vollständig".

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

Erstellen Sie eine Aktualisierungsausführung für eine Flotte mit dem Upgradetyp "NodeImageOnly".

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

Erstellen Sie einen Updatelauf für eine Flotte mit dem Upgradetyp "Voll" und Stufen.

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"
                    }
                ]
            },
        ]
    }

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--upgrade-type

Geben Sie den Upgradetyp von Mitgliedern an. Zulässige Werte sind "Full", "ControlPlaneOnly" und "NodeImageOnly".

Zulässige Werte: ControlPlaneOnly, Full, NodeImageOnly

Optionale Parameter

--kubernetes-version

Geben Sie die Kubernetes-Version an, auf die Member aktualisiert werden sollen, wenn "--upgrade-type" auf "Full" oder "ControlPlaneOnly" festgelegt ist. Zulässiges Format ist x.x.x (z. B. 1.2.3).

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--node-image-selection

Die Knotenbildauswahl ist eine Option, mit der Sie auswählen können, wie die Knoten Ihrer Cluster aktualisiert werden.

Zulässige Werte: Consistent, Latest
--stages

Pfad zu einer JSON-Datei, die Phasen zum Upgrade einer Flotte definiert. Weitere Informationen finden Sie in den Beispielen.

--update-strategy-name

Der Name der Updatestrategie, die für diese Updateausführung verwendet werden soll. Wenn nicht angegeben, wird die Standardupdatestrategie verwendet.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun delete

Löscht eine Aktualisierungsausführung.

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

Beispiele

Löschen sie eine Aktualisierungsausführung.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--yes -y

Nicht zur Bestätigung auffordern

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun list

Listet die Aktualisierungsläufe einer Flotte auf.

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

Beispiele

Zeigen Sie die Details einer Aktualisierungsausführung an.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun show

Zeigt eine Aktualisierungsausführung an.

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

Beispiele

Zeigen Sie die Details einer Aktualisierungsausführung an.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun skip

Legt ziele fest, die in einem UpdateRun übersprungen werden sollen.

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

Beispiele

Legen Sie zwei Ziele fest, die übersprungen werden sollen.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
--targets
Vorschau

Durch Leerzeichen getrennte Liste der ziele, die übersprungen werden sollen. Ziele müssen dem Formular 'targetType:targetName' wie Group:MyGroup zugeordnet sein. Gültige Zieltypen sind ('Member', 'Group', 'Stage', 'AfterStageWait'). Bei dem Zieltyp wird die Groß-/Kleinschreibung beachtet.

Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun start

Startet eine Aktualisierungsausführung.

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

Beispiele

Starten Sie eine Aktualisierungsausführung.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun stop

Beendet die Ausführung eines Updates.

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

Beispiele

Beenden Sie die Ausführung eines Updates.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--name -n

Geben Sie den Namen für die Updateausführung an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

Optionale Parameter

--no-wait

Nicht auf den Abschluss lang andauernder Vorgänge warten

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.

az fleet updaterun wait

Warten Sie, bis eine Aktualisierungsausführungsressource einen gewünschten Zustand erreicht.

Wenn ein Vorgang für eine Updateausführung unterbrochen oder mit --no-waitdem Vorgang gestartet wurde, verwenden Sie diesen Befehl, um auf den Abschluss zu warten.

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

Erforderliche Parameter

--fleet-name -f

Geben Sie den Flottennamen an.

--resource-group -g

Name der Ressourcengruppe Sie können die Standardgruppe mit az configure --defaults group=<name> konfigurieren.

--update-run-name

Der Name der UpdateRun-Ressource. Erforderlich.

Optionale Parameter

--created

Warten Sie, bis sie mit 'provisioningState' unter 'Succeeded' erstellt wurde.

Standardwert: False
--custom

Warten Sie, bis die Bedingung eine benutzerdefinierte JMESPath-Abfrage erfüllt. Beispiel: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Warten Sie, bis sie gelöscht wurde.

Standardwert: False
--exists

Warten Sie, bis die Ressource vorhanden ist.

Standardwert: False
--interval

Abrufintervall in Sekunden.

Standardwert: 30
--timeout

Maximale Wartezeit in Sekunden.

Standardwert: 3600
--updated

Warten Sie, bis sie mit provisioningState unter 'Succeeded' aktualisiert wurde.

Standardwert: False
Globale Parameter
--debug

Ausführlichkeit der Protokollierung erhöhen, um alle Debugprotokolle anzuzeigen.

--help -h

Zeigen Sie diese Hilfemeldung an, und schließen Sie sie.

--only-show-errors

Nur Fehler anzeigen und Warnungen unterdrücken.

--output -o

Ausgabeformat.

Zulässige Werte: json, jsonc, none, table, tsv, yaml, yamlc
Standardwert: json
--query

JMESPath-Abfragezeichenfolge. Weitere Informationen und Beispiele finden Sie unter http://jmespath.org/.

--subscription

Der Name oder die ID des Abonnements. Sie können das standardmäßig verwendete Abonnement mittels az account set -s NAME_OR_ID konfigurieren.

--verbose

Ausführlichkeit der Protokollierung erhöhen. „--debug“ für vollständige Debugprotokolle verwenden.