Telescope ist ein Bilder-Relay Dienst welcher den Studierenden ermöglicht Fotos mit dem Handy zu machen und diese direkt in Dynexite zu benutzen. Eine Telescope-Instanz kann für beliebig viele Dynexite Instanzen verwendet werden.
Die Bilder werden automatisch so komprimiert, dass sie eine Größe von etwa 300-500kb haben.
Eine SSO-Anbindung ist nötig, um die Studierenden zu identifiezieren.
Das System speichert die Bilder im Arbeitsspeicher zwischen. Dafür kann beim Start eine Puffergröße angegeben werden. Ist der Puffer erschöpft werden die ältestens Bilder verworfen.
Bei einer Abschätzung von 500kB pro Bild reichen 1 GB Puffer also für etwa 2000 Studierende. Es wird zusätzlich eine gute Netzwerkverbindung empfohlen.
Es gibt keine Serverkommunikation. Die Kommunikation findet Clientseitig statt.
/// registry.dynexite.rwth-aachen.de/dynexite/telescope:v2.6
Umgebunsvariablen:
GATEWAY_URL
Desc: Die URL des Backends
Beispiel: "https://api.telescope.demo.dynexite.de"
/// registry.dynexite.rwth-aachen.de/dynexite/telescope-backend:v2.6
Umgebungsvariablen:
APPLICATION_URL
Desc: Die URL des Frontends
Beispiel: "https://telescope.demo.dynexite.de"
CACHE_SIZE
Desc: Die größe des Bilder Puffers
Beispiel: 2 (für 2 GB)
DEBUG (opt)
Desc: Flag, ob mehr Infos ausgegeben werden sollen
Default: 0
HOSTNAME:
Desc: Die URL des eigenen Servers
Beispiel: "https://api.telescope.demo.dynexite.de"
IMAGE_QUALITY
Desc: Die Qualitätsstufe des JPG [0-1]
Default: -
Empfehlung: 0.5
IMAGE_WIDTH_MAX
Desc: Die maximale Bildergröße, wenn transform aktiv ist.
Default: -
Empfehlung: 1920
IMAGE_HEIGHT_MAX:
Desc: Die maximale Bildergröße, wenn transform aktiv ist.
Default: -
Empfehlung: 1024
IGNORE_TRANSFORM: 0
Desc: Beschreibt, ob die Bilder *nicht* verkleinert werden sollen
Default: 0
IGNORE_GREY: 1
Desc: Beschreibt, ob die Bilder *nicht* zu Graustufen umgewandelt werden sollen
Default: 0
Empfehlung: 1
IGNORE_CONVOLUTION: 1
Desc: Beschreibt, ob die Bilder *nicht* überarbeitet werden sollen (sehr CPU aufwändig für alte Smartphones)
Default: 0
Empfehlung: 1
SECRET
Desc: Ein Secret für Sessions, etc.
TOKEN_ISSUERS
Desc: Eine Liste von Dynexite-Instanzen und Secrets, welche die Studierenden automatisch anmelden (s. Anmelde-Logik).
Beispiel: "some-instance-id:21312rwerd23ewd,some-instance-2:123123ejdqwr234r"
(Allgemeine Shibboleth Config)
SHIBBOLETH_ENABLED: 0
SHIBBOLETH_METADATA: ""
SHIBBOLETH_ENTITY_ID: https://my-instance.dynexite.com/
SHIBBOLETH_CONSUMER_SERVICE_URL: https://my-instance.dynexite.com/api/v1/auth/shibboleth/consume
SHIBBOLETH_ALWAYS_RELOAD_METADATA: 0
SHIBBOLETH_METADATA_RELOAD_INTERVAL: 7200
SHIBBOLETH_METADATA_KEY_FILE: '/ssl/private.pem'
SHIBBOLETH_METADATA_CERT_FILE: '/ssl/public.crt'
SHIBBOLETH_URN_IDENTIFIER: 'urn:oid:1.3.6.1.4.1.5540.2.1.5'
SHIBBOLETH_URN_EXTERNAL_ID: 'urn:oid:1.3.6.1.4.1.5923.1.1.1.10'
SHIBBOLETH_BUTTON_LABEL: "My Single Sign-On"
version: '3.4'
services:
telescope-backend:
restart: unless-stopped
image: registry.dynexite.de/dynexite/telescope-backend:v2.6
environment:
ADDRESS: :8080
ALLOWED_ORIGINS: "*"
HOSTNAME: https://my-instance.rwth-aachen.de/api
SECRET: 43t5s5rhz35w6t45rz6546123123123
SHIBBOLETH_ENABLED: 0
SHIBBOLETH_METADATA: ""
SHIBBOLETH_ENTITY_ID: https://my-instance.dynexite.com/
SHIBBOLETH_CONSUMER_SERVICE_URL: https://my-instance.dynexite.com/api/v1/auth/shibboleth/consume
SHIBBOLETH_ALWAYS_RELOAD_METADATA: 0
SHIBBOLETH_METADATA_RELOAD_INTERVAL: 7200
SHIBBOLETH_METADATA_KEY_FILE: '/ssl/private.pem'
SHIBBOLETH_METADATA_CERT_FILE: '/ssl/public.crt'
SHIBBOLETH_URN_IDENTIFIER: 'urn:oid:1.3.6.1.4.1.5540.2.1.5'
SHIBBOLETH_URN_EXTERNAL_ID: 'urn:oid:1.3.6.1.4.1.5923.1.1.1.10'
SHIBBOLETH_BUTTON_LABEL: "My Single Sign-On"
APPLICATION_URL: https://my-instance.dynexite.com
TOKEN_ISSUERS: some-instance-id:21312rwerd23ewd,some-instance-2:123123ejdqwr234r
CACHE_SIZE: 4
IMAGE_QUALITY: 0.5
IMAGE_WIDTH_MAX: 1920
IMAGE_HEIGHT_MAX: 1024
IGNORE_TRANSFORM: 0
IGNORE_GREY: 1
IGNORE_CONVOLUTION: 1
expose:
- 8080
telescope:
restart: unless-stopped
image: registry.dynexite.de/dynexite/telescope:v2.6
environment:
ADDRESS: :8081
GATEWAY_URL: https://my-instance.dynexite.com
expose:
- 8081