Модуль community.general.sysupgrade — Управление обновлениями системы OpenBSD

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Эта коллекция, возможно, уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general.

Чтобы использовать его в плейбуке, укажите: community.general.sysupgrade.

Новинка в community.general 1.1.0

Описание
Параметры
Атрибуты
Примеры
Значения возврата

Описание

Управление обновлениями системы OpenBSD с помощью sysupgrade.

Параметры

Параметр	Комментарии
fetch_only boolean	Скачивание и проверка файлов, создание /bsd.upgrade, но без перезагрузки. Установите в `false` значение, если вы хотите, чтобы sysupgrade перезагрузил систему. Это приведет к ошибке Ansible, так как модуль ожидает успешного завершения работы. См. примеры. Варианты: `false` `true` ← (по умолчанию)
force boolean	Принудительное обновление (только для снимков). Варианты: `false` ← (по умолчанию) `true`
installurl string	URL верхнего уровня зеркала OpenBSD для загрузки обновления. По умолчанию URL зеркала извлекается из /etc/installurl.
keep_files boolean	Сохранить файлы в папке /home/_sysupgrade. По умолчанию файлы будут удалены после обновления. Варианты: `false` ← (по умолчанию) `true`
snapshot boolean	Применить последний снимок. В противном случае будет применена версия релиза. Варианты: `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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/sysupgrade_module.html