mosaicgreifswald/debian repository overview

⁠General

This is the base image for all mosaicgreifswald/ images. Some scripts are predefined here that are useful for health checks, start order and version information. Each new layer should "register" for this so that the new attributes are known and can be used.

Registration is explained using the example of a simple database:

register \
  --add-version="Database-Server:\$(/opt/database/bin/daemon -v)" \
  --add-entrypoint="ENTRY_DB_CONFIG:/opt/database/config" \
  --add-entrypoint="ENTRY_DB_DATADIR:/opt/database/data" \
  --add-healthcheck-script="/opt/database/healthcheck.sh" \
  --add-process="database:10:service:/opt/database/run.sh:/opt/database/started.sh"

Explanation

• The parameter --add-version="NAME:VERSION" is used to announce a new tool and how its version can be queried. It is also possible to simply pass the version number directly or as a variable if it should not change in this image.
• The parameter --add-entrypoint="NAME:PATH" specifies a new entry point in the image that can be referenced at start-up via --volume "*:*" to exchange data with the host system.
• --add-healthcheck-script=SCRIPT is used to announce a bash script to be used for health checking the layer. The script to be executed may generate output, but must be terminated with exit code 1 if the corresponding layer is no longer functioning properly. Exit code 0 means "All is well".
• The value of parameter --add-process is needed to register a new process and must have the format NAME:ORDER:TYPE:RUN:STARTED, whereby the last segment is optional.
  • The value NAME is used to identify the process. The name can be used to filter processes and start or stop them individually.
  • ORDER determines the start order, whereby a larger value means a later start. As a rough guide, databases should start with 10, app servers with 20 and tests from 30.
  • With TYPE the start type of the layer is defined, which can contain the characteristics action and service.
  • If TYPE has value action the RUN script is started and no further RUN scripts are executed until this one is finished.
  • With service as TYPE value starts the RUN script in the background. If the optional STARTED script is specified, this is used to check and wait when the services has started up correctly and then start the other RUN scripts.

⁠Relevant ENV variables

The MOS_RUN_MODE, in contrast to the TYPE in the --add-run-script, does not affect the individual layer, but the behaviour in the whole image:

• action will wait until all action-run-scripts are successful finished and then also stop the service-run-scripts
• service starts all run-scripts and tries to restart services if they quit
• cascade like service but also stops all other services as soon as a service ends
• external like service but does not restart an ended service nor does it stop the others

The MOS_WAIT_FOR_PORTS variable holds a comma- or semicolon-separated list of endpoints in the form: host:port[:timeout]

• host hostname or IP to check
• port TCP port to connect to
• timeout (optional) seconds to wait before giving up (default 300)
• sleep (optional) seconds to sleep after successful connection (default 0)

The MOS_SHUTDOWN_DELAY variable defines the duration, in seconds, after which all services should be gracefully terminated.
The MOS_INCLUDE_PROCESSES variable can contain a regular expression that includes one or more processes to be started by name.
The variable MOS_EXCLUDE_PROCESSES does exactly the opposite. It ignores processes that match the regular expression.

⁠Relevant Entrypoints

⁠Usage

# build base-image
> cd mosaic-hgw/Docker/images/debian
> docker build --tag="mosaicgreifswald/debian" --file="Dockerfile.debian" .

# "versions" shows all installed tools and components, with their versions.
> docker run --rm mosaicgreifswald/debian:13 versions
  last updated               : 2026-07-20 10:27:17
  Architecture               : x86_64
  Distribution               : Debian GNU/Linux 13.6 (trixie)
  
# "entrypoints" lists all registered entrypoints.
> docker run --rm mosaicgreifswald/debian entrypoints
  ENTRY_LOGS                 : /entrypoint-logs

⁠Current Software-Versions on this Image