community / community.general / 6.6.8 / module / filesystem Makes a filesystem Authors: Alexander Bulimov (@abulimov), quidame (@quidame)community.general.filesystem (6.6.8) — module
Install with ansible-galaxy collection install community.general:==6.6.8
collections: - name: community.general version: 6.6.8
This module creates a filesystem.
- 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
dev: aliases: - device description: - Target path to block device (Linux) or character device (FreeBSD) or regular file (both). - When setting Linux-specific filesystem types on FreeBSD, this module only works when applying to regular files, aka disk images. - Currently C(lvm) (Linux-only) and C(ufs) (FreeBSD-only) don't support a regular file as their target I(dev). - Support for character devices on FreeBSD has been added in community.general 3.4.0. required: true type: path opts: description: - List of options to be passed to C(mkfs) command. type: str force: default: false description: - If C(true), allows to create new filesystem on devices that already has filesystem. type: bool state: choices: - present - absent default: present description: - If I(state=present), the filesystem is created if it doesn't already exist, that is the default behaviour if I(state) is omitted. - If I(state=absent), filesystem signatures on I(dev) are wiped if it contains a filesystem (as known by C(blkid)). - When I(state=absent), all other options but I(dev) are ignored, and the module doesn't fail if the device I(dev) doesn't actually exist. type: str version_added: 1.3.0 version_added_collection: community.general fstype: aliases: - type choices: - btrfs - ext2 - ext3 - ext4 - ext4dev - f2fs - lvm - ocfs2 - reiserfs - xfs - vfat - swap - ufs description: - Filesystem type to be created. This option is required with I(state=present) (or if I(state) is omitted). - ufs support has been added in community.general 3.4.0. type: str resizefs: default: false description: - If C(true), if the block device and filesystem size differ, grow the filesystem into the space. - Supported for C(btrfs), C(ext2), C(ext3), C(ext4), C(ext4dev), C(f2fs), C(lvm), C(xfs), C(ufs) and C(vfat) filesystems. Attempts to resize other filesystem types will fail. - XFS Will only grow if mounted. Currently, the module is based on commands from C(util-linux) package to perform operations, so resizing of XFS is not supported on FreeBSD systems. - vFAT will likely fail if C(fatresize < 1.04). type: bool