Skip to content
This repository has been archived by the owner. It is now read-only.
Go to file
Cannot retrieve contributors at this time
56 lines (36 sloc) 1.83 KB
layout page_title sidebar_current description
Ignition: ignition_filesystem
Describes the desired state of a system’s filesystem.


Describes the desired state of a the system’s filesystems to be configured and/or used with the ignition_file resource.

Example Usage

data "ignition_filesystem" "foo" {
	name = "root"
	mount {
		device = "/dev/disk/by-label/ROOT"
		format = "xfs"
		create = true
		options = ["-L", "ROOT"]

Argument Reference

The following arguments are supported:

  • name - (Optional) The identifier for the filesystem, internal to Ignition. This is only required if the filesystem needs to be referenced in the a ignition_files resource.

  • mount - (Optional) Contains the set of mount and formatting options for the filesystem. A non-null entry indicates that the filesystem should be mounted before it is used by Ignition.

  • path - (Optional) The mount-point of the filesystem. A non-null entry indicates that the filesystem has already been mounted by the system at the specified path. This is really only useful for /sysroot.

The mount block supports:

  • device - (Required) The absolute path to the device. Devices are typically referenced by the /dev/disk/by-* symlinks.

  • format - (Required) The filesystem format (ext4, btrfs, xfs, vfat, or swap).

  • wipe_filesystem - (Optional) Whether or not to wipe the device before filesystem creation.

  • label - (Optional) The label of the filesystem.

  • uuid - (Optional) The uuid of the filesystem.

  • options - (Optional) Any additional options to be passed to the format-specific mkfs utility.

Attributes Reference

The following attributes are exported:

  • rendered - The rendered template to reference this resource in ignition_config.