az fleet updaterun

Referência

Observação

Essa referência faz parte da extensão de frota para a CLI do Azure (versão 2.61.0 ou superior). A extensão será instalada automaticamente na 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.	Extensão	GA
az fleet updaterun delete	Exclui uma execução de atualização.	Extensão	GA
az fleet updaterun list	Lista as execuções de atualização de uma frota.	Extensão	GA
az fleet updaterun show	Mostra uma execução de atualização.	Extensão	GA
az fleet updaterun skip	Define destinos a serem ignorados em um UpdateRun.	Extensão	GA
az fleet updaterun start	Inicia uma execução de atualização.	Extensão	GA
az fleet updaterun stop	Interrompe uma execução de atualização.	Extensão	GA
az fleet updaterun wait	Aguarde até que um recurso de execução de atualização atinja um estado desejado.	Extensão	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 tipo e estágios 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 --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 da execução de 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 dos membros. Os valores aceitáveis são 'Full', 'ControlPlaneOnly' e 'NodeImageOnly'.

Valores aceitos: ControlPlaneOnly, Full, NodeImageOnly

Parâmetros Opcionais

--kubernetes-version

Especifique a versão do kubernetes para a qual atualizar o(s) membro(s), quando --upgrade-type estiver 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 longa.

Valor padrão: False

--node-image-selection

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

Valores aceitos: Consistent, Latest

--stages

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

--update-strategy-name

O nome da estratégia de atualização a ser usada para essa 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet updaterun delete

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

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

Exemplos

Exclua 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 da execução de 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

--no-wait

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

Valor padrão: False

--yes -y

Não solicite confirmação.

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet updaterun list

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

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

Exemplos

Mostre 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet updaterun show

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

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

Exemplos

Mostre 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 da execução de 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 o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet updaterun skip

Define destinos a serem ignorados em um UpdateRun.

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

Exemplos

Defina dois alvos 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 da execução de 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

--no-wait

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

Valor padrão: False

--targets

Versão Prévia

Lista separada por espaço de alvos a serem ignorados. Os destinos devem estar no formato 'targetType:targetName', como Group:MyGroup. Os tipos de destino válidos são ('Membro', 'Grupo', 'Estágio', 'AfterStageWait'). O tipo de destino diferencia maiúsculas de minúsculas.

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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 da execução de 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

--no-wait

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

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

az fleet updaterun stop

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

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

Exemplos

Interrompa 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 da execução de 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

--no-wait

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

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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. Obrigatória.

Parâmetros Opcionais

--created

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

Valor padrão: False

--custom

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

--deleted

Aguarde até ser excluído.

Valor padrão: False

--exists

Aguarde até que o recurso exista.

Valor padrão: False

--interval

Intervalo de sondagem em segundos.

Valor padrão: 30

--timeout

Espera máxima em segundos.

Valor padrão: 3600

--updated

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

Valor padrão: False

Parâmetros Globais

--debug

Aumente o detalhamento do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceitos: json, jsonc, none, table, tsv, yaml, yamlc

Valor padrão: json

--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 o detalhamento do log. Use --debug para logs de depuração completos.

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

Recursos adicionais