community.general.filesystem – Создаёт файловую систему

Примечание

Этот плагин входит в сборку community.general (версия 1.3.2).

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

Для использования в книге задач укажите: community.general.filesystem.

Описание
Требования
Параметры
Примечания
Примеры

Описание

Этот модуль создаёт файловую систему.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

Использует инструменты, связанные с fstype (mkfs) и командой blkid. Когда resizefs включено, также требуется команда blockdev.

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
dev путь / обязательно		Целевой путь к устройству или файлу образа. псевдонимы: устройство
force булево	Варианты: нет ← да	Если `yes`, позволяет создать новую файловую систему на устройствах, на которых уже есть файловая система.
fstype строка	Варианты: btrfs ext2 ext3 ext4 ext4dev f2fs lvm ocfs2 reiserfs xfs vfat swap	Тип файловой системы, который необходимо создать. Этот параметр требуется с `state=present` (или если state опущено). Поддержка reiserfs была добавлена в версии 2.2. Поддержка lvm была добавлена в версии 2.5. Начиная с версии 2.5, dev может быть файлом образа. Поддержка vfat была добавлена в версии 2.5 Поддержка ocfs2 была добавлена в версии 2.6 Поддержка f2fs была добавлена в версии 2.7 Поддержка swap была добавлена в версии 2.8 псевдонимы: тип
opts строка		Список параметров, которые должны быть переданы команде mkfs.
resizefs булево	Варианты: нет ← да	Если `yes`, если размер блока устройства и файловой системы отличаются, увеличьте размер файловой системы до занятого пространства. Поддерживается для файловых систем `ext2`, `ext3`, `ext4`, `ext4dev`, `f2fs`, `lvm`, `xfs`, `vfat`, `swap`. XFS будет увеличиваться только при подключении. В настоящее время модуль основан на командах из пакета `util-linux`, для выполнения операций, поэтому изменение размера XFS не поддерживается на системах FreeBSD. vFAT, вероятно, потерпит неудачу, если fatresize < 1.04.
state строка добавлен в 1.3.0 community.general	Варианты: present ← absent	Если `state=present`, файловая система создаётся, если она ещё не существует, это поведение по умолчанию, если state опущено. Если `state=absent`, сигнатуры файловой системы на dev удаляются, если она содержит файловую систему (как известно `blkid`). Когда `state=absent`, все остальные параметры, кроме dev игнорируются, и модуль не терпит неудачу, если устройство dev фактически не существует. `state=absent` не поддерживается и вызовет ошибку на системах FreeBSD.

Примечания

Примечание

Возможные файловые системы на dev проверяются с помощью blkid, в случае, если blkid не может обнаружить существующую файловую систему, эта файловая система перезаписывается, даже если force no.
Этот модуль поддерживает check_mode.

Примеры

- name: Create a ext2 filesystem on /dev/sdb1
  community.general.filesystem:
    fstype: ext2
    dev: /dev/sdb1

- name: Create a ext4 filesystem on /dev/sdb1 and check disk blocks
  community.general.filesystem:
    fstype: ext4
    dev: /dev/sdb1
    opts: -cc

- name: Blank filesystem signature on /dev/sdb1
  community.general.filesystem:
    dev: /dev/sdb1
    state: absent

Авторы

Александр Булимов (@abulimov)

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