Zfs Operations

Manage ZFS filesystems.

Facts used in these operations: zfs.Datasets.

zfs.dataset

Create, destroy or set properties on a ZFS dataset (e.g. filesystem, volume, snapshot).

zfs.dataset(
     dataset_name,
     present=True,
     recursive=False,
     sparse=None,
     volume_size=None,
     properties={},
     **extra_props,
     **kwargs,
)

• dataset_name: name of the filesystem to operate on

• present: whether the named filesystem should exist

• recursive: whether to create parent datasets, or destroy child datasets

• sparse: for volumes, whether to create a sparse volume with no allocation

• volume_size: the size of the volume

• properties: the ZFS properties that should be set on the dataset.

• **extra_props: additional props; merged with properties for convenience

Examples:

from pyinfra.operations import zfs
zfs.dataset(
    "tank/srv",
    mountpoint="/srv",
    compression="lz4",
    properties={"com.sun:auto_snapshot": "true"}
)
zfs.dataset("tank/vm-disks/db_srv_04", volume_size="32G") # creates a volume
zfs.dataset("tank/home@old_version", present=False)

Note

This operation also inherits all global arguments.

zfs.filesystem

Create or destroy a ZFS filesystem, or modify its properties.

zfs.filesystem(fs_name, present=True, recursive=False, properties={}, **extra_props,
     **kwargs,
)

• fs_name: name of the volume to operate on

• present: whether the named volume should exist

• recursive: whether to create parent datasets or destroy child datasets

• properties: the ZFS properties that should be set on the snapshot.

• **extra_props: additional props; merged with properties for convenience

Examples:

zfs.filesystem("tank/vm-disks/db_srv_04", "32G")

Note

This operation also inherits all global arguments.

zfs.snapshot

Create or destroy a ZFS snapshot, or modify its properties.

zfs.snapshot(snapshot_name, present=True, recursive=False, properties={}, **extra_props,
     **kwargs,
)

• dataset_name: name of the filesystem to operate on

• present: whether the named filesystem should exist

• recursive: whether to snapshot child datasets

• properties: the ZFS properties that should be set on the snapshot.

• **extra_props: additional props; merged with properties for convenience

Examples:

zfs.snapshot("tank/home@weekly_backup")

Note

This operation also inherits all global arguments.

zfs.volume

Create or destroy a ZFS volume, or modify its properties.

zfs.volume(
     volume_name,
     size,
     sparse=False,
     present=True,
     recursive=False,
     properties={},
     **extra_props,
     **kwargs,
)

• volume_name: name of the volume to operate on

• size: the size of the volume

• sparse: create a sparse volume

• present: whether the named volume should exist

• recursive: whether to create parent datasets or destroy child datasets

• properties: the ZFS properties that should be set on the snapshot.

• **extra_props: additional props; merged with properties for convenience

Examples:

zfs.volume("tank/vm-disks/db_srv_04", "32G")

Note

This operation also inherits all global arguments.