community.general.sysupgrade 模块 – 管理 OpenBSD 系统升级

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您使用的是 ansible 软件包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 playbook 中使用它，请指定：community.general.sysupgrade。

community.general 1.1.0 中的新增功能

概要

  • 使用 sysupgrade 管理 OpenBSD 系统升级。

参数

参数

注释

fetch_only

布尔值

仅获取和验证文件并创建 /bsd.upgrade，但不重启。

如果要 sysupgrade 重启，则设置为 false。这将导致 Ansible 报错，因为它期望模块优雅地退出。请参见示例。

选项

  • false

  • true ← (默认)

force

布尔值

强制升级（仅限快照）。

选项

  • false ← (默认)

  • true

installurl

字符串

用于获取升级的 OpenBSD 镜像顶级 URL。

默认情况下，镜像 URL 从 /etc/installurl 获取。

keep_files

布尔值

保留 /home/_sysupgrade 下的文件。

默认情况下，升级后将删除这些文件。

选项

  • false ← (默认)

  • true

snapshot

布尔值

应用最新的快照。

否则将应用发行版。

选项

  • false ← (默认)

  • true

属性

属性

支持

描述

check_mode

支持：不支持

可以在 check_mode 下运行并返回更改状态预测，而无需修改目标。

diff_mode

支持：不支持

处于 diff 模式时，将返回有关已更改内容（或可能需要在 check_mode 中更改的内容）的详细信息。

示例

- name: Upgrade to latest release
  community.general.sysupgrade:
  register: sysupgrade

- name: Upgrade to latest snapshot
  community.general.sysupgrade:
    snapshot: true
    installurl: https://cloudflare.cdn.openbsd.org/pub/OpenBSD
  register: sysupgrade

- name: Reboot to apply upgrade if needed
  ansible.builtin.reboot:
  when: sysupgrade.changed

# Note: Ansible will error when running this way due to how
#   the reboot is forcefully handled by sysupgrade:

- name: Have sysupgrade automatically reboot
  community.general.sysupgrade:
    fetch_only: false
  ignore_errors: true

返回值

常见的返回值已在 此处 记录，以下是此模块特有的字段

键

描述

rc

整数

命令返回码（0 表示成功）。

返回：始终返回

stderr

字符串

Sysupgrade 标准错误。

返回：始终返回

示例："sysupgrade: need root privileges"

stdout

字符串

Sysupgrade 标准输出。

返回：始终返回

作者

  • Andrew Klaus (@precurse)