bootstrap-vz/bootstrapvz/plugins/commands
Anders Ingemann 6bb654b79f Compat with new sphinx
Changed a lot of code:: to code-block::
Also added sphinx_rtd_theme to deps in tox
2016-03-04 01:21:52 +01:00
..
__init__.py Fix #99: Rename image_commands to commands 2015-05-02 12:36:14 +02:00
manifest-schema.yml Fix mentions to the commands plugin name 2015-05-02 13:12:33 -03:00
README.rst Compat with new sphinx 2016-03-04 01:21:52 +01:00
tasks.py Fix #99: Rename image_commands to commands 2015-05-02 12:36:14 +02:00

Commands
--------------

This plugin allows you to run arbitrary commands during the bootstrap process.
The commands are run at an indeterminate point *after* packages have been
installed, but *before* the volume has been unmounted.

Settings
~~~~~~~~

-  ``commands``: A list of lists containing strings. Each top-level item
   is a single command, while the strings inside each list comprise
   parts of a command. This allows for proper shell argument escaping.
   To circumvent escaping, simply put the entire command in a single
   string, the command will additionally be evaluated in a shell
   (e.g. globbing will work).
   In addition to the manifest variables ``{root}`` is also available.
   It points at the root of the image volume.
   ``required``
   ``manifest vars``

Example
~~~~~~~

Create an empty `index.html` in `/var/www` and delete all locales except english.
.. code-block:: yaml

  commands:
    commands:
      - [touch, '{root}/var/www/index.html']
      - ['rm -rf /usr/share/locale/[^en]*']