From 04e1455d9f755676b9603e8a6e5280588df3343f Mon Sep 17 00:00:00 2001 From: Frank Schwenk Date: Thu, 11 Jun 2026 22:44:38 +0200 Subject: [PATCH] docs: add Plesk admin notes and GoAccess web stats Document Git/Composer capabilities, hosting settings, and backlog todo 10; record switch from AWStats to GoAccess. Co-authored-by: Cursor --- HOSTING.md | 2 + PLESK.md | 94 ++++++++++++++++++++++++++ README.md | 2 +- todo/10-optional-plesk-git-composer.md | 36 ++++++++++ todo/README.md | 5 ++ 5 files changed, 138 insertions(+), 1 deletion(-) create mode 100644 PLESK.md create mode 100644 todo/10-optional-plesk-git-composer.md diff --git a/HOSTING.md b/HOSTING.md index d65dae3..db64e24 100644 --- a/HOSTING.md +++ b/HOSTING.md @@ -95,6 +95,8 @@ Plesk: **Websites & Domains → Geplante Aufgaben → Aufgabe planen** Screenshot-Referenz: Plesk „Aufgabe planen“ (PHP-Skript, Cron-Stil, PHP-Version). +Weitere Plesk-Funktionen (Git, Composer, Hosting-Einstellungen): [`PLESK.md`](PLESK.md) + ## Beziehung zu boka ``` diff --git a/PLESK.md b/PLESK.md new file mode 100644 index 0000000..e97ce15 --- /dev/null +++ b/PLESK.md @@ -0,0 +1,94 @@ +# Plesk — Admin-Notizen + +Entdeckte Funktionen und Einstellungen im Plesk-Adminbereich für `0012.de`. +Stand: 2026-06-11. Kein unmittelbarer Umsetzungsbedarf — Referenz für spätere Entscheidungen. + +Siehe auch: [`HOSTING.md`](HOSTING.md) + +--- + +## Git-Repositorys + +Plesk: **Websites & Domains → 0012.de → Git-Repositorys** + +Zwei Modelle: + +| Modell | Ablauf | Wann sinnvoll | +|--------|--------|---------------| +| **Remote-Repository** | Code bei GitHub/GitLab/Bitbucket oder eigenem Git-Server; Plesk **pullt** | CI/CD-light: Push ins Remote → Plesk holt bei Deploy | +| **Lokales Repository** | Code auf Laptop o. ä.; du **pushst** auf Plesk-Git-Endpoint | Kein öffentliches Remote nötig; Plesk als Git-Remote | + +### Aktueller Stand im Projekt + +Deploy läuft über **`scripts/deploy.sh`** (FTPS): + +- `public/` → `httpdocs/` +- `config/` + `.env` → `private/` (manuell mit deploy.py, `.env` nie im Git) + +### Wenn Git in Plesk genutzt wird (später) + +- Repo-Root in Plesk ≠ Document Root — **Deploy-Aktion** oder Post-Receive-Hook nötig, um nur `public/` nach `httpdocs/` zu spiegeln +- `.env` bleibt **außerhalb Git** (Plesk-Geheimnisse oder weiter manuell nach `private/.env`) +- Remote-Variante passt gut zu **GitLab** (dieses Repo), wenn Remote-URL + Deploy-Key/Token in Plesk hinterlegt werden +- Entscheidung offen: FTPS beibehalten (einfach, funktioniert) vs. Plesk-Git (weniger manuell, mehr Plesk-Konfiguration) + +--- + +## PHP Composer + +Plesk: **Websites & Domains → 0012.de → PHP Composer** + +- Sucht `composer.json` im **Stammverzeichnis des Abonnements** (`/`, nicht nur `httpdocs/`) +- Button „Suchen“ findet Anwendung und erlaubt `composer install` aus dem Panel + +### Aktueller Stand + +- **Keine** `composer.json` im Projekt — bewusst schlanke Plain-PHP-Lösung (Monitoring, Landing) +- Sinnvoll erst bei echten Abhängigkeiten, z. B.: + - PHPMailer für SMTP + - HTTP-Client-Bibliothek +- Dann: `composer.json` im Repo-Root, `vendor/` in `.gitignore`, nach Deploy `composer install` (lokal, per SSH falls verfügbar, oder Plesk Composer UI) + +--- + +## Hosting-Einstellungen (Screenshot) + +Plesk: **Hosting-Einstellungen** (bzw. Hosting & DNS → Hosting-Einstellungen) + +### Webstatistiken + +| Einstellung | Aktuell | Optionen | +|-------------|---------|----------| +| Tool | **GoAccess** | Deaktiviert, AWStats (Veraltet), Webalizer | +| Zugriffsschutz | **an** — FTP-User/Passwort | — | + +Stand 2026-06-11: von AWStats auf GoAccess umgestellt. + +**Notiz:** GoAccess liefert moderne Traffic-Auswertung im Panel. Für Monitoring der *eigenen* Dienste (boka, schwenk.online, …) irrelevant — das macht `monitor.php`. + +### Web-Scripting + +| Feature | Aktuell | Relevanz für 0012.de | +|---------|---------|----------------------| +| FastCGI | aus | PHP läuft über Plesk-PHP-Handler (FPM); Toggle meist legacy | +| CGI | aus | nicht benötigt | +| SSI | **an** | nicht nötig für reines PHP; harmlos | +| Benutzerdefinierte Fehlerdokumente | **an** | später eigene 404/50x in `httpdocs/error_docs/` möglich | + +Keine Änderung empfohlen, solange PHP-Seiten normal laufen. + +--- + +## Plesk-Pfade (Referenz) + +| Pfad | Inhalt | +|------|--------| +| `httpdocs/` | Document Root (öffentlich) | +| `private/` | Nicht öffentlich — `.env`, `config/`, `data/` | +| `/` (Abonnement-Root) | Root für Composer-Suche, Git-Checkout je nach Konfiguration | + +--- + +## Backlog + +Optionale spätere Aufgabe: [`todo/10-optional-plesk-git-composer.md`](todo/10-optional-plesk-git-composer.md) diff --git a/README.md b/README.md index 840bb23..b03dffe 100644 --- a/README.md +++ b/README.md @@ -19,7 +19,7 @@ Dieser Webspace ist bewusst **unabhängig vom vServer `boka`** (Webtropia Cloud - **Paket:** Classic 1.0 / 15 GB, Traffic unlimitiert ([Produktseite](https://wint.global/linux-hosting-pakete-plesk/)) - **Domain:** `0012.de` - **Panel:** Plesk auf `ha01s019.org-dns.com` -- **Details:** [`HOSTING.md`](HOSTING.md) +- **Details:** [`HOSTING.md`](HOSTING.md), Plesk-Notizen: [`PLESK.md`](PLESK.md) Zugangsdaten gehören in `.env` (Vorlage: [`.env.example`](.env.example)). **Niemals committen.** diff --git a/todo/10-optional-plesk-git-composer.md b/todo/10-optional-plesk-git-composer.md new file mode 100644 index 0000000..14b3868 --- /dev/null +++ b/todo/10-optional-plesk-git-composer.md @@ -0,0 +1,36 @@ +# 10 — Optional: Plesk Git & Composer + +**Priorität:** backlog (optional) +**Status:** notiert, nicht geplant +**Abhängigkeiten:** keiner +**Referenz:** [`../PLESK.md`](../PLESK.md) + +## Ziel + +Evaluieren, ob FTPS-Deploy durch Plesk-Git oder Composer im Panel ergänzt/ersetzt werden soll. + +## Auslöser + +Im Plesk-Admin entdeckt: + +- **Git-Repositorys** — Remote-Pull (GitLab/GitHub) oder Local-Push auf Plesk +- **PHP Composer** — sucht `composer.json` im Abonnement-Root + +Aktuell ausreichend: `scripts/deploy.sh` (FTPS). + +## Entscheidungspunkte + +- [ ] Remote-GitLab in Plesk verknüpfen vs. FTPS beibehalten? +- [ ] Post-Deploy-Hook: `public/` → `httpdocs/`, Secrets nach `private/`? +- [ ] `composer.json` einführen (z. B. PHPMailer) — ja/nein? +- [x] Webstatistiken: AWStats → GoAccess (2026-06-11) + +## Akzeptanzkriterien (falls umgesetzt) + +- Deploy ohne manuelles FTPS nach `git push` +- `.env` weiterhin nicht im Repository +- Dokumentation in README/PLESK.md aktualisiert + +## Nicht jetzt + +Kein Blocker für Todo 02–09. Erst prüfen, wenn Monitoring stabil läuft oder Composer-Deps anstehen. diff --git a/todo/README.md b/todo/README.md index 1420108..3c9b5c3 100644 --- a/todo/README.md +++ b/todo/README.md @@ -13,6 +13,11 @@ Nummerierte Todos für den 0012.de-Webspace. Abhängigkeiten beachten. | 07 | [07-mail-domains-external.md](07-mail-domains-external.md) | **medium** | MX für Domains ohne Mailserver | | 08 | [08-monitoring-phase2.md](08-monitoring-phase2.md) | **medium** | API-Health, Latenz, Backup-Heartbeat | | 09 | [09-monitoring-phase3.md](09-monitoring-phase3.md) | **low** | Rest-Domains, Dashboard, Header-Checks | +| 10 | [10-optional-plesk-git-composer.md](10-optional-plesk-git-composer.md) | backlog | Plesk Git / Composer evaluieren | + +## Backlog (ohne Priorität) + +Todo **10** — Plesk Git-Deploy und Composer; dokumentiert in [`../PLESK.md`](../PLESK.md), kein Blocker für 02–09. ## Empfohlene Reihenfolge