diskimage-builder

History

Steve Baker 9fa139511e Check and grow the GPT structure to the end of the volume In the baremetal case this isn't required because it is done by ironic-python-agent when writing the image to the volume[1]. But when using the image directly (such as in a nova VM) the GPT structure needs to be extended first. This change does that, along with the detection for whether extending is required, using the same approach as [1]. [1] https://github.com/openstack/ironic-lib/blob/master/ironic_lib/disk_utils.py#L670-L674 Co-Authored-By: rminishev@itkey.com Co-Authored-By: sbaker@redhat.com Change-Id: I3240eb0ef4dbbb41557985f0129ae4998a846417		2023-03-23 22:14:44 +00:00
..
environment.d	Add a growvols utility for growing LVM volumes	2021-07-01 11:16:31 +12:00
init-scripts/systemd	Make growvols config path platform independent	2022-02-04 00:23:13 +03:00
post-install.d	Make growvols config path platform independent	2022-02-04 00:23:13 +03:00
static/usr/local/sbin	Check and grow the GPT structure to the end of the volume	2023-03-23 22:14:44 +00:00
tests	Check and grow the GPT structure to the end of the volume	2023-03-23 22:14:44 +00:00
__init__.py	Add a growvols utility for growing LVM volumes	2021-07-01 11:16:31 +12:00
element-deps	Add a growvols utility for growing LVM volumes	2021-07-01 11:16:31 +12:00
package-installs.yaml	Add a growvols utility for growing LVM volumes	2021-07-01 11:16:31 +12:00
README.rst	Add a growvols utility for growing LVM volumes	2021-07-01 11:16:31 +12:00

README.rst

========
growvols
========

Grow one or more LVM volumes on first boot.

This installs utility `growvols` which grows the logical volumes in an LVM group
to take available device space.

The positional arguments specify how available space is allocated. They
have the format <volume>=<amount><unit> where:

<volume> is the label or the mountpoint of the logical volume
<amount> is an integer growth amount in the specified unit
<unit> is one of the supported units

Supported units are:

% percentage of available device space before any changes are made
MiB mebibyte (1048576 bytes)
GiB gibibyte (1073741824 bytes)
MB megabyte (1000000 bytes)
GB gigabyte (1000000000 bytes)

Each argument is processed in order and the requested amount is allocated
to each volume until the disk is full. This means that if space is
overallocated, the last volumes may only grow by the remaining space, or
not grow at all, and a warning will be printed. When space is underallocated
the remaining space will be given to the root volume (mounted at /).

The currently supported partition layout is:
- Exactly one of the partitions containing an LVM group
- The disk having unpartitioned space to grow with
- The LVM logical volumes being formatted with XFS filesystems

Example usage:

growvols /var=80% /home=20GB

growvols --device sda --group vg img-rootfs=20% fs_home=20GiB fs_var=60%

Environment variables can be set during image build to enable a systemd unit
which will run growvols on boot:

# DIB_GROWVOLS_TRIGGER defaults to 'manual'. When set to 'systemd' a systemd
# unit will run using the following arguments
export DIB_GROWVOLS_TRIGGER=systemd

# DIB_GROWVOLS_ARGS contains the positional arguments for which volumes to grow
# by what amount. If omitted the volume mounted at / will grow by all available
# space
export DIB_GROWVOLS_ARGS="img-rootfs=20% fs_home=20GiB fs_var=60%"

# DIB_GROWVOLS_GROUP contains the name of the LVM group to extend. Defaults the
# discovered group if only one exists.
export DIB_GROWVOLS_GROUP=vg

# DIB_GROWVOLS_DEVICE is the name of the disk block device to grow the
# volumes in (such as "sda"). Defaults to the disk containing the root mount.
export DIB_GROWVOLS_DEVICE=sda