Custom Log Messages

Custom Log Messages provide a way for processes executed by Continua CI to interact with the Continua CI build. This includes the ability to set the build number, set variables and send real time status information. This feature will be extended over time.

Message Format

@@continua[messageType parameter='value' parameter='value' ]

Note that the messageType field is not case sensitive. The parameter order is not defined, and parameter values must be quoted (with single quotes). NewLines, blackslashes, [ ] and single quotes must be escaped, e.g

@@continua[messageType name='test' value='This is a \nnew line and I am \'quoted\' by a\\b' ] 

Message Types

message - Sends a message to to the build log. 

Parameters : value, status (debug, information, success, warning, error, fatal)

Example : 

@@continua[message value='This will be logged' status='information' ]

startGroup - Starts a message group (tree node) in the build log

Parameters : name

Example : 

@@continua[startGroup name='Copying Files...' ]

endGroup - Ends a message group (tree node) in the build log

Parameters : name

Example : 

@@continua[endGroup name='Copying Files...']

setVariable- Sets a Continua CI Configuration Variable. Note that the variable name must be a Continua CI Configuration Variable. Optionally set the skipIfNotDefined attribute to 'true' to prevent the build failing if the variable has not been defined for the configuration.

Parameters : name, value, skipIfNotDefined

Example : 

@@continua[setVariable name='allowupload' value='true' ]

@@continua[setVariable name='possiblyUnDefinedVariable' value='Hello world!' skipIfNotDefined='true' ]

@@continua[setBuildVersion value='1.2.3' ]

@@continua[setBuildStatus value='Copying Files...' ]