woodpecker/doc/build/notify.md
2015-07-07 18:08:43 -07:00

996 B

Notify

Drone uses the notify section of the .drone.yml to configure notification steps. Drone does not have any built-in notification capabilities. This functionality is outsourced to plugins. See the plugin marketplace for a list of official plugins.

An example configuration that sends a Slack notification on build completion:

notify:
  slack:
    webhook_url: https://hooks.slack.com/services/f10e2821bbb/200352313bc
    channel: dev
    username: drone

Notification conditions

Use the when attribute to limit execution to a specific branch:

publish:
  slack:
    when:
      branch: master

NOTE the ability to limit notifications by status (ie success, failure, etc) is not yet implemented

Or limit execution based on the build status. The below example will only send the notification when the build fails:

publish:
  slack:
    when:
      success: false
      failure: true