community.general.lvg module – Configure LVM volume groups

Note

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

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.

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

Synopsis

  • This module creates, removes or resizes volume groups.

Parameters

Parameter

Comments

force

boolean

If true, allows to remove volume group with logical volumes.

Choices:

  • false ← (default)

  • true

pesize

string

The size of the physical extent. pesize must be a power of 2 of at least 1 sector (where the sector size is the largest sector size of the PVs currently used in the VG), or at least 128KiB.

Since Ansible 2.6, pesize can be optionally suffixed by a UNIT (k/K/m/M/g/G), default unit is megabyte.

Default: "4"

pv_options

string

Additional options to pass to pvcreate when creating the volume group.

Default: ""

pvresize

boolean

added in community.general 0.2.0

If true, resize the physical volume to the maximum available size.

Choices:

  • false ← (default)

  • true

pvs

list / elements=string

List of comma-separated devices to use as physical devices in this volume group.

Required when creating or resizing volume group.

The module will take care of running pvcreate if needed.

state

string

Control if the volume group exists.

Choices:

  • "absent"

  • "present" ← (default)

vg

string / required

The name of the volume group.

vg_options

string

Additional options to pass to vgcreate when creating the volume group.

Default: ""

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

  • This module does not modify PE size for already present volume group.

See Also

See also

community.general.filesystem

The official documentation on the community.general.filesystem module.

community.general.lvol

The official documentation on the community.general.lvol module.

community.general.parted

The official documentation on the community.general.parted module.

Examples

- name: Create a volume group on top of /dev/sda1 with physical extent size = 32MB
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sda1
    pesize: 32

- name: Create a volume group on top of /dev/sdb with physical extent size = 128KiB
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sdb
    pesize: 128K

# If, for example, we already have VG vg.services on top of /dev/sdb1,
# this VG will be extended by /dev/sdc5.  Or if vg.services was created on
# top of /dev/sda5, we first extend it with /dev/sdb1 and /dev/sdc5,
# and then reduce by /dev/sda5.
- name: Create or resize a volume group on top of /dev/sdb1 and /dev/sdc5.
  community.general.lvg:
    vg: vg.services
    pvs: /dev/sdb1,/dev/sdc5

- name: Remove a volume group with name vg.services
  community.general.lvg:
    vg: vg.services
    state: absent

- name: Create a volume group on top of /dev/sda3 and resize the volume group /dev/sda3 to the maximum possible
  community.general.lvg:
    vg: resizableVG
    pvs: /dev/sda3
    pvresize: true

Authors

  • Alexander Bulimov (@abulimov)