Enforce pull-request approval policy with Policy Bot
Codify complex GitHub review rules, evaluate pull requests, and expose approval status as a required check.
Prerequisites
Policy Bot GitHub App, GitHub repository, policy.yml
Installation
Use the upstream install or setup path that matches your environment:
- make it easier for developers to figure out who they should ask for approval.
- yarn install
- yarn run build
- docker run --rm -v "$(pwd)/config:/secrets/" -p 8080:8080 palantirtechnologies/policy-bot:latest
Requirements and caveats from upstream:
- Require reviews from specific users, organizations, or teams
- policy requires that all of its rules are approved to approve the pull request.
Basic usage or getting-started notes:
After evaluation, a rule can be in one of four states:
approved - all of the predicates and requirements are true
pending - all of the predicates are true but one or more requirements are not true
Extracted from upstream docs: https://raw.githubusercontent.com/palantir/policy-bot/HEAD/README.md