/cmr/device/upgrade
upgrade
Starts an upgrade (job) for the selected devices. The upgrade runs as a job in /cmr/upgrade/job, with the same job states and result counters. On the console, the command shows the job's devices and their states...
cmr/device/upgrade
Package: cmr Type: Command
为所选设备启动升级（任务）。升级在 /cmr/upgrade/job 中作为任务运行，具有相同的任务状态和结果计数器。在控制台上，命令会显示任务的设备及其状态，直到您按下 <kbd>Control</kbd>+<kbd>C</kbd> 或 duration 中给定的时间结束；任务会在服务器上继续。使用 order 时，标签组会逐个升级；请将其他设备通过其连接的设备（例如交换机和网关）列在最后。
| 标志 | 名称 | 描述 |
|---|---|---|
L | controller | 包含 CMR 服务器本身（self-client）。 |
| 参数 | 类型 | 描述 |
|---|---|---|
labels | object | 使用标签选择要升级的设备。支持 + 和 - 符号分别作为 AND 和 AND NOT 运算符；如果未提供符号，则使用 OR 运算符。 |
order | object | 执行顺序（按标签）。 |
channel | alt | 升级通道（long-term、stable、testing 或 development）或固定版本，例如 channel=7.24.4。未设置时，每台设备按其自己的升级通道升级，即 /cmr/device 中显示的 channel 值。 |
schedule-time | super { time: date , [day] [ @enum (sun | mon | tue | wed | thu | fri | sat) { sun:1, mon:2, tue:3, wed:4, thu:5, fri:6, sat:7 }] } | 升级开始时间：一个时间，可选在 @ 后给出星期几，例如 14:00:00 或 00:00:00@sat。任务会以 scheduled 状态等待，直到该时间的下一次出现。 |
strategy | enum (parallel | sequential) | 设备升级方式：parallel 同时升级所有覆盖的设备；sequential 逐个升级并等待每个完成。使用 continue-order 时，设备按 order 给出的顺序按标签组处理：parallel 中每组设备一起升级，sequential 中一次一个。默认值：parallel。 |
fail-policy | enum (continue | stop | continue-order) | 设备失败时的行为：continue 跳过失败的设备并继续处理其余设备；stop 在首次失败时停止整个升级，不继续处理剩余设备或下一个标签组；continue-order 跳过失败的设备并继续处理下一个标签组，按 order 给出的顺序逐个处理标签组。使用 sequential 时，失败设备所在组的其余部分会被跳过；使用 parallel 时，仅放弃失败的设备，组中已在进行中的设备会完成。默认值：stop。 |
packages | multi { package: string } | 要升级的软件包。 |