411 REFERENCE · Wikibooks
Phabricator Administrator's Handbook/Herald
Reference material by Wikibooks contributors. This retains its source identity and is not 411 news reporting.
thumb|All the available Herald Rule types
thumb|Herald rule created to run a Build Plan after every commit.
Herald is a Phabricator component designed to trigger actions if some rules are matched.The Herald component can be found searching Herald in the Phabricator search box or visiting example.com/herald/.
Read the Herald Official Documentation to learn some basic characteristics.
Here some frequently asked behaviors.
Block a commit
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 https://discourse.phabricator-community.org/t/block-short-commit-message-herald-regex/3573 Block short commit message with Herald regex Phabricator Discussion forum
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
Phabricator Administrator's Handbook/Continuous integration
See also
Regular expression
Notes