vinfra software-updates start
Start the software update procedure:
usage: vinfra software-updates start [--maintenance enabled={yes,no}[,key=value,…]] [--nodes <nodes>] [--skip-control-plane]
--maintenance enabled={yes,no}[,key=value,…]>
-
Specify maintenance parameters:
enabled
: enter maintenance during the upgrade (yes
orno
)-
comma-separated
key=value
pairs with keys (optional):-
on-fail
: choose how to proceed with the update if maintenance fails:stop
(default): stop the update if a node cannot enter maintenance mode. Nodes that have already been updated will remain so.skip
: skip and do not update nodes that cannot enter maintenance modeforce
: forcibly update and reboot (if needed) all nodes even if they cannot enter maintenance mode. Using this option may result in downtime.
-
compute-mode
: choose how to proceed with the update if a VM cannot be live migrated:strict
: stop the upgrade if a VM cannot be live migratedignore
: ignore a VM that cannot be live migratedignore_ext
: ignore a VM that cannot be or failed to be live migrated
-
- --nodes <nodes>
- A comma-separated list of node IDs or hostnames
--skip-control-plane
- Update the cluster without updating the management panel.
Example:
# vinfra software-updates start --nodes node001,node002,node003 \ --maintenance enabled=yes,on-fail=skip,compute-mode=ignore +---------+--------------------------------------+ | Field | Value | +---------+--------------------------------------+ | task_id | 0eae9159-7595-42a7-8feb-d04df3e295c7 | +---------+--------------------------------------+
This command creates a task to start updating the nodes node001
, node002
, and node003
and put them into maintenance. Those nodes that cannot enter maintenance will be skipped. Virtual machines that cannot be live migrated during maintenance will be ignored.
Task outcome:
# vinfra task show 0eae9159-7595-42a7-8feb-d04df3e295c7 +---------+---------------------------------------------------------------------+ | Field | Value | +---------+---------------------------------------------------------------------+ | details | | | name | backend.business.models.software_updates.tasks.StartSoftwareUpdate… | | result | | | state | running | | task_id | 0eae9159-7595-42a7-8feb-d04df3e295c7 | +---------+---------------------------------------------------------------------+