Модуль community.general.beadm — управление загрузочными средами ZFS в системах FreeBSD/Solaris/illumos

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

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

Краткое описание
Параметры
Атрибуты
Примеры
Возвращаемые значения

Краткое описание

Создание, удаление и активация загрузочных сред ZFS.
Монтирование и размонтирование загрузочных сред ZFS.

Параметры

Параметр	Комментарии
description string	Связать описание с новой загрузочной средой. Этот параметр доступен только на платформах Solaris.
force boolean	Указывает, следует ли принудительно размонтировать файловую систему. Варианты: `false` ← (по умолчанию) `true`
mountpoint path	Путь для монтирования загрузочной среды ZFS.
name псевдонимы: be string / обязательный	Имя загрузочной среды ZFS.
options string	Создать наборы данных для новой BE с заданными свойствами ZFS. Можно указать несколько параметров. Этот параметр доступен только на платформах Solaris.
snapshot string	Если указано, новая загрузочная среда клонируется из указанного снимка или неактивной загрузочной среды.
state string	Создать или удалить загрузочную среду ZFS. Варианты: `"absent"` `"activated"` `"mounted"` `"present"` ← (по умолчанию) `"unmounted"`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: full	Может выполняться в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: none	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, нужно изменить в `check_mode`).

Примеры

- name: Create ZFS boot environment
  community.general.beadm:
    name: upgrade-be
    state: present

- name: Create ZFS boot environment from existing inactive boot environment
  community.general.beadm:
    name: upgrade-be
    snapshot: be@old
    state: present

- name: Create ZFS boot environment with compression enabled and description "upgrade"
  community.general.beadm:
    name: upgrade-be
    options: "compression=on"
    description: upgrade
    state: present

- name: Delete ZFS boot environment
  community.general.beadm:
    name: old-be
    state: absent

- name: Mount ZFS boot environment on /tmp/be
  community.general.beadm:
    name: BE
    mountpoint: /tmp/be
    state: mounted

- name: Unmount ZFS boot environment
  community.general.beadm:
    name: BE
    state: unmounted

- name: Activate ZFS boot environment
  community.general.beadm:
    name: upgrade-be
    state: activated

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ	Описание
description string	Описание BE. Возвращается: всегда Пример: `"Upgrade from 9.0 to 10.0"`
force boolean	Указывает, требуется ли принудительное выполнение действия. Возвращается: всегда Пример: `false`
mountpoint string	Точка монтирования BE. Возвращается: всегда Пример: `"/mnt/be"`
name string	Имя BE. Возвращается: всегда Пример: `"pre-upgrade"`
options string	Дополнительные параметры BE. Возвращается: всегда Пример: `"compression=on"`
snapshot string	Снимок ZFS, из которого создаётся BE. Возвращается: всегда Пример: `"rpool/ROOT/oi-hipster@fresh"`
state string	Состояние целевого объекта. Возвращается: всегда Пример: `"present"`

Авторы

Adam Števko (@xen0l)

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

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