Skip to main content

Pipeline rules

Pipeline rules are your organization's checks on the step into production, the same for every project. Jaah checks them each time someone saves a project's pipeline. The section sits in Settings, under Customize › Pipelines; open it from the sidebar.

Who sees it: Org Owners and Org Admins. Other members don't see the section, but every pipeline save they make is still checked.

The Pipeline rules section: three rules, each with its Mode, and the projects breaking it

The table​

Each rule is one row. Point at a rule's name for what it asks; More beside the hint explains each mode and links the how-to.

ColumnWhat it shows
RuleThe rule's name.
ModeOff, Warn or Block. Production needs approval also has the number of approvals it asks for, from 1 approval to 5 approvals.
Projects breaking itHow many projects you can see that have a repository and whose saved pipeline breaks the rule today, as if the rule were on, such as 3 projects. Point at the count, or tap it, for their names. None means every saved pipeline meets it.

Below the table, Save stores your changes and Discard drops the ones you have not saved. Both stay greyed out until you change something.

The rules​

Each rule looks at the step into production: the step into the last stage that has a branch name, when a pipeline has at least two such stages. A pipeline without one passes every rule.

RuleWhat it asks of the step into productionHint on hover
Production needs approvalAt least the number of approvals picked beside its mode (1 unless changed). Whoever asked for a release can never approve it.The step into production needs approvals.
No automatic productionThe step's Runs is By hand, never By itself. Runs is on the step's panel; the steps table shows it in the How it runs column.The step into production never runs by itself.
Production pressed by maintainersOnly Org Owners, Org Admins, Maintainers and named people may press it: neither Developer nor Viewer may be ticked under Can press. A step left on its default passes.Only maintainers and above may press the step into production.

The modes​

ModeWhat a pipeline save does when the step breaks the rule
OffNot checked. Every rule starts Off.
WarnSaves. The card of the stage the step enters shows the warning, and Saved with 1 warning shows under the pipeline's Save.
BlockRefuses the save until the step complies. The stage's card names the rule and the fix. A block holds for everyone, Org Owners included.

Saving a rule changes no project's pipeline: each project meets it on its next save.

On a phone, each rule is a card: its name, then Mode, then Projects breaking it.

The Pipeline rules section on a phone: one card per rule