woodpecker-email/DOCS.md

Use the Email plugin for sending build status notifications via email.

Config

You can configure the plugin using the following parameters:

• from - Send notifications from this address
• host - SMTP server host
• port - SMTP server port, defaults to 587
• username - SMTP username
• password - SMTP password
• skip_verify - Skip verification of SSL certificates, defaults to false
• recipients - List of recipients to send this mail to (besides the commit author)
• recipients_only - Do not send mails to the commit author, but only to recipients, defaults to false
• subject - The subject line template
• body - The email body template
• attachment - An optional file to attach to the sent mail(s), can be an absolute path or relative to the working directory.

Secrets

You can use the following secrets to secure the sensitive configuration of this plugin:

• email_host - corresponds to host
• email_port - corresponds to port
• email_username - corresponds to username
• email_password - corresponds to password
• email_recipients- corresponds to recipients

Example

The following is a sample configuration in your .drone.yml file:

pipeline:
  notify:
    image: drillster/drone-email
    from: noreply@github.com
    host: smtp.mailgun.org
    username: octocat
    password: 12345
    recipients:
      - octocat@github.com

For drone version >=1.0 dont forget to use settings key:

kind: pipeline
type: docker
name: default

steps:
- name: notify
  image: drillster/drone-email
  settings:
    from: noreply@github.com
    host: smtp.mailgun.org
    username: octocat
    password: 12345
    recipients:
      - octocat@github.com

Secrets

The Email plugin supports reading credentials and other parameters from the Drone secret store. This is strongly recommended instead of storing credentials in the pipeline configuration in plain text.

pipeline:
  notify:
    image: drillster/drone-email
    from: noreply@github.com
    host: smtp.mailgun.org
-   username: octocat
-   password: 12345
    recipients:
      - octocat@github.com
+   secrets: [ email_username, email_password ]

Use the command line utility to add the secrets to the store:

drone secret add \
  --repository octocat/hello-world \
  --name email_username \
  --value octocat \
  --image drillster/drone-email
drone secret add \
  --repository octocat/hello-world \
  --name email_password \
  --value 12345 \
  --image drillster/drone-email

See Secret Guide for additional information on secrets.

Custom Templates

In some cases you may want to customize the look and feel of the email message so you can use custom templates. For the use case we expose the following additional parameters, all of the accept a custom handlebars template, directly provided as a string or as a remote URL which gets fetched and parsed:

• subject - A handlebars template to create a custom subject. For more details take a look at the docs. You can see the default template here
• body - A handlebars template to create a custom template. For more details take a look at the docs. You can see the default template here

Example configuration that generate a custom email:

pipeline:
  notify:
    image: drillster/drone-email
    from: noreply@github.com
    host: smtp.mailgun.org
    username: octocat
    password: 12345
    subject: >
      [{{ build.status }}]
      {{ repo.owner }}/{{ repo.name }}
      ({{ build.branch }} - {{ truncate build.commit 8 }})      
    body: >
      https://git.io/vgvPz      

Skip SSL verify

In some cases you may want to skip SSL verification, even if we discourage that as it leads to an unsecure environment. Please use this option only within your intranet and/or with truested resources. For this use case we expose the following additional parameter:

• skip_verify - Skip verification of SSL certificates

Example configuration that skips SSL verification:

pipeline:
  notify:
    image: drillster/drone-email
    from: noreply@github.com
    host: smtp.mailgun.org
    username: octocat
    password: 12345
    skip_verify: true

Secrets in Drone 0.5

Secret injection has changed for Drone 0.6 and up. To use this plugin with Drone 0.5, use:

drone secret add octocat/hello-world EMAIL_PASSWORD 12345

to add the secret. Then add the secret to your .drone.yml:

pipeline:
  notify:
    image: drillster/drone-email
    from: noreply@github.com
    host: smtp.mailgun.org
    username: octocat
    password: ${EMAIL_PASSWORD}

and then sign your configuration using:

drone sign octocat/hello-world