az fleet updaterun

  • Referencia

Nota:

Esta referencia forma parte de la extensión de flota para la CLI de Azure (versión 2.48.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az fleet updaterun . Obtenga más información sobre las extensiones.

Comandos para administrar las ejecuciones de actualizaciones.

Comandos

Nombre Description Tipo Estado
az fleet updaterun create

Crea o actualiza una ejecución de actualización.

 Extensión GA
az fleet updaterun delete

Elimina una ejecución de actualización.

 Extensión GA
az fleet updaterun list

Enumera las ejecuciones de actualización de una flota.

 Extensión GA
az fleet updaterun show

Muestra una ejecución de actualización.

 Extensión GA
az fleet updaterun skip

Establece los destinos que se omitirán dentro de updateRun.

 Extensión GA
az fleet updaterun start

Inicia una ejecución de actualización.

 Extensión GA
az fleet updaterun stop

Detiene una ejecución de actualización.

 Extensión GA
az fleet updaterun wait

Espere a que un recurso de ejecución de actualización alcance un estado deseado.

 Extensión GA

az fleet updaterun create

Crea o actualiza una ejecución de actualización.

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]

Ejemplos

Cree una ejecución de actualización para una flota con el tipo de actualización "Full".

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

Cree una ejecución de actualización para una flota con el tipo de actualización "NodeImageOnly".

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

Cree una ejecución de actualización para una flota con el tipo de actualización "Completo" y las fases.

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 requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--upgrade-type

Especifique el tipo de actualización de miembros. Los valores aceptables son "Full", "ControlPlaneOnly" y "NodeImageOnly".

valores aceptados: ControlPlaneOnly, Full, NodeImageOnly

Parámetros opcionales

--kubernetes-version

Especifique la versión de Kubernetes a la que actualizar miembros cuando --upgrade-type esté establecido en "Full" o "ControlPlaneOnly". El formato aceptable es x.x.x (por ejemplo, 1.2.3).

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--node-image-selection

La selección de imágenes de nodo es una opción que le permite elegir cómo se actualizan los nodos de los clústeres.

valores aceptados: Consistent, Latest
--stages

Ruta de acceso a un archivo JSON que define las fases para actualizar una flota. Consulte ejemplos de referencia.

--update-strategy-name

Nombre de la estrategia de actualización que se va a usar para esta ejecución de actualización. Si no se especifica, se usará la estrategia de actualización predeterminada.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun delete

Elimina una ejecución de actualización.

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

Ejemplos

Elimine una ejecución de actualización.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--yes -y

No solicita confirmación.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun list

Enumera las ejecuciones de actualización de una flota.

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

Ejemplos

Muestra los detalles de una ejecución de actualización.

az fleet updaterun list -g MyFleetResourceGroup -f MyFleetName

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun show

Muestra una ejecución de actualización.

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

Ejemplos

Muestra los detalles de una ejecución de actualización.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun skip

Establece los destinos que se omitirán dentro de updateRun.

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

Ejemplos

Establezca dos destinos que se omitirán.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
--targets
Vista previa

Lista separada por espacios de destinos que se van a omitir. Los destinos deben tener el formato "targetType:targetName", como Group:MyGroup. Los tipos de destino válidos son ('Member', 'Group', 'Stage', 'AfterStageWait'). El tipo de destino distingue mayúsculas de minúsculas.

Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun start

Inicia una ejecución de actualización.

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

Ejemplos

Inicie una ejecución de actualización.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun stop

Detiene una ejecución de actualización.

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

Ejemplos

Detenga una ejecución de actualización.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--name -n

Especifique el nombre de la ejecución de la actualización.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

--no-wait

No espere hasta que finalice la operación de ejecución prolongada.

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.

az fleet updaterun wait

Espere a que un recurso de ejecución de actualización alcance un estado deseado.

Si se interrumpió una operación en una ejecución de actualización o se inició con --no-wait, use este comando para esperar a que se complete.

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

Parámetros requeridos

--fleet-name -f

Especifique el nombre de la flota.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

--update-run-name

Nombre del recurso UpdateRun. Necesario.

Parámetros opcionales

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

valor predeterminado: False
--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Espere hasta que se elimine.

valor predeterminado: False
--exists

Espere hasta que exista el recurso.

valor predeterminado: False
--interval

Intervalo de sondeo en segundos.

valor predeterminado: 30
--timeout

Espera máxima en segundos.

valor predeterminado: 3600
--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
valor predeterminado: json
--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--subscription

Nombre o identificador de la suscripción Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle de registro. Use --debug para obtener registros de depuración completos.