Virtual Device Pool Manager

Diplomarbeit von Marco Rensch

NDS HF Applikationsentwickler 2023

Git Repository zu meiner Diplomarbeit "Virtual Device Pool Manager" als Applikationsentwickler NDS HF 2023

Inhaltsverzeichnis

• Installation
• Konfiguration
• Hinweis zur Verwendung von SSL
  • Self-Signed Zertifikat akzeptieren
• Benutzung (Entwicklungsmodus)
• Build (Produktionsumgebung)
• Benutzung (Produktionsumgebung)
• Entwickler
• Lizenz

Voraussetzungen

Die Applikation wurde mit folgenden Versionen getestet:

• MariaDB 10.11.2
• NodeJS 18.15.0
• NPM 9.5.0

Installation

Starte die Installation der Abhängigkeiten mit npm install im Projektverzeichnis (Hauptverzeichnis).

Konfiguration

Starte anschliessend den Setup Prozess mit npm run setup und folge den Anweisungen. Das Skript erstellt die benötigten .env Dateien sowie die Datenbank.

Hinweis zur Verwendung von SSL

Die Applikation unterstützt die Verwendung von SSL. Dazu muss ein gültiges Zertifikat und ein privater Schlüssel im PEM Format vorhanden sein. Diese müssen im Verzeichnis certs abgelegt werden. Die Dateinamen müssen cert.pem und key.pem lauten.

Dem Repository ist ein Self-Signed Zertifikat für localhost beigefügt, dieses ist im Verzeichnis certs abgelegt. Da es sich hierbei um ein Selbst signiertes Zertifikat handelt, muss es vom Browser akzeptiert werden.

Self-Signed Zertifikat akzeptieren

Öffne dazu die URL https://localhost:{ PORT } (Ersetze beim Aufruf im Browser { PORT } mit dem von dir definierten API Port aus dem Setup Prozess, standardmässig wird der Port 3000 verwendet). Der Browser wird eine Warnung anzeigen, dass das Zertifikat nicht vertrauenswürdig ist. Klicke auf "Erweitert" und anschliessend auf "Zertifikat ansehen". Anschliessend kannst du auswählen, das dem Zertifikat vertraut werden soll.

Hinweis: Das Vorgehen kann von Browser zu Browser variieren.

Benutzung (Entwicklungsmodus)

Starte die Applikation mit npm run devStart im Projektverzeichnis (Hauptverzeichnis).

Hinweis: Wird die Applikation mit aktiver SSL-Option gestartet muss bei der ersten Verwendung im jeweiligen Browser das Zertifikat akzeptiert werden.

Build (Produktionsumgebung)

Der Build Prozess kann mit npm run build im Projektverzeichnis gestartet werden. Die Applikation wird anschliessend im Verzeichnis client/dist publiziert.

Benutzung (Produktionsumgebung)

Die produktive Umgebung kann nach dem Build Prozess mit npm run start im Projektverzeichnis gestartet werden.

Weitere Informationen sind in der Dokumentation im Verzeichnis documents zu finden.

Entwickler

NXD | nx-designs
Marco Rensch
Webseite

Lizenz

MIT © Marco Rensch