Docker-Compose-Referenz

Welche Compose-Datei mit Tale ausgeliefert wird, wofür jede gut ist, und wie die Schichtung funktioniert, wenn du Dev-, Docs- oder Test-Kombinationen hochfährst.

3 min read

Tale liefert eine Handvoll Docker-Compose-Dateien aus. Die Basis ist compose.yml; der Rest sind Overlays, die Services für spezifische Szenarien hinzufügen oder ersetzen — Entwicklung, Docs, Test. Diese Seite benennt jede Datei, sagt, wann du sie wählst, und gibt die Schichtungs-Regel, der alles andere folgt.

Die Form ist absichtlich konservativ. Die Basis-Datei allein läuft in Produktion; jedes Overlay ist per -f opt-in und fügt nur hinzu, was es muss. Merk dir die Basis und ein einzelnes Overlay, nicht das ganze Raster.

Ein durchgespieltes compose-up

Eine produktive Single-Host-Instanz läuft allein aus der Basis:

bash

docker compose up -d

Ein Entwickler, der gleichzeitig an Platform und Docs hackt, schichtet zwei Overlays:

bash

docker compose -f compose.yml -f compose.dev.yml -f compose.docs.yml up -d

Die linkeste Datei ist die Basis; jede nachfolgende Datei merged ihre Schlüssel obendrauf. Konflikte (gleicher Service, gleicher Schlüssel) lösen mit Last-File-wins auf. Der gemergte Graph ist, was Docker hochfährt.

Die Compose-Dateien

Datei	Anwendungsfall	Bemerkenswerte Overrides
`compose.yml`	Produktion auf einem einzelnen Host	Die Basis — jeder Service, Healthchecks, Restart-Policy
`compose.dev.yml`	Lokale Entwicklung mit Hot-Reload	Mountet Quellen in Container, tauscht auf Dev-Images, gibt Dev-Ports frei
`compose.docs.yml`	Fügt den Docs-Site-Service hinzu	Fährt `tale-docs` hoch und routet `/docs` durch den Proxy
`compose.web.yml`	Fügt den Marketing-Site-Service hinzu	Fährt `tale-web` hoch und routet `/` (Root) durch den Proxy
`compose.test.yml`	Lässt die Platform-Test-Suite gegen den Stack laufen	Ersetzt das Platform-Image durch die test-geformte Variante
`compose.web.test.yml`	Lässt Web-Tests laufen	Wie `web.yml`, aber die test-geformte Variante
`compose.docs.test.yml`	Lässt Docs-Tests laufen	Wie `docs.yml`, aber die test-geformte Variante
`docker-compose.test-mock.yml`	Mock-gestützte Integrationstests	Tauscht Provider gegen Mock-Implementierungen

Services und ihre Rollen

Der Basis-Graph fährt acht Container hoch:

tale-proxy — Caddy. TLS, Reverse-Proxy, 301s.
tale-platform — die TanStack-Start-App. Die User-zugewandte UI und API.
tale-convex — das Convex-Backend. WebSocket, Queries, Mutationen, Actions.
tale-db — Postgres. Der persistente Speicher.
tale-rag — Python-FastAPI. Embeddings, Retrieval.
tale-crawler — der Crawler-Service. Website-Wissensquellen.
tale-sandbox-egress und tale-sandbox — die Sandbox-Ebene. Run-Code-Container hinter einer Egress-Allowlist.

Container-Architektur vertieft, was was besitzt.

Overrides

Operator-Anpassungen gehören in ein zusätzliches Overlay, nicht in Edits an den ausgelieferten Dateien. Erstell eine compose.local.yml mit den Overrides, die du brauchst:

yaml

services:
  platform:
    environment:
      - LOG_LEVEL=debug

Fahr den Stack mit dem lokalen Overlay zuletzt geschichtet hoch:

bash

docker compose -f compose.yml -f compose.local.yml up -d

Dieses Muster hält git pull sauber — keine Merge-Konflikte auf den ausgelieferten Dateien. Dasselbe Muster funktioniert für jedes benutzerdefinierte Volume-Mount, jeden benutzerdefinierten Port oder jedes Environment-Override.

Profile

Eine Handvoll Services in der Basis-Datei nutzt Docker-Compose-Profile. Profile lassen einen Service im Graph existieren, aber nicht starten, ausser sein Profil ist aktiviert. Die beiden im Einsatz befindlichen Profile sind gpu (für Hosts mit GPU-gestütztem lokalem Inferenz) und monitoring (für das optionale Prometheus und Grafana). Aktivier mit:

bash

docker compose --profile monitoring up -d

Wo das hineinpasst

Die Compose-Referenz ist das Raster des Betreibers für den Source-Tree. Für das Innere jedes Containers deckt die Seite Container-Architektur Verantwortlichkeiten ab; für die Variablen, die die Container beim Boot lesen, ist die Environment-Referenz die Quelle der Wahrheit.

Edit on GitHub