Die hier als Beispiel genannten Versionen sind nicht immer die aktuellen! Bitte schauen sie im Zweifel in die Tags oder den Release RSS Feed (nicht öffentlich verfügbar).
¶ Versionen und Tags
Um das Deployment von Dynexite zu erleichtern, werden die Applikationen als Docker-Container zur Verfügung gestellt.
Es gibt nun eine
| Name | Beschreibung | Produktiv nutzen? |
|---|---|---|
| #version# | entspricht einer bestimmten Version - z.B. v3.1.x, v3.1, v3 |
Ja |
| stable | entspricht der letzten stabilen Version | Nein |
| latest | ist die aktuelle Entwicklerversion. | Nein |
Im Allgemeinem ist z.B.
v3.1am sinnvollsten, um die neusten Patches zu erhalten.
¶ Passende Versionen der Hilfsdienste
Welche Version der Dienst zu welchem
¶ Registry
Wir stellen über registry.dynexite.rwth-aachen.de eine zentrale Registry bereit mit welcher Sie die Images bei sich installieren können.
Bitte kontaktieren Sie uns, wenn sie Zugang zu den Images erhalten möchten.
Um diese zu nutzen, müssen Sie sich dort anmelden
docker login registry.dynexite.rwth-aachen.de
im Anschluss können Sie die Images entweder direkt herunterladen (z.B.) (**)
docker pull registry.dynexite.rwth-aachen.de/dynexite/orbit-teacher-backend:3.1
oder über ihr Orchestrierungstool nutzen.
¶ Anleitungen
¶ Installation über die Deployment Skripte
Das Repository befindet sich noch in einer Testphase und könnte sich etwas abändern!
Mit Version 3.1 wurde von ein Git-Repository angelegt, um Dynexite schnell und alle Hilfs- und Korrekturdienste schnell un einfach installieren zu können.
Bitte folgen sie dafür den Anweisungen in der README des Git-Repositories: https://git.rwth-aachen.de/medien-public/dynexite-deploy . Es wird eine nginx-proxy Installation und docker compose > v2.20 benötigt.
¶ Funktionsbeispiel:
Es muss das passende Set von .env undm docker-compose.yml für die gewünschte Applikation kopiert werden. Dann müssen noch die Umgebungsvariablen gesetzt werden.
$ git clone https://git.rwth-aachen.de/medien-public/dynexite-deploy.git
$ git checkout v3.1
# Docker-Compose für die gewünschte Applikation kopieren und ggf. anpassen.
$ cp docker-compose.yml.orbit docker.compose.yml
# Datei mit Variablen kopieren und anpassen
$ cp .env.orbit .env
$ nano .env
$ docker compose up -d
Updates sind durch die von uns vorgegeben Versionen sehr einfach:
$ git pull
# Mögliche Änderungen in der `.env` Datei beachten.
$ docker compose pull
$ docker compose up -d
¶ Installation der Applikationen
In Arbeit!
Sowohl der Orbit, als auch der Satellite, benötigt eine funktionierende Mysql- oder MariaDB-Instanz .
¶ Korrekturdienste
¶ Installation der Korrekturdienste
Die Korrekturdienst werden - anders als die Hilfsdienste - nicht direkt beim Start eingetragen. Sie müssen diese nach einer Installation oder Upgrader von v3.1 über das Admin-Menu hinzugefügt werden. Am besten nutzen Sie dafür die Dienste Funktion "Konfiguration laden".
Wenn sie das Deployment Skript genutzt haben, dann stehen ihnen folgende Dienste zur Verfügung:
- Python 3 CAS
http://python-cas-grader - Python 3 Unit Tests
http://python-unit-grader
Bei eigener Installation müssen die URLs entsprechend angepasst werden. Der Server lädt dann die entsprechende Konfiguration von dem Korrekturdienst (Muss als '/info' vom Korrekturdienst bereitgestellt werden).
¶ Anpassen der Konfiguration
Die Konfiguration kann zwar manuell angepasst werden, ist aber nur für fortgeschrittene Benutzer empfohlen.