Allow users to pass custom flags to commands

resolves #1

Author: tedivm

README.md

@@ -7,35 +7,35 @@ For this container the latest version of gunicorn is always used, and the tags r
 
 <!--ts-->
 * [python-gunicorn-uvicorn](#python-gunicorn-uvicorn)
-   * [Benefits](#benefits)
-      * [Multi Architecture Builds](#multi-architecture-builds)
-      * [Small Images via Multi Stage Builds](#small-images-via-multi-stage-builds)
-      * [No Rate Limits](#no-rate-limits)
-      * [Rapid Building of New Versions](#rapid-building-of-new-versions)
-      * [Regular Updates](#regular-updates)
-   * [How To](#how-to)
-      * [Using the Full Image](#using-the-full-image)
-      * [Using the Slim Image](#using-the-slim-image)
-      * [Copy Just the Packages](#copy-just-the-packages)
-      * [Add Your App](#add-your-app)
-      * [PreStart Script](#prestart-script)
-   * [Environmental Variables](#environmental-variables)
-      * [PORT](#port)
-      * [WORKERS](#workers)
-      * [LOG_LEVEL](#log_level)
-      * [MODULE_NAME](#module_name)
-      * [VARIABLE_NAME](#variable_name)
-      * [APP_MODULE](#app_module)
-      * [PRE_START_PATH](#pre_start_path)
-      * [RELOAD](#reload)
-   * [Python Versions](#python-versions)
-   * [Image Variants](#image-variants)
-      * [Full](#full)
-      * [Slim](#slim)
-   * [Architectures](#architectures)
-   * [Sponsorship](#sponsorship)
-   * [Tags](#tags)
-      * [Older Tags](#older-tags)
+  * [Benefits](#benefits)
+    * [Multi Architecture Builds](#multi-architecture-builds)
+    * [Small Images via Multi Stage Builds](#small-images-via-multi-stage-builds)
+    * [No Rate Limits](#no-rate-limits)
+    * [Rapid Building of New Versions](#rapid-building-of-new-versions)
+    * [Regular Updates](#regular-updates)
+  * [How To](#how-to)
+    * [Using the Full Image](#using-the-full-image)
+    * [Using the Slim Image](#using-the-slim-image)
+    * [Copy Just the Packages](#copy-just-the-packages)
+    * [Add Your App](#add-your-app)
+    * [PreStart Script](#prestart-script)
+  * [Environmental Variables](#environmental-variables)
+    * [PORT](#port)
+    * [WORKERS](#workers)
+    * [LOG_LEVEL](#log_level)
+    * [MODULE_NAME](#module_name)
+    * [VARIABLE_NAME](#variable_name)
+    * [APP_MODULE](#app_module)
+    * [PRE_START_PATH](#pre_start_path)
+    * [RELOAD](#reload)
+  * [Python Versions](#python-versions)
+  * [Image Variants](#image-variants)
+    * [Full](#full)
+    * [Slim](#slim)
+  * [Architectures](#architectures)
+  * [Sponsorship](#sponsorship)
+  * [Tags](#tags)
+    * [Older Tags](#older-tags)
 <!--te-->
 
 ## Benefits
@@ -68,6 +68,7 @@ Containers are rebuilt weekly in order to take on the security patches from upst
 ## How To
 
 ### Using the Full Image
+
 The Full Images use the base Python Docker images as their parent. These images are based off of Ubuntu and contain a variety of build tools.
 
 To pull the latest full version:
@@ -103,6 +104,7 @@ FROM ghcr.io/multi-py/python-gunicorn-uvicorn:py3.11-slim-LATEST
 
 
 ### Copy Just the Packages
+
 It's also possible to copy just the Python packages themselves. This is particularly useful when you want to use the precompiled libraries from multiple containers.
 
 ```dockerfile
@@ -181,6 +183,17 @@ Where to find the prestart script.
 
 When this is set to the string `true` uvicorn is launched in reload mode. If any files change uvicorn will reload the modules again, allowing for quick debugging. This comes at a performance cost, however, and should not be enabled on production machines.
 
+
+### `GUNICORN_EXTRA_FLAGS`
+
+This variable can be used to pass extra flags to the `gunicorn` command on launch. It's value is added directly to the command that is called, and has to be formatted appropriately for the command line.
+
+
+### `UVICORN_EXTRA_FLAGS`
+
+This variable can be used to pass extra flags to the `uvicorn` command on launch. It's value is added directly to the command that is called, and has to be formatted appropriately for the command line.
+
+
 ## Python Versions
 
 This project actively supports these Python versions:
@@ -230,6 +243,7 @@ If you get use out of these containers please consider sponsoring me using Githu
 </center>
 
 ## Tags
+
 * Recommended Image: `ghcr.io/multi-py/python-gunicorn-uvicorn:py3.11-0.23.2`
 * Slim Image: `ghcr.io/multi-py/python-gunicorn-uvicorn:py3.11-slim-0.23.2`
 

assets/start.sh

@@ -15,11 +15,10 @@ MODULE_NAME=${MODULE_NAME:-$DEFAULT_MODULE_NAME}
 VARIABLE_NAME=${VARIABLE_NAME:-app}
 export APP_MODULE=${APP_MODULE:-"$MODULE_NAME:$VARIABLE_NAME"}
 
-
 # If there's a prestart.sh script in the /app directory or other path specified, run it before starting
 PRE_START_PATH=${PRE_START_PATH:-/app/prestart.sh}
 echo "Checking for script in $PRE_START_PATH"
-if [ -f $PRE_START_PATH ] ; then
+if [ -f $PRE_START_PATH ]; then
     echo "Running script $PRE_START_PATH"
     . "$PRE_START_PATH"
 else
@@ -30,9 +29,8 @@ fi
 # End of tiangolo/uvicorn-gunicorn-docker block
 #
 
-
 if [[ $RELOAD == "true" ]]; then
-    exec python -m gunicorn "$APP_MODULE"  -k uvicorn.workers.UvicornWorker -k gevent -w ${WORKERS:-4} -b ${HOST:-0.0.0.0}:${PORT:-80} --log-level "${LOG_LEVEL:-info}" --reload
+    exec python -m gunicorn "$APP_MODULE" $GUNICORN_EXTRA_FLAGS -k uvicorn.workers.UvicornWorker $UVICORN_EXTRA_FLAGS -k gevent -w ${WORKERS:-4} -b ${HOST:-0.0.0.0}:${PORT:-80} --log-level "${LOG_LEVEL:-info}" --reload
 else
-    exec python -m gunicorn "$APP_MODULE"  -k uvicorn.workers.UvicornWorker -k gevent -w ${WORKERS:-4} -b ${HOST:-0.0.0.0}:${PORT:-80} --log-level "${LOG_LEVEL:-info}"
+    exec python -m gunicorn "$APP_MODULE" $GUNICORN_EXTRA_FLAGS -k uvicorn.workers.UvicornWorker $UVICORN_EXTRA_FLAGS -k gevent -w ${WORKERS:-4} -b ${HOST:-0.0.0.0}:${PORT:-80} --log-level "${LOG_LEVEL:-info}"
 fi