sp-containers/docs/configuration-contextualization.md

Contextualisation la configuration

Les images intègrent l'utilitaire gomplate par défaut.

Ce dernier est utilisé au démarrage du conteneur afin de compléter les fichiers prévus à cet effet avec les données de contexte. Cette opération est réalisée par le script files/common/scripts/run.sh.

Le principe général est le suivant:

1. Au démarrage du conteneur:
   1. Trouver tous les fichiers de l'arborescence correspondant dont le nom termine par <CHEMIN>/<NOM_FICHIER>.<EXT>.gotmpl
   2. Générer le fichier <CHEMIN>/<NOM_FICHIER>.<EXT> via gomplate

Par exemple, le fichier /etc/nginx/nginx.conf.gotmpl sera automatiquement transformé en /etc/nginx/nginx.conf au démarrage du conteneur.

Cette opération s'appliquent également aux fichiers ajoutés par les images étendant les images de base, ainsi que dans les volumes.

Une grande partie des fichiers de configuration par défaut des images sont prévus pour être compatibles avec ce mécanisme. Vous pouvez donc personnaliser une partie de leurs attributs via des variables d'environnement.

Voir par exemple le fichier files/common/nginx/nginx.conf.gotmpl.