Usage

Add a part in buildout.cfg like so:

[buildout]
parts = deploy

[deploy]
recipe = praekelt.recipe.deploy
git_url = git@github.com:me/projectx.git
host = www.protectx.com
root_path = /var/www/projectx

Running the buildout will add a deploy script with the same name as your deploy part in the bin/ directory. In this case bin/deploy. The resulting script will deploy git@github.com:me/projectx.git to www.projectx.com's /var/www/projectx path.

Options

as_user

User as which to perform the deploy. Used to setup permissions appropriately and to clone from github. Defaults to 'www-data'.

conf_file

Buildout cfg file with which to run boostrap and buildout. Defaults to 'buildout.cfg'.

cron_commands

Commands to add to the as_users user's crontab.

deploy_key_path

Path on host to key to use when cloning the repo.

deploy_latest_tag

If True deploy will be performed from latest found tag for active branch. Otherwise deploy will be performed from last commit of the active branch. Defaults to 'False'.

git_branch

Git repo branch with which to perform the deploy.

git_url

Git repo with which to perform the deploy. Required.

host

Hostname on which to perform deploy. Required.

initd_commands

init.d commands to run after a completed deploy. i.e. nginx restart.

puppet_manifest

Puppet manifest file to apply prior to buildout. This will be applied using puppet apply <manifest>.

python_exec

Python command with which to boostrap Buildout. Defaults to 'python'.

root_path

Root path in which to perform the deploy. current/release path structure will be created within this path. Required.

shared_resources

Resource paths to copy accross from the current release to the new release on each deploy.

supervisorctl_commands

supervisorctl commands to run after a completed deploy. i.e. restart all.

update_supervisor

Whether or not to update supervisor. Defaults to 'False'.

Full Example

The following example illustrates all available options:

[buildout]
parts = deploy

[deploy]
recipe = praekelt.recipe.deploy
as_user = www-data
conf_file = production.cfg
deploy_key_path = /var/www/.ssh/projectx_deploy_key
deploy_latest_tag=True
git_branch = production
git_url = git@github.com:me/projectx.git
host = www.protectx.com
initd_commands = nginx restart
puppet_manifest = provision.pp
python_exec = python2.5
root_path = /var/www/projectx
shared_resources =
    eggs
    downloads
    log
    media
update_supervisor = True
supervisorctl_commands = restart all
cron_commands = * * * * * echo foobar

The resulting script will deploy the latest tag found for git@github.com:me/projectx.git's production branch to www.projectx.com's /var/www/projectx path as user www-data. The git repo will be cloned using /var/www/.ssh/projectx_deploy_key as ssh key. The Puppet manifest provision.pp will be applied. The eggs, downloads, log and media paths will be copied from the current release to this new release. The buildout environment will be created using python2.5 and run using production.cfg as configuration file. After the buildout completes supervisor will be updated and supervisorctl restart all will be run as well as /etc/init.d/nginx restart. * * * * * echo foobar will be added to www-data user's crontab.

Praekelt Foundation

• Shaun Sephton

0.1.3 (2011-06-29)

1. More forcefull supervisor update.

0.1.2 (2011-06-28)

1. Allow supervisorctl commands.

0.1.1 (2011-06-20)

1. Added command line git creds supply.

0.1.0

1. deploy_latest_tag option added.
2. Fail on init.d issues.

0.0.9

1. Resolved apply.pp bug.

0.0.8

1. Added Puppet manifest provisioning support via puppet_manifest option.
2. Pretty printing.

0.0.7

1. Added command env password option.
2. Added force commandline option bypassing confirmation prompts.

0.0.6

1. Added support for https git urls.

0.0.5

1. Added newest and verbose options.

0.0.3

1. Added cron_commands parameter. Allow for certain script argument overrides.

0.0.2

1. Fixed branch issue.

0.0.1

1. Initial Release