Deploy Commands

Specifies the directory and filename DEPLOY_CONF of the deploy configuration file. The default value is /etc/deploy/deploy.conf. See the deploy.conf(5) man page for Deploy configuration options.

Specifies the root directory PATH where Deploy should create definition data folders. The default path is the definition directory. See the Deploy Definition File Reference at http://www.deployproject.org/docs for more information on data files and folders.

Disables a MODULE. This option can be specified more than once, as in the example below:

--disable MODULE1 --disable MODULE2 --disable MODULE3

See the MODULES and EVENTS sections below for more information.

Enables a MODULE. This option can be specified more than once, as in the example below:

--enable MODULE1 --enable MODULE2 --enable MODULE3

See the MODULES and EVENTS sections below for more information.

Forces the events of a MODULE to execute, even if the events would ordinarily be skipped for optimizations in speed. This option can be specified more than once, as in the example below:

--force MODULE1 --force MODULE2 --force MODULE3

See the MODULES and EVENTS sections below for more information.

Forces an EVENT to execute, even if it would ordinarily be skipped for optimizations in speed. Forcing an event forces its children recursively. This option can be specified more than once, as in the example below:

--force-event EVENT1 --force-event EVENT2 --force-event EVENT3

See the EVENTS section below for more information.

By default, Deploy searches directories listed on the system path to locate Deploy modules. The --lib-path option allows specifing additional directory PATHs to search. This option can be specified more than once; for example:

--lib-path PATH1 --lib-path PATH2 --lib-path PATH3

See the MODULES section below for more information.

Provides a hierarchical list of events that will execute for the specified definition.

deploy --list-events DEFINITION

See the EVENTS section below for more information.

Specifies the directory and filename PATH to which Deploy writes logging information. The default path is /var/log/deploy.log. See also the command option --log-level.

--log-file PATH

Specifies the level of detail displayed on the console during a build. There are six levels N (0 to 5) with Level 3 being Deploy's default level.

LEVELS

* Level 0: Displays errors only.
* Level 1: Displays build status.
* Level 2: Displays module status. See MODULES.
* Level 3: Displays file download and creation status (default).
* Level 4: Displays script output; file copy and delete status. 
* Level 5: Displays complete debug-level status.

Setting the log level to 0 will prevent all logging except errors to the screen, while levels 1 to 5 have increasingly more detail about the build process.

This setting controls the level of detail displayed on the console only, and not the log file. Level 5 detail is always written to the log file.

Specifies a macro ID and VALUE to use for placeholder substitution in the DEFINITION. ID and VALUE are text values separated by a colon. Specifically, VALUE may not contain XML. Placeholders in the DEFINITION take the form '%{ID}'. This option may be specified more than once, for example:

--macro ID1:VALUE1 --macro ID2:VALUE2 --macro ID3:VALUE3

Disables validation of DEPLOY_CONF and DEFINITION during the build process.

Instructs Deploy to retrieve files from the cache rather than from remote locations.

Specifies a directory PATH where Deploy can locate shared program data such as example files and XML schema files. The default path is /usr/share/deploy/. This option can be specified more than once, as demonstrated below:

--share-path PATH1 --share-path PATH2 --share-path PATH3

Prevents the events of a MODULE from executing, even if the events would ordinarily be executed due to changes in input, output or other factors. This option can be specified more than once, as in the example below:

--skip MODULE1 --skip MODULE2 --skip MODULE3

See the MODULES and EVENTS sections below for more information.

Prevents an EVENT from executing, even if it would ordinarily be executed due to changes in input, output or other factors. Skipping an event skips its childen recursively. This option can be specified more than once, as in the example below:

--skip-event EVENT1 --skip-event EVENT2 --skip-event EVENT3

See the EVENTS section below for more information.

Performs DEPLOY_CONF and DEFINITION validation only; it does not build the definition. The option also displays the complete DEFINITION file after resolving macro and include elements.

The directory and filename of the Deploy configuration file.

The id of a Deploy module. See the MODULES section, below, for more information.

The id of a Deploy event. See the EVENTS section, below, for more information.

A local file path. Deploy resolves paths relative to the current working directory.