Allow an appconfig.ini file to be set

Author: hyanwong

README.md

@@ -8,21 +8,23 @@ Docker container for Nginx with Web2py based on [madharjan/docker-nginx](https:/
 ## Features
 
 * Environment variables to set admin password
+* User-provided appconfig.ini file can be specified
 * Minimal (for production deploy) version of container `docker-nginx-web2py-min` for Web2py without `admin`, `example` and `welcome`
 * Bats [bats-core/bats-core](https://github.com/bats-core/bats-core) based test cases
 
 ## Nginx 1.10.3 & Web2py 2.21.1 (docker-nginx-web2py)
 
 ### Environment
 
-| Variable             | Default | Example                                                                                    |
-|----------------------|---------|--------------------------------------------------------------------------------------------|
-| WEB2PY_ADMIN         |         | Pa55w0rd                                                                                   |
-| DISABLE_UWSGI        | 0       | 1 (to disable)                                                                             |
-|                      |         |                                                                                            |
-| INSTALL_PROJECT      | 0       | 1 (to enable)                                                                              |
-| PROJECT_GIT_REPO     |         | [https://github.com/madharjan/web2py-contest](https://github.com/madharjan/web2py-contest) |
-| PROJECT_GIT_TAG      | HEAD    | v5.1.4                                                                                     |
+| Variable                  | Default | Example                                                                                    |
+|---------------------------|---------|--------------------------------------------------------------------------------------------|
+| WEB2PY_ADMIN              |         | Pa55w0rd                                                                                   |
+| DISABLE_UWSGI             | 0       | 1 (to disable)                                                                             |
+|                           |         |                                                                                            |
+| INSTALL_PROJECT           | 0       | 1 (to enable)                                                                              |
+| PROJECT_GIT_REPO          |         | [https://github.com/madharjan/web2py-contest](https://github.com/madharjan/web2py-contest) |
+| PROJECT_GIT_TAG           | HEAD    | v5.1.4                                                                                     |
+| PROJECT_APPCONFIG_INI_PATH|         | /etc/appconfig.ini                                                                         |
 
 ## Build
 
@@ -121,7 +123,7 @@ WantedBy=multi-user.target
 | PROJECT_GIT_REPO     |                  | [https://github.com/madharjan/web2py-contest](https://github.com/madharjan/web2py-contest) |
 | PROJECT_GIT_TAG      | HEAD             | v1.0                                                                                       |
 
-### With deploy web projects
+### To deploy web projects
 
 ```bash
 docker run --rm \
@@ -140,3 +142,10 @@ docker run --rm \
 sudo systemctl enable web2py
 sudo systemctl start web2py
 ```
+
+note that some projects may require an bespoke appconfig.ini file, e.g. to specify
+a database to be used with this docker instance. This can be done by mounting
+a fine in your docker image at (e.g.) /etc/appconfig.ini, then setting
+PROJECT_APPCONFIG_INI_PATH to this file path, from where it will be moved into
+the `private` directory of your web2py project, overwriting any existing
+appconfig.ini file in there.

bin/web2py-systemd-unit

@@ -13,6 +13,7 @@ DEF_VOLUME_HOME=/opt/docker
 DEF_NAME=web2py
 DEF_INSTALL_PROJECT=0
 DEF_PROJECT_GIT_REPO=
+DEF_PROJECT_APPCONFIG_INI_PATH=
 DEF_PROJECT_GIT_TAG=
 
 DEF_WEB2PY_ADMIN=
@@ -24,6 +25,7 @@ NAME=${NAME:-$DEF_NAME}
 
 INSTALL_PROJECT=${INSTALL_PROJECT:-$DEF_INSTALL_PROJECT}
 PROJECT_GIT_REPO=${PROJECT_GIT_REPO:-$DEF_PROJECT_GIT_REPO}
+PROJECT_APPCONFIG_INI_PATH=${PROJECT_APPCONFIG_INI_PATH:-$DEF_PROJECT_APPCONFIG_INI_PATH}
 PROJECT_GIT_TAG=${PROJECT_GIT_TAG:-$DEF_PROJECT_GIT_TAG}
 
 WEB2PY_ADMIN=${WEB2PY_ADMIN:-$DEF_WEB2PY_ADMIN}

services/16-project.sh

@@ -16,7 +16,10 @@ if [ ! "${INSTALL_PROJECT}" -eq 0 ]; then
     mkdir -p /opt/web2py/applications/${FOLDER}
     rsync -avh --remove-source-files --delete /var/www/html/* /opt/web2py/applications/${FOLDER}/
     find . -type d -empty -delete
-    
+    # If an alterative appconfig.ini file has been provided via an env var, use that
+    if [ -n "${PROJECT_APPCONFIG_INI_PATH}" ]; then
+      cp "${PROJECT_APPCONFIG_INI_PATH}" "/opt/web2py/applications/${FOLDER}/private/appconfig.ini"
+    fi
   fi
 
 fi