Files
opentf/website/source/docs/providers/ignition/d/filesystem.html.md
Máximo Cuadros b58709aa91 provider/ignition: migration from resources to data resources (#11851)
* provider/ignition: migration from resources to data resources

* website: provider/ignition documention updated to data resources

* provider/ignition: backwards compatibility support for old resources
2017-03-06 14:23:04 +02:00

52 lines
1.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
layout: "ignition"
page_title: "Ignition: ignition_filesystem"
sidebar_current: "docs-ignition-datasource-filesystem"
description: |-
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"
force = 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).
* `force` - (Optional) Whether or not the create operation shall overwrite an existing filesystem.
* `options` - (Optional) Any additional options to be passed to the format-specific mkfs utility.
## Attributes Reference
The following attributes are exported:
* `id` - ID used to reference this resource in _ignition_config_.