Phabricator Administrator's Handbook/Herald

Herald is a Phabricator component designed to trigger actions if some rules are matched.[1]

All the available Herald Rule types
Herald rule created to run a Build Plan after every commit.

Read the Herald Official Documentation to learn some basic characteristics.

Here some frequently asked behaviors.

Block a commit edit

Herald can be configured to block a commit before reaching your repository. For example it be useful to:

  • avoid to accidentally disclosure sensitive data (SSH private keys, API tokens, etc. you know)
  • avoid to accidentally version binary files (.war, .apk)
  • respect some policies, like blocking short commit messages[2]

Herald types suitable for this kind of rules:

  • Commit Hook: Commit Content: can react on commit message and contents etc.
  • Commit Hook: Branches/Tags/Bookmarks: for other cases, the origin of the request etc.

Run a Build Plan edit

See also: Phabricator Administrator's Handbook/Continuous integration

See also edit

Notes edit

  1. The Herald component can be found searching Herald in the Phabricator search box or visiting example.com/herald/.
  2. "Block short commit message with Herald regex". Phabricator Discussion forum.