Initial template

template/{{ part_dir }}/.env.example.jinja

@@ -0,0 +1,2 @@
+{% if layout == 'root' %}COMPOSE_PROFILES=services
+{% endif %}

template/{{ part_dir }}/Makefile.jinja

@@ -0,0 +1,47 @@
+COMPOSE := {% if layout == 'part' %}cd .. && {% endif %}docker compose
+IMAGE := {{ project_slug }}/{{ part }}
+changed = ! git diff --quiet $(1) -- $(2) 2>/dev/null
+stamp = { git update-ref $(1) HEAD 2>/dev/null || true; }
+
+.PHONY: {% if layout == 'root' %}env recreate rebuild restart logs down deploy {% endif %}fmt check build pre-deploy post-deploy
+
+fmt:
+	@:
+
+check:
+	@:
+
+build:
+	$(COMPOSE) build {{ service }}
+
+pre-deploy:
+	@if $(call changed,refs/deploy/{{ part }},.) || ! docker image inspect $(IMAGE) >/dev/null 2>&1; then \
+		$(MAKE) build && $(call stamp,refs/deploy/{{ part }}); \
+	fi
+
+post-deploy:
+	@:
+{% if layout == 'root' %}
+env:
+	@test -f .env || cp .env.example .env
+	@test -f docker-compose.override.yml || cp docker-compose.override.yml.example docker-compose.override.yml
+
+recreate:
+	$(COMPOSE) up -d --force-recreate
+
+rebuild: build
+	$(COMPOSE) up -d
+
+restart:
+	$(COMPOSE) restart
+
+logs:
+	$(COMPOSE) logs -f --tail=100
+
+down:
+	$(COMPOSE) down
+
+deploy: pre-deploy
+	$(COMPOSE) up -d
+	$(MAKE) post-deploy
+{% endif %}

template/{{ part_dir }}/docker-compose.override.yml.example.jinja

@@ -0,0 +1,12 @@
+{%- set dash = project_slug | replace('_', '-') -%}
+services:
+  {{ service }}:
+    networks:
+      default: {}
+      caddy:
+        aliases:
+          - {{ dash }}-{{ service }}
+
+networks:
+  caddy:
+    external: true

template/{{ part_dir }}/docker-compose.yml.jinja

@@ -0,0 +1,12 @@
+services:
+  {{ service }}:
+    build: {{ part_dir }}
+    image: {{ project_slug }}/{{ part }}
+    profiles: [{{ service }}, services]
+    restart: unless-stopped
+    env_file:
+      - path: .env
+        required: false
+{% if layout == 'part' %}      - path: {{ part }}/.env
+        required: false
+{% endif %}

template/{{ part_dir }}/{% if layout == 'root' %}README.md{% endif %}.jinja

@@ -0,0 +1,12 @@
+# {{ project_name }}
+
+Runs in Docker, locally the same way as in production. `COMPOSE_PROFILES` in `.env` selects the services that run on this machine. `docker-compose.override.yml` holds what differs between machines: published ports and the aliases on the external `caddy` network.
+
+```sh
+make env
+make recreate
+```
+
+`make env` creates `.env` and `docker-compose.override.yml` from their examples. `make recreate` starts the selected profiles, `make rebuild` builds the image first, `make logs`, `make restart` and `make down` do what they say.
+
+To deploy, `git pull && make deploy`. It runs `make pre-deploy`, which rebuilds the image only when something in the repository changed, then `docker compose up -d`. A deploy system with its own `up` step calls `make pre-deploy` before it and `make post-deploy` after. What was built is remembered as `refs/deploy/*` in the clone.