GOV.UK Infrastructure

What's in this repo

The govuk-infrastructure repo contains:

• terraform/: Terraform modules for turning up an Kubernetes cluster on EKS for GOV.UK.
• images/: Container image definitions for utilities such as the toolbox image.
• .github/: GitHub Actions and workflows used by other GOV.UK repos, for example release automation, test runners and security analysis tools.

What's not in this repo

Helm charts for GOV.UK applications are in alphagov/govuk-helm-charts.

Base image definitions for GOV.UK Ruby apps are in alphagov/govuk-ruby-images.

Configuration of CDN services is stored in alphagov/govuk-fastly and alphagov/govuk-fastly-secrets (private) repos.

Usage

To install the compatible version of Terraform:

brew install tfenv
cd terraform/
tfenv install latest
tfenv use latest

We set the constraints with minor version precision. However when using this Terraform version manager, you need to specify the patch version, e.g. tfenv install 1.10.5.

Pre-commit hooks

We have some recommended pre-commit hooks. You need to install pre-commit for these to run.

Documentation

See the docs/ directory.

There are also docs in terraform/docs/ and inline READMEs in some directories.

Team

GOV.UK Platform Engineering team looks after this repo. If you're inside GDS, you can find us in #govuk-platform-engineering or view our kanban board.

Licence

MIT License