florian.wilde/ProxLedger
1
0
Fork 0
Code Issues 1 Pull Requests Actions 2 Packages Projects Releases Wiki Activity

#026 Auslieferung finalisieren #26

New Issue
Closed
opened 2026-09-18 22:11:42 +00:00 by florian.wilde · 0 comments
florian.wilde commented 2026-09-18 22:11:42 +00:00
Owner
Copy Link
Copy Source

Ziel

Zwei saubere Wege, ProxLedger in Betrieb zu nehmen: als Docker-Stack und als LXC-Container nach Art
der Proxmox VE Helper-Scripts.

Aufgaben

  • deploy/update.sh: sichern, bauen, migrieren, neu starten, Erreichbarkeit prüfen
  • Zustandsprüfung für den Worker in docker-compose.yml
  • AUFRAEUM_CRON in .env.example und im Compose-Dienst
  • deploy/community-scripts/ct/proxledger.sh und install/proxledger-install.sh
  • deploy/community-scripts/README.md mit Voraussetzungen für eine Einreichung
  • README auf den tatsächlichen Stand gebracht (Feldtest erledigt, Einstellungen, Sicherheit)
  • docs/roadmap.md
  • Docker-Stapel vollständig durchgespielt: bauen, starten, migrieren, anmelden, Agent-Skript abrufen

Erkenntnisse zu community-scripts

  • Die Skripte laden ihr Gerüst inzwischen aus einem eigenen Repository
    (community-scripts/core, Datei core/build.func) – nicht mehr aus misc/build.func.
  • Neue Skripte gehören als Pull Request nach ProxmoxVED, nicht nach ProxmoxVE. Direkt eingereichte
    Skripte werden dort ohne Prüfung geschlossen.
  • Die JSON-Metadaten für die Webseite liegen nicht mehr im Skript-Repository.
  • Eine Einreichung setzt öffentlich erreichbaren Quelltext voraus (in aller Regel GitHub). Solange
    ProxLedger im eigenen Gitea liegt, bleiben die Skripte intern; die Quelle lässt sich über
    PROXLEDGER_REPO setzen.

Beim Prüfen gefunden

Der Docker-Stapel wurde vollständig gestartet (bauen, migrieren, anmelden). Dabei zeigte sich: Nach der
Anmeldung wies die Weiterleitung auf http://<container-id>:3000 – die interne Adresse des
Containers. Im Browser hinter einem Reverse Proxy wäre das eine tote Adresse gewesen. Weiterleitungen
nehmen jetzt die eingetragene Adresse, sonst APP_URL, sonst die Kopfzeilen des Reverse Proxy
(src/lib/adresse.ts, vier Tests). Im Stapel gegengeprüft: location: http://localhost:3001/.

Entscheidung

Der eigene deploy/lxc-installer.sh (Container mit Docker darin) bleibt erhalten. Der neue Weg
installiert Node und PostgreSQL direkt in den Container – das ist schlanker und entspricht dem, was
Proxmox-Betreiber von Helper-Scripts erwarten. Beide Wege stehen gleichberechtigt im README.

Quelle: docs/issues/026-auslieferung.md – dort wird dieses Issue gepflegt.

## Ziel Zwei saubere Wege, ProxLedger in Betrieb zu nehmen: als Docker-Stack und als LXC-Container nach Art der Proxmox VE Helper-Scripts. ## Aufgaben - [x] `deploy/update.sh`: sichern, bauen, migrieren, neu starten, Erreichbarkeit prüfen - [x] Zustandsprüfung für den Worker in `docker-compose.yml` - [x] `AUFRAEUM_CRON` in `.env.example` und im Compose-Dienst - [x] `deploy/community-scripts/ct/proxledger.sh` und `install/proxledger-install.sh` - [x] `deploy/community-scripts/README.md` mit Voraussetzungen für eine Einreichung - [x] README auf den tatsächlichen Stand gebracht (Feldtest erledigt, Einstellungen, Sicherheit) - [x] `docs/roadmap.md` - [x] Docker-Stapel vollständig durchgespielt: bauen, starten, migrieren, anmelden, Agent-Skript abrufen ## Erkenntnisse zu community-scripts - Die Skripte laden ihr Gerüst inzwischen aus einem eigenen Repository (`community-scripts/core`, Datei `core/build.func`) – nicht mehr aus `misc/build.func`. - **Neue Skripte gehören als Pull Request nach ProxmoxVED**, nicht nach ProxmoxVE. Direkt eingereichte Skripte werden dort ohne Prüfung geschlossen. - Die JSON-Metadaten für die Webseite liegen nicht mehr im Skript-Repository. - Eine Einreichung setzt öffentlich erreichbaren Quelltext voraus (in aller Regel GitHub). Solange ProxLedger im eigenen Gitea liegt, bleiben die Skripte intern; die Quelle lässt sich über `PROXLEDGER_REPO` setzen. ## Beim Prüfen gefunden Der Docker-Stapel wurde vollständig gestartet (bauen, migrieren, anmelden). Dabei zeigte sich: Nach der Anmeldung wies die Weiterleitung auf `http://<container-id>:3000` – die **interne** Adresse des Containers. Im Browser hinter einem Reverse Proxy wäre das eine tote Adresse gewesen. Weiterleitungen nehmen jetzt die eingetragene Adresse, sonst `APP_URL`, sonst die Kopfzeilen des Reverse Proxy (`src/lib/adresse.ts`, vier Tests). Im Stapel gegengeprüft: `location: http://localhost:3001/`. ## Entscheidung Der eigene `deploy/lxc-installer.sh` (Container **mit Docker darin**) bleibt erhalten. Der neue Weg installiert Node und PostgreSQL direkt in den Container – das ist schlanker und entspricht dem, was Proxmox-Betreiber von Helper-Scripts erwarten. Beide Wege stehen gleichberechtigt im README. --- Quelle: `docs/issues/026-auslieferung.md` – dort wird dieses Issue gepflegt.
florian.wilde added this to the v0.17.0 milestone 2026-09-18 22:11:42 +00:00
florian.wilde added the deploymentdoku labels 2026-09-18 22:11:42 +00:00
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
Clear labels
agent
alerts
api
backend
buchhaltung
bug
chore
datenbank
deployment
docs
doku
export
feldtest
infrastruktur
prototyp
security
sicherheit
test
ui
No labels deployment doku
Milestone
No items
No Milestone v0.17.0
Projects
Clear projects
No projects
Assignees
Clear assignees
florian.wilde (Florian Wilde)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: florian.wilde/ProxLedger#26