salt.modules.zcbuildout¶
Management of zc.buildout
New in version 2014.1.0.
This module is inspired by minitage's buildout maker
Note
The zc.buildout integration is still in beta; the API is subject to change
General notes¶
You have those following methods:
upgrade_bootstrap
bootstrap
run_buildout
buildout
- salt.modules.zcbuildout.bootstrap(*a, **kw)¶
Run the buildout bootstrap dance (python bootstrap.py).
- directory
directory to execute in
- config
alternative buildout configuration file to use
- runas
User used to run buildout as
- env
environment variables to set when running
- buildout_ver
force a specific buildout version (1 | 2)
- test_release
buildout accept test release
- offline
are we executing buildout in offline mode
- distribute
Forcing use of distribute
- new_st
Forcing use of setuptools >= 0.7
- python
path to a python executable to use in place of default (salt one)
- onlyif
Only execute cmd if statement on the host return 0
- unless
Do not execute cmd if statement on the host return 0
- use_vt
Use the new salt VT to stream output [experimental]
CLI Example:
salt '*' buildout.bootstrap /srv/mybuildout
- salt.modules.zcbuildout.buildout(*a, **kw)¶
Run buildout in a directory.
- directory
directory to execute in
- config
buildout config to use
- parts
specific buildout parts to run
- runas
user used to run buildout as
- env
environment variables to set when running
- buildout_ver
force a specific buildout version (1 | 2)
- test_release
buildout accept test release
- new_st
Forcing use of setuptools >= 0.7
- distribute
use distribute over setuptools if possible
- offline
does buildout run offline
- python
python to use
- debug
run buildout with -D debug flag
- onlyif
Only execute cmd if statement on the host return 0
- unless
Do not execute cmd if statement on the host return 0
- newest
run buildout in newest mode
- verbose
run buildout in verbose mode (-vvvvv)
- use_vt
Use the new salt VT to stream output [experimental]
CLI Example:
salt '*' buildout.buildout /srv/mybuildout
- salt.modules.zcbuildout.run_buildout(*a, **kw)¶
Run a buildout in a directory.
- directory
directory to execute in
- config
alternative buildout configuration file to use
- offline
are we executing buildout in offline mode
- runas
user used to run buildout as
- env
environment variables to set when running
- onlyif
Only execute cmd if statement on the host return 0
- unless
Do not execute cmd if statement on the host return 0
- newest
run buildout in newest mode
- force
run buildout unconditionally
- verbose
run buildout in verbose mode (-vvvvv)
- use_vt
Use the new salt VT to stream output [experimental]
CLI Example:
salt '*' buildout.run_buildout /srv/mybuildout
- salt.modules.zcbuildout.upgrade_bootstrap(*a, **kw)¶
Upgrade current bootstrap.py with the last released one.
Indeed, when we first run a buildout, a common source of problem is to have a locally stale bootstrap, we just try to grab a new copy
- directory
directory to execute in
- offline
are we executing buildout in offline mode
- buildout_ver
forcing to use a specific buildout version (1 | 2)
- onlyif
Only execute cmd if statement on the host return 0
- unless
Do not execute cmd if statement on the host return 0
CLI Example:
salt '*' buildout.upgrade_bootstrap /srv/mybuildout
