az fleet updaterun

Note

Essa referência faz parte da extensão de frota da CLI do Azure (versão 2.61.0 ou superior). A extensão instalará automaticamente a primeira vez que você executar um comando az fleet updaterun. Saiba mais sobre extensões.

Comandos para gerenciar execuções de atualização.

Comandos

Nome	Description	Tipo	Status
az fleet updaterun create	Cria ou atualiza uma execução de atualização.	Extension	GA
az fleet updaterun delete	Exclui uma execução de atualização.	Extension	GA
az fleet updaterun list	Lista as execuções de atualização de uma frota.	Extension	GA
az fleet updaterun show	Mostra uma execução de atualização.	Extension	GA
az fleet updaterun skip	Define os destinos a serem ignorados em um UpdateRun.	Extension	GA
az fleet updaterun start	Inicia uma execução de atualização.	Extension	GA
az fleet updaterun stop	Interrompe uma execução de atualização.	Extension	GA
az fleet updaterun wait	Aguarde até que um recurso de execução de atualização atinja um estado desejado.	Extension	GA

az fleet updaterun create

Cria ou atualiza uma execução de atualização.

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]

Exemplos

Crie uma execução de atualização para uma frota com o tipo de atualização 'Completo'.

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

Crie uma execução de atualização para uma frota com o tipo de atualização 'NodeImageOnly'.

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

Crie uma execução de atualização para uma frota com o tipo de atualização 'Completo' & estágios.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--upgrade-type

Especifique o tipo de atualização de membros. Os valores aceitáveis são 'Full', 'ControlPlaneOnly' e 'NodeImageOnly'.

Propriedade	Valor
Valores aceitos:	ControlPlaneOnly, Full, NodeImageOnly

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--kubernetes-version

Especifique a versão do kubernetes para a qual atualizar os membros, quando --upgrade-type for definido como 'Full' ou 'ControlPlaneOnly'. O formato aceitável é x.x.x (por exemplo, 1.2.3).

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-image-selection

A Seleção de Imagem de Nó é uma opção que permite que você escolha como os nós dos clusters são atualizados.

Propriedade	Valor
Valores aceitos:	Consistent, Latest

--stages

Caminho para um arquivo JSON que define estágios para atualizar uma frota. Veja exemplos de referência.

--update-strategy-name

O nome da estratégia de atualização a ser usada para esta execução de atualização. Se não for especificado, a estratégia de atualização padrão será usada.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun delete

Exclui uma execução de atualização.

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

Exemplos

Excluir uma execução de atualização.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun list

Lista as execuções de atualização de uma frota.

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

Exemplos

Mostrar os detalhes de uma execução de atualização.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun show

Mostra uma execução de atualização.

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

Exemplos

Mostrar os detalhes de uma execução de atualização.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun skip

Define os destinos a serem ignorados em um UpdateRun.

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

Exemplos

Defina dois destinos a serem ignorados.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--targets

Versão Prévia

Lista separada por espaço de destinos a serem ignoradas. Os destinos devem ser do formulário 'targetType:targetName', como Group:MyGroup. Os tipos de destino válidos são ('Member', 'Group', 'Stage', 'AfterStageWait'). O tipo de destino diferencia maiúsculas de minúsculas.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun start

Inicia uma execução de atualização.

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

Exemplos

Inicie uma execução de atualização.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun stop

Interrompe uma execução de atualização.

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

Exemplos

Pare uma execução de atualização.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--name -n

Especifique o nome para a execução da atualização.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az fleet updaterun wait

Aguarde até que um recurso de execução de atualização atinja um estado desejado.

Se uma operação em uma execução de atualização foi interrompida ou iniciada com --no-wait, use este comando para aguardar a conclusão.

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

Parâmetros Exigidos

--fleet-name -f

Especifique o nome da frota.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--update-run-name

O nome do recurso UpdateRun. Required.

Parâmetros Opcionais

Os seguintes parâmetros são opcionais, mas dependendo do contexto, um ou mais podem se tornar obrigatórios para que o comando seja executado com sucesso.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments

--deleted

Aguarde até ser excluído.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--exists

Aguarde até que o recurso exista.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

--interval

Intervalo de sondagem em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	30

--timeout

Espera máxima em segundos.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	3600

--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade	Valor
Grupo de parâmetros:	Wait Condition Arguments
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Formato de saída.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Comentários

Esta página foi útil?

Compartilhar via

az fleet updaterun

Comandos

az fleet updaterun create

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az fleet updaterun delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az fleet updaterun list

Exemplos

Parâmetros Exigidos

az fleet updaterun show

Exemplos

Parâmetros Exigidos

az fleet updaterun skip

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az fleet updaterun start

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az fleet updaterun stop

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az fleet updaterun wait

Parâmetros Exigidos

Parâmetros Opcionais

Comentários