Django and Podman

Development

# check branches
kb.py
# check branches - and switch if necessary
kb.py --checkout
# check branches - switch if necessary - and pull
kb.py --checkout --pull

uv pip install --group dev

Release

# check branches
kb.py
# check branches - and switch if necessary
kb.py --checkout
# check branches - switch if necessary - and pull
kb.py --checkout --pull
# check uv is happy (although I think 'bump' does the same)
uv sync

# version number increment
uv version --bump patch
# add the files, then commit
git commit -m "chore: 'pyproject.toml' - bump version"
# release
kb.py --release
# push
git push

Build and Run

Build

Update the Dockerfile so it installs the correct version of your project e.g 0.1.72:

uv pip install kb-kbsoftware-couk==0.1.72 --group production --no-sources ...

We use kb-podman.py to build the container from the Dockerfile e.g:

kb-podman.py --tag kbsoftware-couk

Tip

The tag will be used as the name of the container.

> podman container ls
CONTAINER ID  IMAGE                              NAMES
5d759639866b  localhost/kbsoftware-couk:latest   kbsoftware-couk-kbsoftware-couk

Restore

kb.py --restore
kb.py --restoredb /home/web/repo/backup/www.kbsoftware.co.uk/20250812_0100.sql
podman exec -it kbsoftware-couk-kbsoftware-couk django-admin migrate --no-input

Run

podman kube play kbsoftware-couk.yaml --configmap=./config-map.yaml; and podman pod logs -f kbsoftware-couk

Stop the container:

podman pod stop kbsoftware-couk; and podman pod rm kbsoftware-couk

Issues

Logging

Logging needs to be to stdout do Podman can see the logs.

This is the issue (using our standard configuration):

ValueError: Unable to configure handler 'logfile'
FileNotFoundError: [Errno 2] No such file or directory:
'/app/""/"www.kbsoftware.co.uk"-"dev"-logger.log'

From Dockerized Django Logging via Grafana Loki

To solve the issue, I commented out our logfile handler and changed everything to use the console handler (which already uses the logging.StreamHandler).