SMTP

The SMTP driver supports reporters only. It is used to send email when items report.

Connection Configuration

<smtp connection>

<smtp connection>.driver (required)

smtp: The connection must set driver=smtp for SMTP connections.

<smtp connection>.server Default: localhost: SMTP server hostname or address to use.

<smtp connection>.port Default: 25: SMTP server port.

<smtp connection>.default_from Default: zuul: Who the email should appear to be sent from when emailing the report. This can be overridden by individual pipelines.

<smtp connection>.default_to Default: zuul: Who the report should be emailed to by default. This can be overridden by individual pipelines.

<smtp connection>.user: Optional user name used to authenticate to the SMTP server. Used only in conjunction with a password. If no password is present, this option is ignored.

<smtp connection>.password: Optional password used to authenticate to the SMTP server.

<smtp connection>.use_starttls Default: false: Issue a STARTTLS request to establish an encrypted channel after having connected to the SMTP server.

Reporter Configuration

A simple email reporter is also available.

A connection that uses the smtp driver must be supplied to the reporter. The connection also may specify a default To or From address.

Each pipeline can overwrite the subject or the to or from address by providing alternatives as arguments to the reporter. For example:

- pipeline:
    name: post-merge
    success:
      outgoing_smtp:
        to: you@example.com
    failure:
      internal_smtp:
        to: you@example.com
        from: alternative@example.com
        subject: Change {change} failed

pipeline.<reporter>.<smtp source>

To report via email, the dictionaries passed to any of the pipeline reporter attributes support the following attributes:

pipeline.<reporter>.<smtp source>.to: The SMTP recipient address for the report. Multiple addresses may be specified as one value separated by commas.

pipeline.<reporter>.<smtp source>.from: The SMTP sender address for the report.

pipeline.<reporter>.<smtp source>.subject: The Subject of the report email.

Versions v: latest