aboutsummaryrefslogtreecommitdiffstats

Trace

Remote debugger voor PowerShell-scripts op een vloot servers. Trace vindt draaiende pwsh-scripts via SSH, volgt ze op en legt bij een crash de volledige toestand vast: regel, variabelen, callstack en $Error. Op de servers wordt niets geïnstalleerd.

Status: in ontwikkeling. Alleen de proof of concept in poc/attach werkt: attachen aan een al draaiend script op een andere machine, met tracepoints.

Vereisten

  • Beheermachine: PowerShell 7.4 of hoger, de module powershell-yaml.
  • Servers: PowerShell 7.4 of hoger, en in sshd_config: Subsystem powershell /usr/bin/pwsh -sshs -NoLogo
  • Om te attachen: dezelfde SSH-gebruiker als het script, of root.

Snel aan de slag

  1. Kopieer fleet.example.yml naar fleet.yml en vul je servers in. Een bestaande Ansible-inventaris in YAML werkt ook.
  2. Zet trace_debug: true alleen op servers waar debuggen mag.

Gepland gebruik:

Import-Module ./Trace
Import-TraceServer ./fleet.yml | Test-TraceServer      # is elke server klaar?
Import-TraceServer ./fleet.yml | Find-TraceScript      # welke scripts draaien er?
Get-Help about_Trace                                   # de niveaus van licht tot diep

Cmdlets (gepland)

Cmdlet Wat het doet Niveau
Import-TraceServer Serverlijst inlezen en valideren
Test-TraceServer Controleren of elke server klaar is (pwsh, subsystem, rechten)
Find-TraceScript Draaiende pwsh-scripts vinden
Get-TraceLog Logs ophalen die het script zelf schrijft 0
Start-TraceScript Script starten via de wrapper 1
Set-TraceTracepoint / Remove-TraceTracepoint Tracepoints zetten en weghalen 2
Connect-TraceScript / Disconnect-TraceScript Aanhaken aan een draaiend script en loskoppelen 3
Get-TraceCrashReport Crashrapporten opvragen en tonen

Mappen

fleet.example.yml        voorbeeldserverlijst
docs/architectuur.md     hoe het werkt, met de bevindingen uit de PoC
docs/about_Trace.help.txt  helptopic (komt in de module onder en-US/)
poc/attach/              proof of concept: VM opstarten en een draaiend script debuggen

Proof of concept

cd poc/attach
./up.sh              # Debian-VM met pwsh en een draaiend hello.ps1
pwsh ./debug.ps1     # attachen, tracepoints, resultaat op de beheermachine
./down.sh            # VM stoppen

Zie poc/attach/README.md voor de uitvoer en de beperkingen.