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

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

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

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

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

Описание

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

Требования

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

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

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
dev путь / обязательный		Путь к целевому устройству или файлу образа. псевдонимы: device
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 псевдонимы: type
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	Варианты: наличие ← отсутствие	Если `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–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/general/filesystem_module.html