bootstrap-vz/bootstrapvz/plugins/minimize_size
2015-04-28 01:21:07 -03:00
..
__init__.py Convert every JSON file to YAML 2014-07-09 23:17:04 +02:00
manifest-schema.yml Convert every JSON file to YAML 2014-07-09 23:17:04 +02:00
README.rst Docs: fix wrongfully escaped terms 2015-04-28 01:21:07 -03:00
tasks.py Recover file permissions after shrink a vmdk image 2015-01-27 21:12:39 -02:00

minimize size
-------------

This plugin can be used to reduce the size of the resulting image. Often
virtual volumes are much smaller than their reported size until any data
is written to them. During the bootstrapping process temporary data like
the aptitude cache is written to the volume only to be removed again.

The minimize size plugin employs three different strategies to keep a
low volume footprint:

-  Mount folders from the host into key locations of the image volume to
   avoid any unneccesary disk writes.
-  Use `zerofree <http://intgat.tigress.co.uk/rmy/uml/index.html>`__ to
   deallocate unused sectors on the volume. On an unpartitioned volume
   this will be done for the entire volume, while it will only happen on
   the root partition for partitioned volumes.
-  Use
   `vmware-vdiskmanager <https://www.vmware.com/support/ws45/doc/disks_vdiskmanager_eg_ws.html>`__
   to shrink the real volume size (only applicable when using vmdk
   backing). The tool is part of the `VMWare
   Workstation <https://my.vmware.com/web/vmware/info/slug/desktop_end_user_computing/vmware_workstation/10_0>`__
   package.

Settings
~~~~~~~~

-  ``zerofree``: Specifies if it should mark unallocated blocks as
   zeroes, so the volume could be better shrunk after this.
   Valid values: true, false
   Default: false
   ``optional``
-  ``shrink``: Whether the volume should be shrunk. This setting works
   best in conjunction with the zerofree tool.
   Valid values: true, false
   Default: false
   ``optional``