diff --git a/BEDIENUNGSANLEITUNG.md b/BEDIENUNGSANLEITUNG.md index 23e06fb..3a0563e 100644 --- a/BEDIENUNGSANLEITUNG.md +++ b/BEDIENUNGSANLEITUNG.md @@ -155,16 +155,20 @@ Ergebnis erscheint direkt im Terminal. Der vollständige Report liegt in `report ### Automatischer Scan (Cron) ```bash -# Cron-Eintrag hinzufügen crontab -e ``` -Eintrag: +Je eine Zeile pro überwachter Website einfügen (mit leichtem Zeitversatz): ```cron -# Website-Scan täglich um 03:00 Uhr -0 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten/venv/bin/python -m scanner scan >> logs/cron.log 2>&1 +# bredelar.info — täglich 03:00 Uhr +0 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config bredelar.info/config.yaml scan >> bredelar.info/logs/cron.log 2>&1 + +# jamulix.de — täglich 03:15 Uhr +15 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config jamulix.de/config.yaml scan >> jamulix.de/logs/cron.log 2>&1 ``` +Danach prüfen: `crontab -l` + Der Exit-Code (0/1/2) ist für Cron-basierte Alarmierung nutzbar (z.B. mit `cronitor` oder systemd-Timern mit `OnFailure=`). @@ -334,29 +338,47 @@ Der Score ist ≥ 60. Typische Auslöser: neue externe Domain (50 Pkt.) + Hidden ## 10. Automatisierung per Cron-Job -### Cron-Eintrag +### Cron-Einträge einrichten ```bash crontab -e ``` +Je eine Zeile pro überwachter Website einfügen — mit leichtem Zeitversatz, +damit die Scans nicht gleichzeitig laufen: + ```cron -# Website-Scan täglich um 03:00 Uhr -0 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten/venv/bin/python -m scanner scan >> logs/cron.log 2>&1 +# bredelar.info — täglich 03:00 Uhr +0 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config bredelar.info/config.yaml scan >> bredelar.info/logs/cron.log 2>&1 + +# jamulix.de — täglich 03:15 Uhr +15 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config jamulix.de/config.yaml scan >> jamulix.de/logs/cron.log 2>&1 ``` +Danach prüfen ob die Einträge gespeichert wurden: +```bash +crontab -l +``` + +**Neue Website hinzufügen:** +1. Verzeichnis anlegen: `mkdir neue-seite.de` +2. Config kopieren: `cp bredelar.info/config.yaml neue-seite.de/config.yaml` +3. In der neuen config.yaml `target` und alle 4 Pfade (`data_dir`, `reports_dir`, `logs_dir`, `config_dir`) anpassen +4. Erste Prüfung: `python -m scanner --config neue-seite.de/config.yaml init` +5. Weiteren Cron-Eintrag ergänzen (z.B. 03:30 Uhr) + ### Log prüfen ```bash -tail -50 logs/cron.log -tail -f logs/scanner.log # detaillierteres Log des Scanners selbst +tail -50 bredelar.info/logs/cron.log +tail -50 jamulix.de/logs/cron.log ``` ### Log-Rotation (optional) Datei `/etc/logrotate.d/integrity-scanner`: ``` -/home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten/logs/*.log { +/home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten/*/logs/*.log { daily rotate 30 compress diff --git a/README.md b/README.md index b831bb2..bdda861 100644 --- a/README.md +++ b/README.md @@ -119,14 +119,35 @@ python -m scanner approve --rebuild --note "Komplettes Redesign, alle Seiten neu ## Cron-Setup +Einrichten mit `crontab -e`, folgende Zeilen einfügen — je eine pro überwachter Website, +mit leichtem Zeitversatz damit die Scans nicht gleichzeitig laufen: + ```cron -# Täglich 03:00 Uhr -0 3 * * * cd /opt/scanner && /opt/scanner/venv/bin/python -m scanner scan >> /opt/scanner/logs/cron.log 2>&1 +# Täglich 03:00 — bredelar.info +0 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config bredelar.info/config.yaml scan >> bredelar.info/logs/cron.log 2>&1 + +# Täglich 03:15 — jamulix.de +15 3 * * * cd /home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten && python -m scanner --config jamulix.de/config.yaml scan >> jamulix.de/logs/cron.log 2>&1 +``` + +**Wichtig:** Der `cd`-Befehl ist nötig, damit `python -m scanner` das Paket findet. +Das Log landet je Site in `/logs/cron.log`. + +Nach dem Einrichten prüfen: `crontab -l` + +### Neue Website hinzufügen + +```bash +mkdir neue-seite.de +cp bredelar.info/config.yaml neue-seite.de/config.yaml +# target + alle 4 Pfade (data_dir/reports_dir/logs_dir/config_dir) anpassen +python -m scanner --config neue-seite.de/config.yaml init +# Dann einen weiteren Cron-Eintrag ergänzen ``` Log-Rotation (`/etc/logrotate.d/scanner`): ``` -/opt/scanner/logs/*.log { +/home/dschlueter/Python_Programs/integrity_scanner_fuer_statische_Webseiten/*/logs/*.log { daily rotate 30 compress