Partilhar via

az fleet updaterun

  • Referência

Nota

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

Name 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 o 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 'Completa'.

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 estágios do 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 Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

o 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'.

Valores aceites: 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 espere que a operação de longa duração termine.

Default value: 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 aceites: 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 esta atualização é executado. Se não for especificado, a estratégia de atualização padrão será usada.

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Parâmetros Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

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

Parâmetros Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 duas metas a serem ignoradas.

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

Parâmetros Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
--targets
Pré-visualizar

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

Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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 Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. 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

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

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

Parâmetros Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--name -n

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

--resource-group -g

o 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 espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az fleet updaterun wait

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

Se uma operação em uma execução de atualização foi interrompida ou foi 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 Obrigatórios

--fleet-name -f

Especifique o nome da frota.

--resource-group -g

o 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ório.

Parâmetros Opcionais

--created

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

Default value: 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.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--interval

Intervalo de sondagem em segundos.

Default value: 30
--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

Aumente a verbosidade 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 aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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