Last updated: 23 May 2022
Configure a GitHub repo
Repositories in GOV.UK must:
- Have the GOV.UK CI Bots, GOV.UK Production Deploy, and GOV.UK Production Admin teams as
Admin
- Have a good description
- Link to relevant documentation
- Have the
govuk
topic - Have a good README
Almost all repos should:
- Have branch protection on
main
- Have Jenkins CI configured, if the repo uses Jenkins
- Have GitHub Trello Poster enabled
Auto configuration
When your repo is tagged with govuk
, it will be auto-configured by govuk-saas-config. This will take care of the settings, branch protection and web hooks.
When you create a new repo:
- Give the GOV.UK CI Bots, GOV.UK Production Deploy, and GOV.UK Production Admin teams
Admin
access - Give the GOV.UK
Write
access - Tag it with the
govuk
topic - Kick off a build of the Jenkins job to automate the rest
If your repo will be continuously deployed, restrict merge access to users with production deploy access with the repo_overrides.yml
file.