Skip to content
This repository has been archived by the owner on Dec 17, 2023. It is now read-only.

robpco/docker-nginx-uwsgi

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Supported tags and Dockerfile links

You must explicitly use one of the tags above. The latest tag is not assigned since each tag represents a different variant, not an incremental version.

NGINX-UWSGI

Docker image with Nginx, uWSGI and Python running in a single container to enable running Python Web Apps on NGINX.

GitHub Repo: https://github.com/robpco/docker-nginx-uwsgi

Docker Hub Images: https://hub.docker.com/r/robpco/nginx-uwsgi/

Overview

This Docker image allow the creation/migration of Python Web Apps to run on Nginx and uWSGI in a single container. It's designed for use as base image for:

  • Other images - such as a pre-built image for running Flask Apps nginx-uwsgi-flask .
  • A development image that can be customized with your unique web-framework, Python libraries and code.

This repo auto-generates images to Docker-Hub. It includes variants for each supported Python version (2.7, 3.6).

Usage

The Docker-Hub repository contains auto-generated images from this repo. They can be referenced (or pulled) by using the image name robpco/nginx-uwsgi, plus a tag for the python version desired (ex: :python3.6).

Custom Environment Variables

This image supports the following custom environment variables:

  • UWSGI_INI - the path and file of the configuration info
    • default: /app/uwsgi.ini
  • NGINX_MAX_UPLOAD - the maximum file upload size allowed by Nginx
    • 0 = unlimited (image default)
    • 1m = normal Nginx default
  • LISTEN_PORT - custom port that Nginx should listen on
    • 80 = Nginx default

Setting Environment Variables

Environment variables can be set in multiple ways. The following examples, demonstrate setting the LISTEN_PORT environment variable via three different methods. These methods apply to the other Environment Variables as well.

Setting in a Dockerfile

# ... (snip) ...
ENV LISTEN_PORT 8080
# ... (snip) ...

Setting during docker run with the -e option

docker run -e LISTEN_PORT=8080 -p 8080:8080 myimage

Setting in docker-compose file using the environment: keyword in a docker-compose file

version: '2.2'
services:
  web:
    image: myapp
  environment:
    LISTEN_PORT: 8080

UPDATES

  • 2017-12-11: Added multiple tags per variant: py3.6 is the same as python3.6, and so forth...
  • 2017-11-29: Added ability to change port Nginx listens on with new environment variable LISTEN_PORT.
    • Thanks to github user tmshn
  • 2017-11-29: Automatic image re-build when Python updates
  • 2017-11-28: Updated Nginx version
  • 2018-05-04: Updated to use pythonx.x-stretch as base & Nginx 1.13.12-1
  • 2018-06-10: Updated to Nginx 1.15.0-1

CHANGELOG

  • 2017-12-15: Fix to avoid duplicate listen entries in nginx.conf
  • 2017-11-30: limit build failures caused by GPG key validation failing
  • 2017-11-28: Fixed console errors from supervisor process:
    • Added explicit path reference to supervisord.conf in Dockerfile CMD statement
    • Added explicitly set username in supervisord.conf