Skip to content
Andrew Hosgood edited this page Dec 8, 2025 · 13 revisions

The National Archives base Docker images are designed to serve as a starting point for all containerised applications in The National Archives. These base images:

  • extend the official Python images
  • include common tools used within TNA (Poetry, nvm, Gunicorn, Uvicorn)
  • don't run as the root user
  • work with the Python frameworks used within TNA (Flask, Django and FastAPI)
  • contain healthcheck definitons
  • can be customised in terms of their thread counts, worker numbers, log levels etc.
  • can build any NodeJS assets as part of their build process
  • are linted with hadolint and shellcheck
  • can start up development NodeJS scripts to build assets in the background

Images

There are two main of images:

  • tna-python - For generic Python applications (production)
  • tna-python-dev - A drop-in replacement for tna-python in development environments

⚠️ tna-python-dev should not be used in production. ⚠️

Versions

Version Purpose
x.y.z A specific semantically versioned release (e.g. 1.2.3)
x.y The latest version of the minor x.y releases (e.g. 1.2 will be the latest 1.2.z build)
x The latest version of the major x releases (e.g. 1 will be the latest 1.y.z build)
latest The latest release
preview The most recent build of the main branch which contains new and unreleased features
feature-x An image based off a feature/x branch
graph TD;
    feature --> preview;
    preview --> latest;
    preview --> x.y.z;
    preview --> x.y;
    preview --> x;
Loading

Clone this wiki locally