Skip to main content

A wrapper for running your Python web application using Twisted in a way that works well for Kubernetes.

Project description

# Kubernetes_WSGI

A wrapper for running your Python web application using Twisted in a way that works well for Kubernetes.

This also includes Prometheus metrics support.

## Quick Start

To install:

` pip install kubernetes-wsgi `

To launch your application:

` python -m kubernetes_wsgi myapp 8000 `

where myapp is an importable module name containing your WSGI application function.

## Why Threads?

The gold standard for Python WSGI servers is Gunicorn, renowned for its multi-process execution mode for effcient concurrency despite the dreaded Python GIL (Global Interpreter Lock). Unfortunately when working with containers, multi-process worker models can be difficult to work with as containers generally expect to only have a single process. Specifically this means if one of the forked workers is hit by an OOM and killed, the main process will simply restart it without triggering the usual metrics in Kubernetes for OOM’d Pods. Similarly we have a different way to handle multi-process concurrency in Kubernetes, through a Deployment with many replicas. In the simplest version would could use multiple replicas each handling only one request at a time, but using a thread pool improves throughput by taking advantage of the fact that most web applications are blocked on I/O most of the time (usually waiting for a response from a database or another web service).

## Why Twisted?

Gunicorn itself does have a threadpool mode, however it’s somewhat awkward to work with as it uses the futures ThreadPool implementation. Twisted’s ThreadPool is more efficent. This also allows installing the Prometheus metrics as a native Twisted web handler so it will work even if the threadpool is exhausted, meaning your metrics keep working even during a system overload.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

kubernetes_wsgi-1.tar.gz (10.8 kB view details)

Uploaded Source

Built Distribution

kubernetes_wsgi-1-py3-none-any.whl (8.9 kB view details)

Uploaded Python 3

File details

Details for the file kubernetes_wsgi-1.tar.gz.

File metadata

  • Download URL: kubernetes_wsgi-1.tar.gz
  • Upload date:
  • Size: 10.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6

File hashes

Hashes for kubernetes_wsgi-1.tar.gz
Algorithm Hash digest
SHA256 a8ca4063a36e69eb8199251fb048ff0419486c00d4d5d3ca272a0dd4bb460b37
MD5 9f603890e6d4a659c33245339586b7b1
BLAKE2b-256 3096fc449a791311b6b2d4770ce19aade3914160aa3132799e2af88ebf8332e1

See more details on using hashes here.

File details

Details for the file kubernetes_wsgi-1-py3-none-any.whl.

File metadata

  • Download URL: kubernetes_wsgi-1-py3-none-any.whl
  • Upload date:
  • Size: 8.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.7.6

File hashes

Hashes for kubernetes_wsgi-1-py3-none-any.whl
Algorithm Hash digest
SHA256 8756fb022fb0ce152b79441c64ec8030edaa5d0fca19a9156a3d389dcb66678a
MD5 739e26a1d8e3d10fb2eef2a264850c78
BLAKE2b-256 0027ccf9a6e88773c312fab19bce7368371be8bffdaffd8964d49620efce4bb5

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page