Teaching vacancies - Offline site

Location

The offline site is simple HTML, CSS, and assets (fonts and images). It sits in the teaching-vacancies-offline folder within the S3 bucket 530003481352-offline-site.

With the offline/index.html page, paths to assets are declared from the root of the bucket, including the full folder name, e.g.:

/teaching-vacancies-offline/govuk-frontend.min.css

When is it served?

The "site offline" page is served if Cloudfront detects that the site is returning HTTP status codes:

• 502 Bad Gateway
• 503 Service Unavailable

How is it generated?

The regenerate-offline script:

• downloads and unzips a particular version of the Gov.UK frontend into the offline folder
• renames the version-specific minified CSS file to offline/govuk-frontend.min.css
• does a search and replace to allow the site to be served from a sub-folder
• copies the favicon.ico from /public/favicon.ico

The sync-offline script:

• uses the AWS CLI to synchronise with the offline site S3 bucket

The GitHub Action build_and_deploy workflow includes these steps:

• runs the regenerate-offline script
• runs the sync-offline script

How to update

Edit the offline page

The offline page is a single HTML file in offline/index.html

Update the version of the Gov.UK frontend

• Check for a new release of the Gov.UK frontend
• Set the release in the regenerate-offline script

RELEASE=3.11.0

• When the change is merged, the new version will be synchronised