refactor(repo): deploy/ heißt jetzt build/ – der Name sagte das Gegenteil

"deploy" klang nach Ausrollen, drin steht das Gegenteil: das Bau-Rezept
und das Compose, das aus dem Quelltext baut. Ausgerollt wird mit
docker-compose.example.yml im Wurzelverzeichnis. Marc ist genau darüber
gestolpert.

Zwei Dinge mussten dafür vorher fest werden, sonst hätte das Umbenennen
die Entwicklungsdatenbank gekostet: Compose leitet den Projektnamen aus
dem Ordnernamen ab und hätte unter "build" ein neues, leeres Projekt mit
neuem, leerem Volume angelegt. Der Projektname steht deshalb jetzt im
Compose (name: aether), und das Volume trägt seinen alten Namen
ausdrücklich weiter (deploy_postgres_data) – unschön, aber die Daten
bleiben.

Ebenfalls angepasst: .gitignore. Dort stand deploy/.env; nach dem
Umbenennen wäre build/.env nur noch von der allgemeinen .env-Zeile
gedeckt gewesen.

Nachgeprüft nach dem Umzug: Abbild baut, Stapel startet, 113 Dateien in
der Datenbank wie vorher, Volume unverändert deploy_postgres_data,
GET / → 200.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
This commit is contained in:
marcandClaude Opus 5 committed 2026-09-02 09:24:09 +02:00
1 parent a7a67da040
commit 471679ff64
7 files changed
+30 -20

No files matched your search

+8 -8
View File
@@ -42,11 +42,11 @@ Zwei Wege, je nachdem was du vorhast:
| | |
|---|---|
| **Betreiben** | `docker-compose.example.yml` im Wurzelverzeichnis. Zieht das fertige Abbild, braucht keinen Quelltext. |
| **Entwickeln** | `deploy/docker-compose.yml`. Baut aus dem Quelltext. |
| **Entwickeln** | `build/docker-compose.yml`. Baut aus dem Quelltext. |
Die **`.env.example` im Wurzelverzeichnis gilt für beide** – eine Datei, alle
Einstellungen. Sie lag bis zum 02.09.2026 doppelt vor (einmal schlank hier,
einmal vollständig unter `deploy/`), und die beiden liefen auseinander: Der
einmal vollständig im Bau-Ordner), und die beiden liefen auseinander: Der
produktiven fehlten am Ende zwölf Schlüssel, darunter `SESSION_MAX_AGE`, und
sie empfahl für `OFFICE_WOPI_URL` einen Wert, der mit Collabora nicht
funktioniert.
@@ -73,7 +73,7 @@ cd aether
```bash
cp .env.example .env # beim Betreiben
cp .env.example deploy/.env # beim Entwickeln (dorthin schaut das Compose)
cp .env.example build/.env # beim Entwickeln (dorthin schaut das Compose)
```
Ausfüllen musst du mindestens:
@@ -110,8 +110,8 @@ Beim ersten Start:
Aus dem Quelltext bauen statt ziehen:
```bash
docker compose -f deploy/docker-compose.yml build app
docker compose -f deploy/docker-compose.yml up -d
docker compose -f build/docker-compose.yml build app
docker compose -f build/docker-compose.yml up -d
```
Aktualisieren:
@@ -313,9 +313,9 @@ nur `GET`/`POST`, und dann scheitert das Einbinden mit einem `405`.
## Abbild bauen und veröffentlichen
```bash
# im Wurzelverzeichnis des Projekts, nicht in deploy/
# im Wurzelverzeichnis des Projekts, nicht in build/
IMG=gitea.honeyy.duckdns.org/docker/aether
docker build -f deploy/Dockerfile -t $IMG:$(date +%Y.%m.%d) -t $IMG:latest .
docker build -f build/Dockerfile -t $IMG:$(date +%Y.%m.%d) -t $IMG:latest .
docker push $IMG:$(date +%Y.%m.%d)
docker push $IMG:latest
```
@@ -395,7 +395,7 @@ aether/
│ ├── components/
│ ├── hooks/
│ └── pages/
├── deploy/
├── build/
│ ├── docker-compose.yml # app + postgres (kein Proxy-Container)
│ ├── Dockerfile
│ └── .env.example