Skip to main content

Applying a Maintenance Page

Overview

This document will serve as a guide on how to apply a default maintenance page to your application on the Cloud Platform.

Deploying the page

A repository has been created to store all the files related to the maintenance page:

cloud-platform-maintenance-page

The repository 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 build an image to serve the maintenance page.

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

To use this example, deploy the files into your namespace (you may want to create your own docker image, with a customised HTML page, and tweak the yaml files to use that image).

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

To redirect traffic to your maintenance page, change the serviceName field in your current ingress to point to maintenance-page-svc and redeploy the ingress. Also, check the servicePort matches the one mentioned in the service you want to deploy.

By changing the current ingress you can ensure that you do not incur any downtime.

For more details on customizing the HTML and cleaning up, please refer to the cloud-platform-maintenance-page repository.

This page was last reviewed on 11 September 2024. It needs to be reviewed again on 11 March 2025 by the page owner #cloud-platform .
This page was set to be reviewed before 11 March 2025 by the page owner #cloud-platform. This might mean the content is out of date.