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 or no)
  • 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 mode
      • force: 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 migrated
      • ignore: ignore a VM that cannot be live migrated
      • ignore_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                                |
+---------+---------------------------------------------------------------------+