Change in TiTIler Docker Images

[vincentsarago]

TL&DR

• We're no more producing titiler-uvicorn:latest / titiler-uvicorn:X.Y.Z images
• We've updated the titiler image to python 3.12
• Slight changes in env configuration for Gunicorn

with #1067 merged, we will now produce a single docker image (instead of two: titiler and titiler-uvicorn). The new image has both Uvicorn and Gunicorn available:

Uvicorn

# before
docker run \
    --platform=linux/amd64 \
    -p 8000:8000 \
    --env PORT=8000 \
    --rm -it ghcr.io/developmentseed/titiler-uvicorn:latest

# now
docker run \
    --platform=linux/amd64 \
    -p 8000:8000 \
    --rm -it ghcr.io/developmentseed/titiler:latest \
    uvicorn titiler.application.main:app --host 0.0.0.0 --port 8000 --workers 1

Gunicorn

# before
docker run \
    --platform=linux/amd64 \
    -p 8000:8000 \
    --env PORT=8000 \
    --rm -it ghcr.io/developmentseed/titiler:latest

# now
docker run \
    --platform=linux/amd64 \
    -p 8000:8000 \
    --rm -it ghcr.io/developmentseed/titiler:latest \
    gunicorn -k uvicorn.workers.UvicornWorker titiler.application.main:app --bind 0.0.0.0:8000 --workers 1

To ensure compatibility for those using titiler:latest we've set the CMD within the dockerfile:

titiler/dockerfiles/Dockerfile

Lines 23 to 30 in 5fab604

	###################################################
	# For compatibility (might be removed at one point)
	ENV MODULE_NAME=titiler.application.main
	ENV VARIABLE_NAME=app
	ENV HOST=0.0.0.0
	ENV PORT=80
	ENV WEB_CONCURRENCY=1
	CMD gunicorn -k uvicorn.workers.UvicornWorker ${MODULE_NAME}:${VARIABLE_NAME} --bind ${HOST}:${PORT} --workers ${WEB_CONCURRENCY}

But we are no more following the env configuration from https://github.com/tiangolo/uvicorn-gunicorn-docker?tab=readme-ov-file#advanced-usage. People needing specific configuration should use the command option in docker run or docker-compose