jench2103/flask-uwsgi-nginx repository overview

⁠Flask Docker Base Image

This is a Docker base image with uWSGI and Nginx for Flask web applications.

⁠Quick reference

• GitHub: https://github.com/Jench2103/flask-docker-base-image⁠
• Docker Hub: https://hub.docker.com/r/jench2103/flask-uwsgi-nginx⁠

⁠Supported tags and respective Dockerfile links

• python3.9.6, latest⁠
• python3.8.11⁠
• python3.6.9⁠

⁠Usage

• Directly pull the image from Docker Hub

  $ docker pull jench2103/flask-uwsgi-nginx:<version>
  

  Copy
• Write a Dockerfile to build your image

  FROM jench2103/flask-uwsgi-nginx:<version>
  
  COPY /host/path/to/app.py /workspace
  COPY /host/path/to/requirements.txt /container/path/to/requirements.txt
  
  RUN pip install -r /container/path/to/requirements.txt
  

  Copy
• The default python code which uWSGI tries to run is /workspace/app.py with the Flask object named app.
• The reverse proxy service Nginx is continuous listening to port 80 in the container, which should be mapped to a host port so that you are available to access the Flask application from web browsers.
  • When use docker run command:

    $ docker run -p <host port>:80 -it <image name>
    

    Copy
  • When use docker-compose.yml:

    services:
        <serivce name>:
            # ... skip ... #
            ports:
                - <host port>:80
    

    Copy

⁠Technical reference

• uWSGI Official Documentation⁠
• uWSGI - Wikipedia⁠
• Nginx Official Documentation⁠
• Nginx - Wikipedia⁠

⁠License

This project is licensed under the MIT License⁠.