diskimage-builder/diskimage_builder/elements/cloud-init-growpart/README.rst

===================
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.
Added cloud-init growpart element Added growpart element. It allows for growing specific partitions during the deployment, which will result in less post deploy actions needed for the server to be ready for use. Change-Id: I6519fba3e8f1d078b99d3c03f2ac85f7b6e37d8a 2022-09-05 08:18:41 +00: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.
Added example configuration Change-Id: Icebe0e2f43f4a96d3c1fa464c6f2dc3da3be65c5 2022-10-17 08:39:31 +00:00			`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`

Added cloud-init growpart element Added growpart element. It allows for growing specific partitions during the deployment, which will result in less post deploy actions needed for the server to be ready for use. Change-Id: I6519fba3e8f1d078b99d3c03f2ac85f7b6e37d8a 2022-09-05 08:18:41 +00:00
			`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.`