At the end of a job or a job group, you can execute triggers based on the outcome of the job.

Table of Contents

  1. email
  2. webhook

The basic format of a trigger is (in JSON):

{
    "action": "trigger type",
    "condition": "when to execute this trigger",
    [...action-specific configuration...]
}

Or in YAML:

triggers:
  - action: trigger type
    condition: when to execute this trigger
    ...action-specific configuration...

Condition may be one of the following:

  • always: execute the trigger after every build
  • failure: execute the trigger after a failed build
  • success: execute the trigger after a successful build

The following actions are available:

email

Sends an email summarizing the build results.

Configuration

  • to: The value of the "To" header in the outgoing email, e.g. your email address or e.g. Jim Jimson <jim@example.org>, Bob Bobson <bob@example.org>. Required.
  • cc: The value of the "Cc" header in the outgoing email. Optional.
  • in_reply_to: The value of the "In-Reply-To" header in the outgoing email. Optional.
webhook

Submits the job status (as it would be returned by GET /api/jobs/:id) as a POST request to a specified URL.

Configuration

  • url: The URL to submit the HTTP request to

About this wiki

commit 1812faa0fe836f14847d2932de7ba0a8bfceddc2
Author: Naglis Jonaitis <naglis@mailbox.org>
Date:   2020-08-08T18:32:13+03:00

Add hyphen in "two-factor authentication"
Clone this wiki
https://git.sr.ht/~sircmpwn/sr.ht-docs (read-only)
git@git.sr.ht:~sircmpwn/sr.ht-docs (read/write)