Eine Mirket-Installation betreiben
Die je Organisation isolierte Laufzeit, die Konfigurationsgrenze, die Health-Checks und die Erwartungen an die Wiederherstellung verstehen.
- Für
- Betrieb
- Lesezeit
- 11 Min.
- Aktualisiert
- 22. Oktober 2026

Bevor Sie beginnen
- Shell-Zugang zum Host der Installation, das ausgecheckte unveränderliche Release und die Umgebungsdatei der Installation.
- Zugang zu den Dienstprotokollen, zum Sicherungsziel und zu einer geschützten Datei mit der Passphrase.
Fertig sind Sie, wenn
- docker compose --env-file .env -f compose.yml ps meldet, dass die erwarteten Dienste laufen und die Dienste mit Health-Check als fehlerfrei gelten.
- Die Prüfungen /health/live und /health/ready von API und Socket-Dienst antworten erfolgreich.
- Die neueste verschlüsselte Sicherung hat die Wiederherstellungsübung des Repositorys bestanden.
- Jedes optionale Dienstprofil entspricht seinem Anwendungsflag; reine Flag-Module und die Aktivierung durch die Organisation werden getrennt geprüft.
Wenn etwas schiefgeht
- Überschreiben Sie keine fehlgeschlagene Bereitstellung oder Sicherung. Bewahren Sie Protokolle, den genauen Release-Digest, den Umgebungspfad und die Befehlsausgabe.
- Stellen Sie nur aus einem geprüften verschlüsselten Archiv wieder her und halten Sie das von Ihrer Organisation vereinbarte Wiederherstellungsfenster und Betriebshandbuch ein.
- Fällt ein optionaler Dienst aus, erhalten Sie das Basis-LMS und prüfen Bereitschaft, Zugangsdaten, Origin und Protokolle dieses Dienstes, bevor Sie ihn neu starten. Kopieren Sie niemals Zugriffstoken, Anfrage-Header, E-Mail-Adressen oder Angaben zu Kindern in Diagnosedaten.
Die Grenze des Deployments kennen
- Eine Installation dient einer Organisation.
- Anwendungsprozesse, PostgreSQL, Redis und Objektspeicher-Namensräume sind zwischen Organisationen isoliert.
- Die Kundenkonfiguration wird zur Laufzeit eingebunden statt fest in unveränderliche Anwendungsartefakte eingebaut.
Auf eine Betriebsmeldung reagieren
Prüfen Sie die Konfiguration, bevor Sie den Zustand ändern
Führen Sie docker compose --env-file .env -f compose.yml config --quiet aus und sehen Sie sich dann docker compose --env-file .env -f compose.yml ps sowie die Live- und Ready-Endpunkte von API und Socket-Dienst an.
Bestimmen Sie den betroffenen Dienst und das Zeitfenster
Erfassen Sie Anwendung, Rolle, Route, Zeitstempel, den sichtbaren Wiederherstellungszustand und die einschlägigen Protokolle, ohne unnötige Nutzerinhalte anzufordern.
Nutzen Sie die Sicherungsbefehle des Repositorys
Führen Sie pnpm ops:check aus und erstellen Sie dann mit pnpm ops:backup die koordinierte verschlüsselte Sicherung mit ausdrücklichen absoluten Pfaden für Umgebung, Ausgabe und Passphrase-Datei.
Weisen Sie die Wiederherstellbarkeit nach
Führen Sie pnpm ops:restore-drill gegen das erzeugte Archiv mit denselben ausdrücklichen Passphrase- und Umgebungsangaben aus. Der Abschluss verlangt geprüfte Prüfsummen und erfolgreiche Wegwerf-Wiederherstellungen von PostgreSQL.
Stellen Sie mit umkehrbaren Schritten wieder her
Bevorzugen Sie dokumentierte Neustarts, Wiederholungen und geprüfte Wiederherstellungen. Sichern Sie Belege und erstellen Sie vor Upgrades oder Eingriffen ins Schema eine geprüfte Sicherung.
Optionale Module ausdrücklich wählen
Dienstgestützte Module benötigen sowohl ihr Compose-Profil als auch das passende Anwendungsflag. Zertifizierung, akademische Integrität und institutionelle Adapter nutzen private Konfiguration ohne eigenes Compose-Profil. Führen Sie vor dem Start config --quiet aus und prüfen Sie die Bereitschaft jedes Moduls, bevor Sie es für eine Organisation aktivieren.
- Der Elternzugang verwendet das Profil parents mit PARENT_MODULE_ENABLED=true. Die Administration muss weiterhin „Elternportal aktivieren“ wählen; die Wiederherstellung der betrieblichen Verfügbarkeit aktiviert diese Organisationseinstellung nie erneut.
- Chat verwendet das Profil chat mit CHAT_ENABLED=true. Bei einem Matrix-Ausfall müssen die LMS-Anmeldung und Arbeiten außerhalb des Chats verfügbar bleiben, während Chat eine Rückmeldung zur Wiederherstellung zeigt.
- Die Dokumentbearbeitung verwendet das Profil documents mit ONLYOFFICE_ENABLED=true. Bei einem Ausfall müssen geschützte Kursdateien und ihr Originaldownload erhalten bleiben, während der Arbeitsbereich „Erneut versuchen“ anbietet.
- Live-Konferenzen verwenden das Profil live mit LIVEKIT_ENABLED=true. Ein Zulassungs- oder Dienstfehler muss den Konferenzzugang sperren, ohne aktuelle Konto-, Rollen-, Kurs- oder Terminprüfungen abzuschwächen.
- Die Zertifizierung nutzt den privaten Schalter CERTIFICATION_MODULE_ENABLED=true ohne Compose-Profil. Der Administrator muss zusätzlich Zertifizierung aktivieren wählen; die Wiederherstellung der Verfügbarkeit durch den Betreiber aktiviert sie nicht erneut.
- Akademische Integrität benötigt ACADEMIC_INTEGRITY_ENABLED=true, einen ausdrücklich gewählten Anbietermodus und Zugangsdaten sowie eine getrennte Aktivierung durch den Administrator und die Zustimmung der Lehrkraft zur Aufgabe. Ein Sandbox-Modus dient Entwicklung und Tests, nicht Entscheidungen über Kunden.
- Institutionelle Anmelde-, Kurslisten- und Cloud-Datei-Adapter verwenden getrennte private Anbieterkonfiguration. Ist ein Adapter deaktiviert, müssen lokale Anmeldung, manuelle Kontoerstellung und normaler Kursdatei-Upload verfügbar bleiben.
Weiter mit
Personen, Kurse, Kommunikation und betriebliche Einsicht führen und dabei die Grenzen von Organisation und Rolle wahren.
Sich in Mirket zurechtfindenRollenanwendungen, Navigation, Einstellungen und die Grenzen verstehen, die bestimmen, was Sie sehen können.
Akademische Informationen eines Kindes verfolgenPrüfen Sie in der Eltern-Anwendung autorisierte Arbeiten, freigegebene Noten, von Lehrenden bestätigte Anwesenheit und Benachrichtigungseinstellungen für jedes verknüpfte Kind.