Ehrlich gesagt: Wer schon einmal versucht hat, die genauen SAML-Konfigurationsschritte mit einer AWS Private CA zu finden oder eine bestimmte Portnummer aufzuspüren, die tief im Admin Guide vergraben ist, kennt den Frust. Die Parallels-Dokumentation ist auf docs.parallels.com und kb.parallels.com verteilt, und die integrierte Suche reicht nicht immer aus.
Also habe ich search.rasinsider.com gebaut — eine eigene Volltextsuchmaschine für die Parallels-RAS-Dokumentation.
Was indexiert ist
Zum Start deckt die Suchmaschine zwei Quellen ab:
- Den vollständigen Admin Guide zu Parallels RAS 21 — 492 Seiten, gecrawlt von docs.parallels.com, jede Seite als eigenes Dokument mit Titel, Inhalt und direkter URL gespeichert.
- Die KB-Artikel zu Parallels RAS von kb.parallels.com, gefiltert auf RAS-relevante Inhalte (Release Notes, Firewall-Anforderungen, Upgrade-Anleitungen, Lifecycle, Systemanforderungen und mehr).
Der Index wird jede Nacht automatisch über einen geplanten Cronjob aktualisiert.
Der Stack
Die Suchmaschine läuft auf einer eigenen Ubuntu-VM in meinem Homelab und ist über einen Cloudflare Tunnel erreichbar. Keine Cloud-Abhängigkeit, kein externes Abonnement.
Das Herzstück ist Meilisearch — eine in Rust geschriebene Open-Source-Suchmaschine, extrem schnell (Antwortzeiten unter 10 ms bei diesem Datenbestand), mit eingebauter Tippfehlertoleranz und Hervorhebung der Treffer. Zwei Python-Crawler laufen jede Nacht: einer für den Admin Guide, einer für die KB-Artikel. Sie erkennen neue oder geänderte Inhalte und aktualisieren den Index inkrementell.
So wird sie verwendet
Rufen Sie search.rasinsider.com auf. Geben Sie einen beliebigen Begriff ein — SAML, HALB, FSLogix, Load Balancing, Zertifikat, Gateway — und die Ergebnisse erscheinen in Echtzeit, mit hervorgehobenen Auszügen und dem vollständigen Navigationspfad innerhalb der Dokumentation. Sie können 10, 25 oder 50 Ergebnisse pro Seite anzeigen, mit vollständiger Seitennavigation.
Die Website ist vollständig responsiv und funktioniert auch auf dem Smartphone.
Wie es weitergeht
Der PowerShell Guide wird die nächste indexierte Quelle. Außerdem arbeite ich an einer interaktiven RAS-Firewall-Flussmatrix als eigenständiges Tool auf RASInsider — mehr dazu bald.
