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)