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

Примечание

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

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

Для установки используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, подробности см. в разделе Требования.

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

Краткое описание
Требования
Параметры
Атрибуты
Примечания
См. также
Примеры

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

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

Требования

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

Использует специфические инструменты, связанные с fstype для создания или изменения размера файловой системы (из пакетов e2fsprogs, xfsprogs, dosfstools и так далее).
Использует общие инструменты, в основном связанные с операционной системой (Linux или FreeBSD) или доступные на обеих, как blkid.
На FreeBSD требуется пакет util-linux или e2fsprogs.

Параметры

Параметр	Комментарии
dev псевдонимы: device путь / обязательно	Целевой путь к блочному устройству (Linux) или символьному устройству (FreeBSD) или обычному файлу (оба). При установке типов файловых систем, специфичных для Linux, на FreeBSD, этот модуль работает только при применении к обычным файлам, т.е. образам дисков. В настоящее время `lvm` (только Linux) и `ufs` (только FreeBSD) не поддерживают обычный файл в качестве целевого `dev`. Поддержка символьных устройств на FreeBSD была добавлена в community.general 3.4.0.
force булево	Если `true`, позволяет создать новую файловую систему на устройствах, которые уже имеют файловую систему. Варианты: `false` ← (по умолчанию) `true`
fstype псевдонимы: type строка	Тип создаваемой файловой системы. Этот параметр обязателен с `state=present` (или если `state` пропущен). Поддержка ufs была добавлена в community.general 3.4.0. Поддержка bcachefs была добавлена в community.general 8.6.0. Варианты: `"bcachefs"` `"btrfs"` `"ext2"` `"ext3"` `"ext4"` `"ext4dev"` `"f2fs"` `"lvm"` `"ocfs2"` `"reiserfs"` `"xfs"` `"vfat"` `"swap"` `"ufs"`
opts строка	Список параметров, которые будут переданы команде `mkfs`.
resizefs булево	Если `true`, если размер блочного устройства и файловой системы различаются, увеличьте файловую систему до этого размера. Поддерживается для файловых систем `bcachefs`, `btrfs`, `ext2`, `ext3`, `ext4`, `ext4dev`, `f2fs`, `lvm`, `xfs`, `ufs` и `vfat` . Попытки изменить размер других типов файловых систем завершатся неудачей. XFS будет увеличиваться только если смонтирована. В настоящее время модуль основан на командах из пакета `util-linux` для выполнения операций, поэтому изменение размера XFS не поддерживается в системах FreeBSD. vFAT, скорее всего, завершится ошибкой, если `fatresize < 1.04`. Взаимоисключающе с `uuid`. Варианты: `false` ← (по умолчанию) `true`
state строка добавлено в community.general 1.3.0	Если `state=present`, файловая система создается, если она еще не существует, это поведение по умолчанию, если `state` пропущен. Если `state=absent`, сигнатуры файловой системы на `dev` будут очищены, если она содержит файловую систему (как известно `blkid`). Когда `state=absent`, все другие параметры, кроме `dev`, игнорируются, и модуль не завершается ошибкой, если устройство `dev` на самом деле не существует. Варианты: `"present"` ← (по умолчанию) `"absent"`
uuid строка добавлено в community.general 7.1.0	Установите UUID файловой системы на заданное значение. Параметры UUID, указанные в `opts`, имеют приоритет над этим значением. См. xfs_admin(8) (`xfs`), tune2fs(8) (`ext2`, `ext3`, `ext4`, `ext4dev`) для возможных значений. Для `fstype=lvm` значение игнорируется, оно сбрасывает UUID PV, если он установлен. Поддерживается для `fstype`, являющегося одним из `bcachefs`, `ext2`, `ext3`, `ext4`, `ext4dev`, `lvm` или `xfs`. Это не идемпотентно. Указание этого параметра всегда приведет к изменению. Взаимоисключающе с `resizefs`.

Атрибуты

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

Примечания

Примечание

Возможные файловые системы на dev проверяются с помощью blkid. В случае, если blkid не может обнаружить файловую систему (и в случае, если fstyp в FreeBSD также не может обнаружить файловую систему), эта файловая система перезаписывается, даже если force является false.
В системах FreeBSD пакеты e2fsprogs и util-linux предоставляют команду blkid, совместимую с этим модулем. Однако эти пакеты конфликтуют друг с другом, и только пакет util-linux предоставляет команду, необходимую для того, чтобы не произошёл сбой при state=absent.

См. также

community.general.filesize: Создать файл заданного размера или изменить его размер, если он существует.
ansible.posix.mount: Управление активными и настроенными точками монтирования.
xfs_admin(8) manpage для Linux: Справочная страница реализации xfs_admin GNU/Linux
tune2fs(8) manpage для Linux: Справочная страница реализации tune2fs GNU/Linux

Примеры

- 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

- name: Create a filesystem on top of a regular file
  community.general.filesystem:
    dev: /path/to/disk.img
    fstype: vfat

- name: Reset an xfs filesystem UUID on /dev/sdb1
  community.general.filesystem:
    fstype: xfs
    dev: /dev/sdb1
    uuid: generate

- name: Reset an ext4 filesystem UUID on /dev/sdb1
  community.general.filesystem:
    fstype: ext4
    dev: /dev/sdb1
    uuid: random

- name: Reset an LVM filesystem (PV) UUID on /dev/sdc
  community.general.filesystem:
    fstype: lvm
    dev: /dev/sdc
    uuid: random

Авторы

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

Ссылки на сборку

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