Empfehlung: SharePoint Architektur für die IT-Dokumentation

Zielsetzung

Aufbau einer zentralen, sicheren und effizienten Wissensdatenbank für die IT-Abteilung zur Speicherung von Konfigurationen (Switch-Configs), Skripten und Dokumentationen.

Empfehlung: SharePoint Team Site (Privat)

Für unsere Anforderungen ist eine klassische SharePoint Team Site die optimale Lösung. Im Vergleich zum „Inhaltscenter“ (Content Center) bietet sie folgende entscheidende Vorteile:

1. Nahtlose Microsoft Teams Integration

Team Site: Erstellt automatisch eine Microsoft 365 Gruppe und ein dediziertes Teams-Team. Dokumente sind direkt über den Reiter „Dateien“ in Teams erreichbar.
Inhaltscenter: Ist ein spezielles Template für Microsoft Syntex (KI-Dokumentenanalyse) und bietet keine direkte, automatisierte Teams-Anbindung.

2. Fokus auf Zusammenarbeit und Dateiverwaltung

Team Site: Optimiert für das tägliche Arbeiten mit Dateien (.txt, .md, .conf, .sh). Unterstützt hervorragend die OneDrive-Synchronisation, was die Bearbeitung mit Tools wie VS Code ermöglicht.
Inhaltscenter: Konzipiert für die Klassifizierung von Dokumenten (z. B. Rechnungsverarbeitung mittels KI). Für reine IT-Dokumentation und Konfigurationsdateien ist dieser Overhead kontraproduktiv.

3. Einfachheit und Wartbarkeit

Team Site: Einfache Rechteverwaltung auf Teamebene. Keine komplexen KI-Modelle oder Syntex-Lizenzen erforderlich.
Inhaltscenter: Erfordert spezifisches Know-how in der Inhaltsmodellierung, was für eine technische Wiki-Struktur unnötig kompliziert ist.

4. Unterstützung technischer Formate

Die Team Site ermöglicht eine schnelle Vorschau und Suche innerhalb von Plain-Text-Dateien (.txt) und Markdown (.md) direkt im Browser, was für Switch-Konfigurationen und Anleitungen essenziell ist.

Umsetzung & Fortschritt (Stand: 16.03.2026)

Das Projekt wurde erfolgreich gestartet und die Basis-Infrastruktur steht bereit.

1. Implementierte Web-Struktur

Der SharePoint wurde als private Team Site unter dem Namen IT Internal Repository erstellt.

Verzeichnisstruktur in der Dokumentenbibliothek (Documents):

01_Infrastructure: Konfigurationen (z. B. Postfix, Switches) und Netzwerkpläne.
02_Software: Installationsdateien, Lizenzschlüssel und Software-Dokumentation.
03_Knowledge_Base: Allgemeine IT-Anleitungen und Knowledge-Base-Artikel (.md).
04_Automation_Scripts: Zentrale Ablage für Python, Bash und PowerShell Skripte.
05_Archive: Veraltete Backups und Protokolle.

Die Startseite wurde als IT Dashboard konfiguriert:

Hero-Bereich: Direkte Verlinkung zu Infrastruktur, Software und Wiki.
Schnelllinks: Schnellzugriff auf alle Hauptverzeichnisse (01-05).
News/Updates: Automatische Anzeige der neuesten SOP-Seiten.

3. Erstellte Dokumentationen (SOPs)

Folgende Standard Operating Procedures (SOPs) wurden bereits auf SharePoint-Seiten sowie lokal als .md Dateien implementiert:

SOP: Automatisierter PDF-Import aus O365 (v2.2)
SOP: Bereinigung alter Datensätze (delete_old_records.py)
SOP: Konfiguration Postfix SMTP Relay (APS-SMTP01)
SOP: Export von Druckprotokollen in MySQL (PowerShell)

4. Integrationen

Microsoft Teams: Die SharePoint-Seite ist mit dem Team Informationstechnologie (Private Gruppe) verbunden.
OneNote: Das gemeinsame Notizbuch (Notizbuch) wurde integriert und lokale Abschnitte erfolgreich migriert.
OneDrive Sync: Die Synchronisation für die Bearbeitung via Windows Explorer und WSL ist vorbereitet.

5. Nächste Schritte

Vollständiger Upload des Software-Archivs via OneDrive.
Integration von Switch-Konfigurationen in 01_Infrastructure.
Erweiterung der Wissensdatenbank durch das IT-Team.

Aktualisiert für das IT-Team – Projekt: Internal Repository

3.9 KiB Raw Permalink Blame History Unescape Escape