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

© 2021 SaltStack.
Licensed under the Apache License, Version 2.0.
https://docs.saltproject.io/en/latest/ref/modules/all/salt.modules.zcbuildout.html