Installation
Quelle: pkr-lab/pkr-lab-docs/DocFlowEngine/installation.md
Installation
Voraussetzungen
- PowerShell 7+ oder Windows PowerShell 5.1 (bereits auf jedem Windows vorinstalliert) – beide werden gleichwertig unterstützt, keine Installation und keine Admin-Rechte nötig
- Unterstützte Plattformen: Windows, macOS, Linux (PowerShell 7+); Windows PowerShell 5.1 nur unter Windows
- Keine externen Module nötig: Die Konfiguration liegt als PowerShell-Data-Datei (
.psd1) vor und wird mit dem eingebautenImport-PowerShellDataFilegelesen (verfügbar seit PowerShell 5.0) – dadurch funktioniert alles rein mit Bordmitteln, ganz ohneInstall-Module
PowerShell installieren (nur für macOS/Linux nötig - optional)
Auf dem eigentlichen Zielsystem (Windows-Schulrechner) ist nichts zu installieren:
Windows PowerShell 5.1 ist auf jedem Windows bereits vorhanden, DocFlowEngine läuft
damit ohne jeden zusätzlichen Schritt. Die folgenden Befehle sind nur für alle, die
DocFlowEngine testweise unter macOS/Linux ausführen möchten (z. B. Entwicklung) -
PowerShell 5.1 selbst existiert dort nicht, PowerShell 7+ ist der Ersatz.
# macOS mit Homebrew (kein sudo nötig)
brew install powershell
# Linux (Ubuntu/Debian) - benötigt sudo/Admin-Rechte für die Paketinstallation;
# alternativ ganz ohne Admin-Rechte über das offizielle .tar.gz-Archiv
# (https://github.com/PowerShell/PowerShell/releases) in ein Benutzerverzeichnis entpacken
sudo apt-get install -y powershell
Setup
git clone https://github.com/pkr-lab/DocFlowEngine.git
cd DocFlowEngine
Erster Lauf
- Passe die Konfiguration in
config/docflow-config.psd1an. Pfade werden nur ganz oben im Blockpathsgeändert, alle anderen Einträge verweisen per{name}darauf (siehe DocFlowEngine/konfiguration.md). - Führe das Skript im DryRun-Modus aus, um die geplanten Aktionen zu prüfen:
pwsh -NoProfile -ExecutionPolicy Bypass -File ./scripts/DocFlowEngine.ps1 -DryRun # oder mit Windows PowerShell 5.1: powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\DocFlowEngine.ps1 -DryRun - Wenn alles passt, führe es ohne
-DryRunaus:pwsh -NoProfile -ExecutionPolicy Bypass -File ./scripts/DocFlowEngine.ps1 # oder mit Windows PowerShell 5.1: powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\DocFlowEngine.ps1
Fehlersuche
| Symptom | Ursache | Lösung |
|---|---|---|
Teilmodul '…' wurde nicht gefunden. |
Checkout unvollständig | Repo vollständig auschecken |
pwsh: command not found |
PowerShell 7 fehlt | powershell.exe (5.1) nutzen oder PowerShell 7 installieren, beide funktionieren (Kompatibilität) |
| Skript wird blockiert | Execution Policy | -ExecutionPolicy Bypass (nur für den Prozess) |
Weitere Fälle: Debugging und Fehlersuche.