Skip to content

Latest commit

 

History

History
42 lines (31 loc) · 1.72 KB

README.md

File metadata and controls

42 lines (31 loc) · 1.72 KB

Application Maintenance Page

Overview

This directory contains the manifest files needed to deploy a standard maintenance page into your namespace.

This directory also contains the maintenance page HTML file, along with a DockerFile to compile an image.

Deploying the page

Within the kubectl_deploy directory, there are 2 simple manifest files that make up the deployment, deploy.yaml and service.yaml.

From the root of this repository, simply run:

kubectl apply -f kubectl_deploy -n YOUR-NAMESPACE

The deployment will create a pod called maintenance-page-* and a service named maintenance-page-svc.

Redirecting traffic

Having deployed the maintenane page is not enough - traffic must be redirected to it.

This can be achieved by changing the serviceName field in your current ingress to point to maintenance-page-svc.
This can either be done by redeploying the ingress or doing an in-place edit of the ingress.

Custom HTML

The HTML provided by default is a basic MoJ-branded page. If you wish to customize it, you will need to:

  • Clone this repo
  • Update the index.html
  • docker build . -t 754256621582.dkr.ecr.eu-west-2.amazonaws.com/cloud-platform/maintenance:0.2.0-MY-APP-NAME
  • docker push 754256621582.dkr.ecr.eu-west-2.amazonaws.com/cloud-platform/maintenance:0.2.0-MY-APP-NAME
  • Update the image tag used in the deployment file.

Cleaning up

Once the maintenance page is not needed anymore :

  • Change the serviceName in your ingress back to the original value (pointing to your app)
  • Make sure the your app can be reached via the URL, as expected.
  • The maintenance page can be removed by running: 
    kubectl delete -f kubectl_deploy -n YOUR-NAMESPACE