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

Примечание

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

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

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

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

Обзор
Параметры
Атрибуты
Примеры
Возвращаемые значения

Обзор

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

Параметры

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

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в `check_mode` и возвращать предсказание статуса изменения без модификации целевого объекта.
diff_mode	Поддержка: нет	Будет возвращать детали о том, что изменилось (или, возможно, нуждается в изменении в `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

END_OF_DOCUMENT_MARKER

Значения возврата

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

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

Авторы

Adam Števko (@xen0l)

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

© 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/beadm_module.html