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

Примечание

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

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

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

Чтобы использовать модуль в сценарии, укажите: 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`, а размер блочного устройства и файловой системы различается, файловая система расширяется, чтобы занять все доступное пространство. Поддерживается, если `fstype` имеет одно из значений: `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	Поддержка: отсутствует	В режиме diff возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примечания

Примечание

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

См. также

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

Авторы

Alexander Bulimov (@abulimov)
quidame (@quidame)

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

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