LeTTo Doc

Setup-Service: Externes Questionservice

Aufruf im Tab Question-Services der Hauptseite:

Ein externes Question-Service ist ein eigener Container letto-question-<name> mit eigener Mongo-Datenbank, der eine Fragesammlung unabhängig von einer Schule bereitstellt. Dazu gehören die Compose-Datei docker-questionextern-<name>.yml, die Proxy-Konfiguration questionextern-<name>.conf und Einträge in der .env.

Neues externes Questionservice

Neues externes Questionservice

Feld Beschreibung
Name des externen Questionservice Pflichtfeld; wird beim Tippen geprüft – reservierte Namen und Namen, die schon eine Schule oder ein anderes Question-Service verwendet, sind nicht erlaubt. Ergibt die Adresse https://<dns-servername>/<name>
DNS-Servername DNS-Name, unter dem das Question-Service erreichbar ist; dafür wird ein DNS-Eintrag benötigt
Bezeichnung Anzeigename
Speicherlimit Speichergrenze des Containers, z. B. 4G
JAVA_OPTS Java-Optionen, z. B. -Xms100m -Xmx400m
Offenes Service das Question-Service ist offen zugänglich (QUESTION_<n>_OPEN)
Pre-Render Fragen werden im Question-Service vorgerendert (QUESTION_<n>_PRERENDER)
Cache durchgerechnete Fragen werden im Zwischenspeicher abgelegt (QUESTION_<n>_CACHE)
Asynchrones Speichern Fragen werden asynchron (im Hintergrund) gespeichert (QUESTION_<n>_SAVEASYNC)
Externes HTML-Pre-Rendering beim Rendern der HTML-Vorschau (Frage als Bild) wird die externe Adresse verwendet (QUESTION_<n>_HTMLPRERENDER_EXTERN)

erstellen legt Container, Datenbank, Compose-Datei, Proxy-Konfiguration und .env-Einträge an und startet das Service (erst möglich, wenn der Name gültig ist). Zurück in der Kopfzeile kehrt zur Hauptseite zurück (bei ungespeicherten Eingaben mit Rückfrage).

Konfiguration externes Questionservice

Konfiguration externes Questionservice

Buttons

Button Wirkung
Zurück in der Kopfzeile: zurück zur Hauptseite; bei ungespeicherten Änderungen mit Rückfrage
Aktualisieren in der Kopfzeile: Werte neu laden
Speichern am Ende der Seite: Änderungen speichern, Compose-Datei erneuern und das Service neu starten (öffnet die Befehlsausgabe)

Karte Konfiguration externes Questionservice

Link und Zustand des Service, dahinter die Revision.

Button Wirkung
out Log des Containers
EDIT YAML Compose-Datei im Datei-Editor
UPDATE YAML Compose-Datei aus der Vorlage erneuern
Proxy-Konfiguration bearbeiten questionextern-<name>.conf im Editor öffnen
Proxy-Konfiguration aktualisieren Proxy-Konfiguration aus der Vorlage erneuern
Proxy neu starten Proxy neu starten, damit Änderungen wirken
RESTART, STOP, UPDATE Container neu starten, stoppen bzw. aktualisieren

Karte Konfiguration

Wie beim Anlegen, zusätzlich:

Feld Beschreibung
Name des externen Questionservice nicht mehr änderbar
ID in der .yml-Datei Nummer des Service in der .env (nur Anzeige)
Question-URI extern Adresse, unter der das Service erreichbar ist
Mongo-Datenbank Name der eigenen Mongo-Datenbank
Debug-Modus, Debug-Port Remote-Debugging des Containers einschalten und Port festlegen (nur für Entwickler)

löschen entfernt das Question-Service mit allen Daten (mit Rückfrage).

Zurück zur Übersicht: Setup-Service