git_issue_importer/README.WIN.md
2025-03-10 18:06:17 +01:00

3.3 KiB

Einrichtung einer geplanten Aufgabe in Windows für automatische Updates

Um das Forgejo-to-Markdown Update-Skript regelmäßig automatisch auszuführen, kannst du den Windows Task Scheduler (Aufgabenplanung) verwenden. Hier ist eine Schritt-für-Schritt-Anleitung:

Vorbereitung

  1. Speichere die beiden Skripte in einem Ordner deiner Wahl:

    • forgejo_exporter.py (Python-Skript)
    • update_forgejo.bat (Batch-Skript)
    • .env
  2. Stelle sicher, dass Python installiert ist und der python-Befehl im Pfad verfügbar ist

Erstellen einer geplanten Aufgabe

  1. Öffne die Aufgabenplanung:

    • Drücke Win + R, gib taskschd.msc ein und drücke Enter
    • Oder suche im Startmenü nach "Aufgabenplanung"
  2. Klicke im rechten Bereich auf Aufgabe erstellen...

  3. Im Tab Allgemein:

    • Gib einen Namen ein (z.B. "Forgejo Issues Update")
    • Optional: Füge eine Beschreibung hinzu
    • Wähle Mit höchsten Privilegien ausführen (falls dein Benutzer über Administratorrechte verfügt)
    • Wähle unter "Konfigurieren für:" dein Betriebssystem
  4. Im Tab Trigger:

    • Klicke auf Neu...
    • Wähle unter "Beginnen" die Option Nach einem Zeitplan
    • Stelle die Häufigkeit ein (z.B. Täglich um 3:00 Uhr)
    • Aktiviere Aktiviert
    • Klicke auf OK
  5. Im Tab Aktionen:

    • Klicke auf Neu...
    • Aktion: Programm starten
    • Programm/Skript: Gib den vollständigen Pfad zu update_forgejo.bat ein oder klicke auf Durchsuchen... um die Datei auszuwählen
    • Starten in: Gib den Ordner ein, in dem sich das Skript befindet
    • Klicke auf OK
  6. Im Tab Bedingungen:

    • Du kannst hier optionale Einstellungen vornehmen, z.B. nur ausführen, wenn der Computer am Netzwerk angeschlossen ist
  7. Im Tab Einstellungen:

    • Wähle Aufgabe so bald wie möglich nach einem verpassten Start ausführen
    • Wähle Bei Bedarf aufwecken
    • Klicke auf OK, um die Aufgabe zu erstellen

Testen der geplanten Aufgabe

  1. Finde deine neu erstellte Aufgabe in der Liste
  2. Rechtsklick auf die Aufgabe und wähle Ausführen
  3. Überprüfe, ob die Aufgabe erfolgreich ausgeführt wurde:
    • Prüfe das Logfile (forgejo_update.log)
    • Überprüfe, ob neue Dateien im Ausgabeordner erstellt wurden

Fehlerbehebung

Falls die geplante Aufgabe nicht wie erwartet funktioniert:

  1. Problem: Die Aufgabe wird gestartet, aber Python-Fehler treten auf

    • Lösung: Überprüfe, ob alle erforderlichen Python-Pakete installiert sind (pip install requests)
  2. Problem: Die Aufgabe wird gar nicht ausgeführt

    • Lösung: Überprüfe die Ereignisanzeige (Event Viewer) auf Fehler
  3. Problem: Das Skript kann nicht auf die Ausgabeordner zugreifen

    • Lösung: Stelle sicher, dass der Benutzer, unter dem die Aufgabe ausgeführt wird, Schreibrechte für den Zielordner hat
  4. Problem: Das Batch-Skript wird nicht gefunden

    • Lösung: Verwende absolute Pfade im Task Scheduler anstelle von relativen Pfaden

Alternative: Ausführen beim Windows-Start

Wenn du möchtest, dass das Skript bei jedem Windows-Start ausgeführt wird:

  1. Erstelle eine Verknüpfung zu update_forgejo.bat
  2. Drücke Win + R, gib shell:startup ein und drücke Enter
  3. Kopiere die Verknüpfung in den geöffneten Ordner

Dies führt das Skript jedes Mal aus, wenn du dich bei Windows anmeldest.