Environment configuration
=========================

Component assignment (TODO)
---------------------------

General parameters (TODO)
-------------------------

General environment parameters are set in the ``[environment]`` config section.
Example::

    [environment]
    service_user = website
    host_domain = gocept.net
    platform = gocept
    branch = production

service_user
    The deployment is run as this user on remote machines. If this is not
    the same as the user connecting via ssh, a `sudo` to the service user
    is performed.

host_domain
    All hosts in the ``[hosts]`` section are postfixed with this domain. This
    is handy do make the host/component assignment less verbose

update_method
    `hg-bundle|hg-pull|git-bundle|git-pull|rsync`, sets how the remote deployment repository is updated.

    * `pull`, the default, uses `hg/git clone` and/or `hg/git pull` on the remote site.
    * `bundle` will copy the necessary changes as Mercurial/Git bundle, via the batou ssh link.
    * `rsync` will rsync the *working copy*. This is most useful in combination with the vagrant platform.


branch
    For remote deployments, use this and only this branch. batou will
    complain if the local branch does not match the set branch in the
    environment.

platform
    Set the platform for this environment.

timeout
    Set the ssh connection timeout in seconds.

target_directory
        Absolute path of the directory on remote machines where the remote
        deployment repository is stored. Supports tilde expansion. Default:
        ``~/deployment``.


vfs mapping (TODO)
------------------

Root-component attribute overrides (TODO)
------------------------------------------