Partager via

az fleet updaterun

  • Référence

Remarque

Cette référence fait partie de l’extension de flotte pour Azure CLI (version 2.61.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az fleet updaterun . En savoir plus sur les extensions.

Commandes pour gérer les exécutions de mises à jour.

Commandes

Nom Description Type État
az fleet updaterun create

Crée ou met à jour une exécution de mise à jour.

 Extension GA
az fleet updaterun delete

Supprime une exécution de mise à jour.

 Extension GA
az fleet updaterun list

Répertorie les exécutions de mises à jour d’une flotte.

 Extension GA
az fleet updaterun show

Affiche une exécution de mise à jour.

 Extension GA
az fleet updaterun skip

Définit les cibles à ignorer dans un UpdateRun.

 Extension GA
az fleet updaterun start

Démarre une exécution de mise à jour.

 Extension GA
az fleet updaterun stop

Arrête une exécution de mise à jour.

 Extension GA
az fleet updaterun wait

Attendez qu’une ressource d’exécution de mise à jour atteigne un état souhaité.

 Extension GA

az fleet updaterun create

Crée ou met à jour une exécution de mise à jour.

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]

Exemples

Créez une exécution de mise à jour pour une flotte avec le type de mise à niveau « Full ».

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

Créez une exécution de mise à jour pour une flotte avec le type de mise à niveau « NodeImageOnly ».

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

Créez une exécution de mise à jour pour une flotte avec le type de mise à niveau « Complet » et les étapes.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--upgrade-type

Spécifiez le type de mise à niveau des membres. Les valeurs acceptables sont « Full », « ControlPlaneOnly » et « NodeImageOnly ».

Valeurs acceptées: ControlPlaneOnly, Full, NodeImageOnly

Paramètres facultatifs

--kubernetes-version

Spécifiez la version kubernetes vers laquelle mettre à niveau les membres, lorsque --upgrade-type a la valeur « Full » ou « ControlPlaneOnly ». Le format acceptable est x.x.x (par exemple, 1.2.3).

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--node-image-selection

La sélection d’images de nœud est une option qui vous permet de choisir la façon dont les nœuds de vos clusters sont mis à niveau.

Valeurs acceptées: Consistent, Latest
--stages

Chemin d’accès à un fichier JSON qui définit les étapes de mise à niveau d’une flotte. Consultez des exemples de référence.

--update-strategy-name

Nom de la stratégie de mise à jour à utiliser pour cette exécution de mise à jour. Si elle n’est pas spécifiée, la stratégie de mise à jour par défaut est utilisée.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun delete

Supprime une exécution de mise à jour.

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

Exemples

Supprimez une exécution de mise à jour.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--yes -y

Ne pas demander de confirmation.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun list

Répertorie les exécutions de mises à jour d’une flotte.

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

Exemples

Affichez les détails d’une exécution de mise à jour.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun show

Affiche une exécution de mise à jour.

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

Exemples

Affichez les détails d’une exécution de mise à jour.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun skip

Définit les cibles à ignorer dans un UpdateRun.

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

Exemples

Définissez deux cibles à ignorer.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
--targets
Préversion

Liste séparée par l’espace des cibles à ignorer. Les cibles doivent être de la forme « targetType :targetName » telle que Group :MyGroup. Les types cibles valides sont ('Member', 'Group', 'Stage', 'AfterStageWait'). Le type cible respecte la casse.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun start

Démarre une exécution de mise à jour.

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

Exemples

Démarrez une exécution de mise à jour.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun stop

Arrête une exécution de mise à jour.

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

Exemples

Arrêtez une exécution de mise à jour.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--name -n

Spécifiez le nom de l’exécution de la mise à jour.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres facultatifs

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az fleet updaterun wait

Attendez qu’une ressource d’exécution de mise à jour atteigne un état souhaité.

Si une opération sur une exécution de mise à jour a été interrompue ou a été démarrée --no-wait, utilisez cette commande pour attendre qu’elle se termine.

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

Paramètres obligatoires

--fleet-name -f

Spécifiez le nom de la flotte.

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--update-run-name

Nom de la ressource UpdateRun. Obligatoire.

Paramètres facultatifs

--created

Attendez la création avec « provisioningState » sur « Succeeded ».

Valeur par défaut: False
--custom

Attendez que la condition réponde à une requête JMESPath personnalisée. Par exemple, provisioningState !='InProgress', instanceView.statuses[ ?code=='PowerState/running'].

--deleted

Attendez la suppression.

Valeur par défaut: False
--exists

Attendez que la ressource existe.

Valeur par défaut: False
--interval

Intervalle d’interrogation en secondes.

Valeur par défaut: 30
--timeout

Délai maximal d’attente en secondes.

Valeur par défaut: 3600
--updated

Attendez la mise à jour avec provisioningState sur « Réussi ».

Valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

Valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
Valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.