terraform/website/source/docs/providers/ignition/d/filesystem.html.md

1.9 KiB
Raw Blame History

layout page_title sidebar_current description
ignition Ignition: ignition_filesystem docs-ignition-datasource-filesystem Describes the desired state of a systems filesystem.

ignition_filesystem

Describes the desired state of a the systems 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, or xfs).

  • create - (Optional) Indicates if the filesystem shall be created.

  • force - (Optional) Whether or not the create operation shall overwrite an existing filesystem. Only allowed if the filesystem is being created.

  • options - (Optional) Any additional options to be passed to the format-specific mkfs utility. Only allowed if the filesystem is being created

Attributes Reference

The following attributes are exported:

  • id - ID used to reference this resource in ignition_config.