a91d57c389
I observed some issues while testing, and just wanted to note them in the documentation for the element so users have greater context into it's use. Change-Id: Ia273a8313b2ebdb35bb378e815b276c3c07e711c
replace-partition
A standalone element which consumes a base image which was created
with diskimage-builder and rebuilds it without making any
packaging changes. This allows the image contents to be copied to a new
block device layout. Use cases for this element include:
- Rebuilding a whole-disk image with a different partition layout by
setting
DIB_BLOCK_DEVICE_CONFIG - Rebuilding a whole-disk image with the same partitions but with the sector size increased to 4096 bytes
See element replace-partition-redhat for a full example
of how to use this element
Warning
When using this element or elements based upon it, differences in the needs of ramdisk component artifacts are generally not accounted for. I.E. if you rebuild an image which did not have LVM to a disk layout with LVM, then the image is unlikely to work because the ramdisk lacks the contents necessary to detect and initailize the ramdisk.
Warning
When rebuilding images, specifically with filesystems like XFS, you should utilize diskimage-builder on the same OS and Version as the image you are rebuilding. This is because some filesystem version and metadata characteristics of newer host kernels can prevent the image from being used by the kernel inside of the image. This is most pertinant with the XFS filesystem, but there may be other cases we are unaware of.
Arguments
The following arguments are mandatory and should be set to the correct values as for other distro elements:
DISTRO_NAMEDIB_RELEASEEFI_BOOT_DIRDIB_INIT_SYSTEMDIB_BLOCK_DEVICEDIB_LOCAL_IMAGE
DIB_SOURCE_BLOCK_SIZE can be set to 4096 if the base
image DIB_LOCAL_IMAGE was created with a 4096 byte sector
size.