Override-based compose, profiles in .env, README

2026-09-09 00:18:15 +02:00
parent 1c628625e9
commit 7ee077ada0
4 changed files with 36 additions and 14 deletions
@@ -0,0 +1,14 @@
+# {{ project_name }}
+{% if project_description %}
+{{ project_description }}
+{% endif %}
+Runs in Docker, locally the same way as in production. Each part in `{{ parts | join('/`, `') }}/` brings its own `docker-compose.yml`, included from the root one. `COMPOSE_PROFILES` in `.env` selects the services that run on this machine. `docker-compose.override.yml` in each part holds what differs between machines: published ports and the aliases on the external `caddy` network.
+
+```sh
+make env
+make recreate
+```
+
+`make env` creates `.env` from the examples of every part and copies each `docker-compose.override.yml.example`. `make recreate` starts the selected profiles, `make rebuild` builds the images first, `make logs`, `make restart` and `make down` do what they say.
+
+`make fmt`, `make check` and `make build` run in every part. Part-specific targets live in the part's own Makefile: `make -C {{ parts[0] }} ...`.