'; // Create a banner if we're not on the official docs site if (location.host == "docs.testing.ansible.com") { document.write('

' + '

This is the testing site for Ansible Documentation. Unless you are reviewing pre-production changes, please visit the official documentation website.

' + '

'); } // Create a banner current_url_path = window.location.pathname; var important = false; var msg = '

'; if (startsWith(current_url_path, "/ansible-core/")) { msg += 'You are reading documentation for Ansible Core, which contains no plugins except for those in ansible.builtin. For documentation of the Ansible package, go to the latest documentation.'; } else if (startsWithOneOf(current_url_path, ["/ansible/latest/", "/ansible/11/"])) { /* temp extra banner to advertise something */ banner += extra_banner; msg += 'This is the latest (stable) Ansible community documentation. For Red Hat Ansible Automation Platform subscriptions, see Life Cycle for version details.'; } else if (startsWith(current_url_path, "/ansible/2.9/")) { msg += 'You are reading the latest Red Hat released version of the Ansible documentation. Community users can use this version, or select latest from the version selector to the left for the most recent community version.'; } else if (startsWith(current_url_path, "/ansible/devel/")) { /* temp extra banner to advertise something */ banner += extra_banner; msg += 'You are reading the devel version of the Ansible documentation - this version is not guaranteed stable. Use the version selection to the left if you want the latest (stable) released version.'; } else { msg += 'You are reading an older version of the Ansible documentation. Use the version selection to the left if you want the latest (stable) released version.'; /* temp extra banner to advertise something - this is for testing*/ banner += extra_banner; } msg += '

'; banner += '

'; banner += important ? '
' : ''; banner += msg; banner += important ? '
' : ''; banner += '

'; document.write(banner);

community.general.filesystem module – Makes a filesystem

Note

This module is part of the community.general collection (version 10.7.0).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: community.general.filesystem.

Synopsis 

This module creates a filesystem.

Requirements 

The below requirements are needed on the host that executes this module.

Uses specific tools related to the fstype for creating or resizing a filesystem (from packages e2fsprogs, xfsprogs, dosfstools, and so on).
Uses generic tools mostly related to the Operating System (Linux or FreeBSD) or available on both, as blkid.
On FreeBSD, either util-linux or e2fsprogs package is required.

Parameters 

Parameter	Comments
dev aliases: device path / required	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 `lvm` (Linux-only) and `ufs` (FreeBSD-only) do not support a regular file as their target `dev`. Support for character devices on FreeBSD has been added in community.general 3.4.0.
force boolean	If `true`, allows to create new filesystem on devices that already has filesystem. Choices: `false` ← (default) `true`
fstype aliases: type string	Filesystem type to be created. This option is required with `state=present` (or if `state` is omitted). Ufs support has been added in community.general 3.4.0. Bcachefs support has been added in community.general 8.6.0. Choices: `"bcachefs"` `"btrfs"` `"ext2"` `"ext3"` `"ext4"` `"ext4dev"` `"f2fs"` `"lvm"` `"ocfs2"` `"reiserfs"` `"xfs"` `"vfat"` `"swap"` `"ufs"`
opts string	List of options to be passed to `mkfs` command.
resizefs boolean	If `true`, if the block device and filesystem size differ, grow the filesystem into the space. Supported for `bcachefs`, `btrfs`, `ext2`, `ext3`, `ext4`, `ext4dev`, `f2fs`, `lvm`, `xfs`, `ufs` and `vfat` filesystems. Attempts to resize other filesystem types will fail. XFS Will only grow if mounted. Currently, the module is based on commands from `util-linux` package to perform operations, so resizing of XFS is not supported on FreeBSD systems. VFAT will likely fail if `fatresize < 1.04`. Mutually exclusive with `uuid`. Choices: `false` ← (default) `true`
state string added in community.general 1.3.0	If `state=present`, the filesystem is created if it does not already exist, that is the default behaviour if `state` is omitted. If `state=absent`, filesystem signatures on `dev` are wiped if it contains a filesystem (as known by `blkid`). When `state=absent`, all other options but `dev` are ignored, and the module does not fail if the device `dev` does not actually exist. Choices: `"present"` ← (default) `"absent"`
uuid string added in community.general 7.1.0	Set filesystem’s UUID to the given value. The UUID options specified in `opts` take precedence over this value. See xfs_admin(8) (`xfs`), tune2fs(8) (`ext2`, `ext3`, `ext4`, `ext4dev`) for possible values. For `fstype=lvm` the value is ignored, it resets the PV UUID if set. Supported for `fstype` being one of `bcachefs`, `ext2`, `ext3`, `ext4`, `ext4dev`, `lvm`, or `xfs`. This is not idempotent. Specifying this option will always result in a change. Mutually exclusive with `resizefs`.

Attributes 

Attribute	Support	Description
check_mode	Support: full	Can run in `check_mode` and return changed status prediction without modifying target.
diff_mode	Support: none	Will return details on what has changed (or possibly needs changing in `check_mode`), when in diff mode.

Notes 

Note

Potential filesystems on dev are checked using blkid. In case blkid is unable to detect a filesystem (and in case fstyp on FreeBSD is also unable to detect a filesystem), this filesystem is overwritten even if force is false.
On FreeBSD systems, both e2fsprogs and util-linux packages provide a blkid command that is compatible with this module. However, these packages conflict with each other, and only the util-linux package provides the command required to not fail when state=absent.

Examples 

- 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

Authors

Alexander Bulimov (@abulimov)
quidame (@quidame)

community.general.filesystem module – Makes a filesystem

Synopsis 

Requirements 

Parameters 

Attributes 

Notes 

See Also 

Examples 

Authors

Collection links

community.general.filesystem module – Makes a filesystem

Synopsis

Requirements

Parameters

Attributes

Notes

See Also

Examples

Authors

Collection links

Synopsis 

Requirements 

Parameters 

Attributes 

Notes 

See Also 

Examples 