Skip to main content

Fix a rule across many repositories

When the same rule fails in many repositories, fix them together with a campaign. You pick the rules; Jaah files one fix task per repository that fails any of them, lowest level first, and each opens a pull request.

Who can do this: Start campaign shows for anyone with the permission to edit compliance on at least one project. A campaign covers only the repositories where you may also create and edit tasks on the project. You need results first: run a scan if you have none.

Start a campaign​

  1. In the sidebar, select Compliance. The page opens on its Repos tab.
  2. Select ⋯ at the right of the toolbar, then Start campaign.
  3. Under Rules, tick the rules to fix. Each shows its level, its mode and how many repos fail it. A rule that already has a fix on the way everywhere is not listed.
  4. Read Order (N): the repositories the campaign will fix, numbered in the order they get their fix. Each one's Fixes: line names the rules fixed there.
  5. Select Start campaign (N repos). The dialog closes and Jaah files the fixes.
  6. Check the summary line above the list: Campaign: counts the repositories queued, in progress, with a PR open, merged, failed or scanned again.

With no failing rule, the dialog says Nothing to fix. and the button stays off.

Follow it to green​

Each fix is an ordinary task. On a repository's page, its gap moves from Fix queued through Fix in progress and PR open to Fix merged — rescan to confirm. It turns green only once a rescan passes, so select Rescan all from the ⋯ menu after the pull requests merge.

How fixes and campaigns work is in How compliance works. To accept a gap for a time instead, see Waive a compliance gap. Every field of the dialog is in the Repository compliance reference.