bootstrap-vz/bootstrapvz/providers/virtualbox
Anders Ingemann f62c8ade99 Convert indentation from tabs to spaces (4)
Up until now I didn't see the point of using spaces for indentation.
However, the previous commit (a18bec3) was quite eye opening.
Given that python is an indentation aware language, the amount of
mistakes that went unnoticed because tabs and spaces were used
at the same time (tabs for indentation and spaces for alignment)
were unacceptable.

E101,W191 have been re-enable in the tox flake8 checker and
the documentation has been modified accordingly.

The following files have been left as-is:
* bootstrapvz/common/assets/extlinux/extlinux.conf
* bootstrapvz/common/assets/init.d/expand-root
* bootstrapvz/common/assets/init.d/generate-ssh-hostkeys
* bootstrapvz/common/assets/init.d/squeeze/generate-ssh-hostkeys
* bootstrapvz/plugins/docker_daemon/assets/init.d/docker
* bootstrapvz/providers/ec2/assets/bin/growpart
* bootstrapvz/providers/ec2/assets/grub.d/40_custom
* bootstrapvz/providers/ec2/assets/init.d/ec2-get-credentials
* bootstrapvz/providers/ec2/assets/init.d/ec2-run-user-data
* docs/_static/taskoverview.coffee
* docs/_static/taskoverview.less
* tests/unit/subprocess.sh
2016-06-04 11:38:16 +02:00
..
assets Fix installation of vbox guest additions. 2015-04-25 16:12:26 -03:00
tasks Convert indentation from tabs to spaces (4) 2016-06-04 11:38:16 +02:00
__init__.py Convert indentation from tabs to spaces (4) 2016-06-04 11:38:16 +02:00
manifest-schema.yml Fix guest additions path check in vbox schema 2015-12-09 17:23:35 +01:00
README.rst fix document toctree 2016-03-15 11:13:05 +09:00

VirtualBox
==========

The `VirtualBox <https://www.virtualbox.org/>`__ provider can bootstrap
to both .vdi and .vmdk images (raw images are also supported but do not
run in VirtualBox). It's advisable to always use vmdk images for
interoperability (e.g.
`OVF <http://en.wikipedia.org/wiki/Open_Virtualization_Format>`__ files
*should* support vdi files, but since they have no identifier URL not
even VirtualBox itself can import them).

VirtualBox Guest Additions can be installed automatically if the ISO is
provided in the manifest.
VirtualBox Additions iso can be installed from main Debian repo by running:
`apt install virtualbox-guest-additions-iso`


Manifest settings
-----------------

Provider
~~~~~~~~

-  ``guest_additions``: Specifies the path to the VirtualBox Guest Additions ISO,
   which, when specified, will be mounted and used to install the
   VirtualBox Guest Additions.
   ``optional``

Example:

.. code-block:: yaml

    ---
    provider:
      name: virtualbox
      guest_additions: /usr/share/virtualbox/VBoxGuestAdditions.iso