diskimage-builder/diskimage_builder/elements/cloud-init-growpart
Rafal Lewandowski 4ff8721a66 Added example configuration
Change-Id: Icebe0e2f43f4a96d3c1fa464c6f2dc3da3be65c5
2022-10-20 10:00:18 +02:00
..
post-install.d Added cloud-init growpart element 2022-10-11 16:58:26 +02:00
releasenotes/notes Added cloud-init growpart element 2022-10-11 16:58:26 +02:00
element-deps Added cloud-init growpart element 2022-10-11 16:58:26 +02:00
package-installs.yaml Added cloud-init growpart element 2022-10-11 16:58:26 +02:00
pkg-map Added cloud-init growpart element 2022-10-11 16:58:26 +02:00
README.rst Added example configuration 2022-10-20 10:00:18 +02:00

===================
cloud-init-growpart
===================

This element enables growpart for OS images. It allows to grow
Specific partitions during the deployment process.
To enable this element simply include it in the elements list.

**Disclaimer:** This element might not work with some device names supplied, for example when server is deployed and the image is written to a fibre channel device, or a SAS/SATA SSD controller.

* ``DIB_CLOUD_INIT_GROWPART_DEVICES``: List of partition names that needs to be populated in order to be grown by cloud-init. **Populating this variable is mandatory.**
  Cloud-init growpart module documentation - https://cloudinit.readthedocs.io/en/latest/topics/modules.html?highlight=growpart#growpart::

    DIB_CLOUD_INIT_GROWPART_DEVICES:
        - /dev/sda1
        - /dev/vda3


Dependencies:

* ``/usr/bin/growpart``: **is needed on the system in order to grow the partition**,
  however it is part of different packages depending on linux family. That is already taken care of by package-installs.