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
govuktopic - 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
Adminaccess - Give the GOV.UK
Writeaccess - Tag it with the
govuktopic - 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.