build-generator

Synopsis

build-generator [GLOBAL-OPTIONS] COMMAND [COMMAND-OPTIONS]

Supported Commands

  • analyze – Analyze project repositories w.r.t. dependencies and meta-data.

  • config – Describe configuration sources and the current configuration.

  • create-jenkins-user – Create a user account in a Jenkins instance.

  • generate – Generate Jenkins jobs for a given distribution.

  • help – Print help either for all commands or for a given command.

  • info-aspects – Print information about available aspects.

  • info-variables – Print information about recognized variables.

  • install-jenkins – Install and configure a Jenkins CI server.

  • platform-requirements – Analyze system packages required on a given platform.

  • report – Generate one or more reports for given distribution(s).

  • validate – Perform basic sanity checks for a given recipe repository.

  • version – Print the version of this program and some components.

Global Options

--trace-variable=VARIABLE-NAME

Type: (LIST STRING INHERIT? T) Default: false

Trace all accesses to the specified variable.

This option can be supplied multiple times.

--cache-age-limit=AGE-IN-SECONDS

Type: (OR NULL NON-NEGATIVE-INTEGER) Default: 1800

Acceptable age of cached information in seconds.

Older cached information will not be used and will be replaced by newly computed information.

--cache-directory=DIRECTORY

Type: DIRECTORY-PATHNAME Default: false

Directory into which cached data like repository mirrors should be written.

--temp-directory=DIRECTORY

Type: DIRECTORY-PATHNAME Default: /tmp/

Directory into which temporary files should be written.

--progress-style=STYLE

Type: (MEMBER NONE CMAKE ONE-LINE) Default: CMAKE

Progress display style.

-j=NUMBER-OF-PROCESSES

Type: POSITIVE-INTEGER Default: 8

Number of threads (and processes) to execute in parallel.

--on-error=POLICY

Type: ERROR-POLICY Default: ((CAUSED-BY-UNFULFILLED-PROJECT-DEPENDENCY-ERROR . CONTINUE) (T . FAIL))

Continue when encountering errors?

Can be simply

"abort" to abort immediately for any error
"fail" to continue but indicate failure for all errors
"continue" to continue without indicating failure for all errors
"debug" to enter the debug for all errors

To choose specific actions for particular errors, rules can be written according to the following grammar:

error-policy ::= rule* default
rule ::= error "=>" action ":"
error ::= "object-error" | "simple-object-error" | "syntax-error" |
          "repository-access-error" | "repository-analysis-error" |
          "project-analysis-error" | "analysis-error" | "dependency-error" |
          "instantiation-error" | "deployment-error" | "report-error"
default ::= action
action ::= "abort" | "fail" | "continue" | "debug"

Example:

dependency-error=>continue:analysis-error=>fail:abort

The above continues the run with exit code zero in case dependency-errors are encountered, continues and returns a non-zero exit code for analysis-errors and immediately aborts with non-zero exit code for all other errors.

--debug

Type: BOOLEAN Default: false

Enable debug mode.

-h

Type: BOOLEAN Default: false

Print this help and exit.

--version

Type: BOOLEAN Default: false

Print version information and exit.