QWC uWSGI Base

QWC docker uWSGI base images for QWC services.

Multiple environment variables are available:

Variable	Description	Default value
LOCALE	For the ubuntu-based qwc-uwsgi-base, defines the runtime locale in the form lang_COUNTRY (i.e. de_CH)	en_US
PGSERVICEFILE	Path to pg_service.conf file	/srv/pg_service.conf
REQ_HEADER_BUFFER_SIZE	Internal uWSGI buffer size	12288
SERVICE_GID	GID used for running the service; if explicitly set to an empty value, --gid is not passed to uWSGI	33
SERVICE_MOUNTPOINT	Route from which the service will be mounted (e.g. /api/v1/feature-info)	/
SERVICE_UID	UID used for running the service; if explicitly set to an empty value, --uid is not passed to uWSGI	33
UV_COMPILE_BYTECODE	Enable UV byte code compilation	1
UWSGI_EXTRA	Extra parameter to pass to uWSGI command line - see below	empty
UWSGI_PROCESSES	Number of uWSGI processes to spawn	1
UWSGI_THREADS	Number of uWSGI threads for each processes	4

OpenShift / random UID environments

By default, the container starts uWSGI with --uid $SERVICE_UID --gid $SERVICE_GID.

If your platform runs containers with an arbitrary non-root UID (for example OpenShift), you can disable passing these options independently by setting:

SERVICE_UID=
SERVICE_GID=

Each empty variable suppresses only its corresponding argument.

Extra uWSGI parameters

UWSGI_EXTRA does not support quoted arguments. For instance, UWSGI_EXTRA: --parameter-name='my quoted value' will expand to multiple parameters --parameter-name='my, quoted and value', therefore it will try to load configuration file quoted and fail: unable to load configuration from quoted.

If you wish to use quoted values (for logformat for instance), a workaround is to use a mounted uwsgi.ini file, for instance:

1. define UWSGI_EXTRA: --ini=/etc/uwsgi.ini

2. add the parameters in a uwsgi.ini file:

   [uwsgi]
   logdate = %%Y-%%m-%%d %%H:%%M:%%S
   logformat-strftime = true
   logformat = [%(ftime)] "%(method) %(uri) %(proto)" %(status)

3. mount that file in your Docker container