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' ]
setBuildVersion - Sets the current builds version string
Parameters : value
Example :
@@continua[setBuildVersion value='1.2.3' ]
setBuildStatus - Sets the current action's build status, which is shown on the build details page when a build is running
Parameters : name
Example :
@@continua[setBuildStatus value='Copying Files...' ]