Différences

Ci-dessous, les différences entre deux révisions de la page.

--- docker_compose [2025/08/02 17:33] – luc
+++ docker_compose [2025/09/09 09:15] (Version actuelle) – luc
@@ Ligne 26: / Ligne 26: @@
 Top-level :
-  * ''name'' : définit le project name
+  * ''name'' : définit le project name. Servira de préfixe à tout le reste (nom des containers -avec suffixe "-1"-, des networks, des volumes...). Si name n'est pas définit, docker prendra le nom du dossier qui contient le Compose file. Limite : si ''container_name'' est défini, il n'y a pas de préfixe
   * ''services'' : (OBLIGATOIRE) A service is an abstract definition of a computing resource within an application which can be scaled or replaced independently from other components. Services are backed by containers.
@@ Ligne 131: / Ligne 131: @@
 De nombreuses commande de ''docker'' sont aussi présentes pour ''docker compose'', elles s'appliquent aux image/container/volume/network listés dans le Compose file (si j'ai bien compris). On listera : ''ls'', ''logs'', ''rm'', ''volumes'' etc.
+===== Définir des variables d'environnement =====
+Parfois, certaines valeurs du docker compose file sont reprises à plusieurs endroits, et il fait sens de regrouper ces valeurs dans un fichier ''.venv''. Ainsi, la modification est centralisée. Il s'agit souvent de variables d'environnement qu'on souhaite passer au container (pas seulement au docker compose).
+=== Fichier .venv ===
+Le fichier ''.venv'' est placé dans le même dossier que le fichier de configuration ''compose.yml''.\
+Le contenu du fichier est une liste de paramètres, format ini ou properties :
+<code properties>
+# Des lignes commentaires précédées d'un "#"
+#
+TAG=15-slim
+OPENPROJECT_HTTPS=false
+OPENPROJECT_HOST__NAME=localhost
+PORT=127.0.0.1:8080
+PGDATA="/var/lib/postgresql/data"
+</code>
+L'utilisation dans le ''compose.yml'' se fait via des variables ''${PORT}'' dont le nom doit correspondre à celui dans le fichier ''.venv'' :
+<code properties>
+web:
+  environment:
+    - DEBUG=${DEBUG}
+</code>
+Note: Dans la version docker CLI, on passe les variables avec l'argument ''-e DEBUG=1''
+=== Interpolation ===
+L'interpolation permet de définir des variables et des comportements (par défaut, alternative, etc.) [https://docs.docker.com/compose/how-tos/environment-variables/variable-interpolation/#interpolation-syntax|source]:
+  * Direct substitution
+    * ''${VAR}'' -> value of VAR
+  * Default value
+    * ''${VAR:-default}'' -> value of VAR if set and non-empty, otherwise default
+    * ''${VAR-default}'' -> value of VAR if set, otherwise default
+  * Required value
+    * ''${VAR:?error}'' -> value of VAR if set and non-empty, otherwise exit with error
+    * ''${VAR?error}'' -> value of VAR if set, otherwise exit with error
+  * Alternative value
+    * ''${VAR:+replacement}'' -> replacement if VAR is set and non-empty, otherwise empty
+    * ''${VAR+replacement}'' -> replacement if VAR is set, otherwise empty