decrease optional var logging level and allow to pass extra opts to pavics-compose.sh up -d

CHANGES.md

@@ -15,7 +15,17 @@
 [Unreleased](https://github.com/bird-house/birdhouse-deploy/tree/master) (latest)
 ------------------------------------------------------------------------------------------------------------------
 
-[//]: # (list changes here, using '-' for each new entry, remove this when items are added)
+## Changes
+
+- logging: decrease logging level for empty optional vars from WARN to DEBUG
+
+  To avoid drowning real WARN messages.  Many optional vars can be valid if empty.
+
+- config: add sample config to configure docker-compose to remove orphans
+
+  To remove orphans containers when components are disabled.  Also link to full
+  documentations if other env var can be used.
+
 
 [2.1.0](https://github.com/bird-house/birdhouse-deploy/tree/2.1.0) (2024-02-23)
 ------------------------------------------------------------------------------------------------------------------

birdhouse/env.local.example

@@ -593,3 +593,14 @@ export CATALOG_PASSWORD="${__DEFAULT__CATALOG_PASSWORD}"
 export CATALOG_THREDDS_SERVICE="thredds"
 export PHOENIX_PASSWORD="${__DEFAULT__PHOENIX_PASSWORD}"
 export PHOENIX_PASSWORD_HASH="${__DEFAULT__PHOENIX_PASSWORD_HASH}"
+
+#############################################################################
+# Compose vars
+#   https://docs.docker.com/compose/environment-variables/envvars/
+#   https://docs.docker.com/compose/environment-variables/envvars-precedence/
+#   https://docs.docker.com/engine/reference/commandline/cli/#environment-variables
+#############################################################################
+
+# Remove orphans containers, useful when disabling components.
+# Harmless when left enabled all the time.
+#export COMPOSE_REMOVE_ORPHANS=true

birdhouse/read-configs.include.sh

@@ -228,7 +228,7 @@ check_default_vars() {
         result=`echo "${d}" | grep -c "${default}"`
         if [ -z "`eval "echo ${v}"`" ]
         then
-            log WARN "Optional variable [${n}] is not set. Check env.local file."
+            log DEBUG "Optional variable [${n}] is not set. Check env.local file."
         fi
         if [ "${result}" -gt 0 ]
         then