This repository contains the results of a discovery into hosting/kubernetes as a container orchestration solution for GOV.UK.

This repository is a clean-clone of another (private) that contained various pieces of sensitive data which have been removed from this copy.

By the end of the discovery several approaches had been tested so not all of this repository is in a working state.

This project went through several stages:

1. Initial discovery on Google Container Engine (GKE) using a manually deployed cluster. Used government-frontend as a test app.
2. Work on templating kubernetes manifests (/govuk-k8s-deployment).
3. GKE HTTP Load Balancer for ingress.
4. Terraformed GKE cluster deployment.
5. Database creation in Cloud SQL for the release app.
6. Persistent Volume work for hosting Mongo in cluster to run content-store.
7. Changed Terraform to build in AWS.
8. Introduced kube-aws to build the cluster.
9. AWS Application Load Balancer for ingress (with echoserver).

We use Architecture Decision Records to keep a track of decisions we make across the course of this alpha. These can be found here.

There is some information regarding different components of our architecture. These can be found here.

The first part of our alpha we explored Google Cloud Platform. Some notes can be found here, and we also retain some Terraform files to build a fresh cluster.

We are using Terraform to provision our infrastructure.

Please see the documentation for further details.

A large part of our discovery is working with Kubernetes to deploy our applications as containers. Kubernetes provides the networking and deployment model for our container based environment.

Please see the documentation for more details.

We store our manifests here.

We are using CoreOS for our deployment of a Kubernetes cluster.

To create and interact with a Kubernetes cluster provisioned in AWS, please see the documentation regarding kube-aws.