bnbalsamo/flask_stack repository overview

A stack for deploying flask/django python applications via Docker, utilizing gunicorn, nginx, and runit.

v0.5.0

Github⁠

Dockerhub⁠

⁠Usage

• Inherit from this image in your own project's Dockerfile.
• Be sure to include a setup.py in the root directory of your project
• Set any project specific environmental variables in your projects Dockerfile
• Set the environmental variable APP_NAME to the module name which contains your wsgi callable
• Optionally, include a file named apk_packages.txt in your project directory
  • This should be a file with one alpine package name per line, ending with a blank line
  • These will be installed via apk add --no-cache $x before your python package is built
• Optionally, include a requirements.txt in the root directory of your project
  • Requirements in requirements.txt will be installed via pip -r requirements.txt before setup.py is invoked
• Optionally, set the environmental variable APP_CALLABLE if the callable is not named "app"
• Build your project
• Run a container

See an example super minimal flask project here⁠

See an example super minimal django project here⁠

⁠Customization

Functionality can be customized by tweaking environmental variables in any of the following places:

• In this Dockerfile, if you build locally
• In the CLI args to building the flask_stack image, if you build locally
• In your projects Dockerfile
• In the CLI args to building your projects image
• In the CLI args to starting your project container

Changes made to the flask_stack Dockerfile or flask_stack build CLI args will inherit into every project based on the image. Changes made in your projects Dockerfile or your projects build CLI args will become the defaults for your projects containers, and changes made in the CLI args when starting a container will apply to that container only.

⁠Docker Build Args

• NGINX_WORKER_PROCESSES=4
• NGINX_USER=nobody
• NGINX_GROUP=nogroup
• NGINX_WORKER_CONNECTIONS=1024
• NGINX_PORT=80
• NGINX_TIMEOUT=300
• NGINX_ROOT_DIR=/dev/null
• NGINX_ACCEPT_MUTEX=on
• NGINX_SENDFILE=on
• NGINX_CLIENT_MAX_BODY_SIZE=4G
• NGINX_SERVER_EXTEND
• NGINX_HTTP_EXTEND
• NGINX_EVENTS_EXTEND
• NGINX_ROOT_EXTEND
• NGINX_UPSTREAM_EXTEND
• NGINX_PROXY_EXTEND
• NGINX_CLI_EXTEND
• GUNICORN_WORKER_TYPE=eventlet
• GUNICORN_WORKERS=4
• GUNICORN_TIMEOUT=300
• GUNICORN_CLI_EXTEND
• APP_CALLABLE=app