... | ... | @@ -71,29 +71,38 @@ into the **arsnova-click.env** file |
|
|
Your **arsnova-click.env** file should look like this:
|
|
|
![image](uploads/43641996f484ea95a50340ba3c6087f4/image.png)
|
|
|
|
|
|
- Schreibe **`source arsnova-click.env`** in die Kommandozeile.
|
|
|
- Danach musst du nurnoch **`docker-compose up -d mongodb rabbitmq`** in die Kommandozeile eingeben um die Container von MongoDB und RabbitMQ zu starten.
|
|
|
- Gib zum überprüfen ob die Docker Container richtig gestartet wurden **`docker ps`** ein, es sollte ungefähr so aussehen:
|
|
|
![image](uploads/60117282cc9505e55e14d1b9e0a54fec/image.png)
|
|
|
- Als nächstes erstellen wir uns einen Benutzer für RabbitMQ. Öffne dafür zunächst die Adresse http://localhost:15674/ und dann http://localhost:15672/. Du solltest eine Einlogmaske auffinden:
|
|
|
![image](uploads/21d175efd33d560211249d568606d753/image.png)
|
|
|
- Logge dich ein mit Username: **`user`** und Password: **`bitnami`**.
|
|
|
- Klicke auf den Tab **Admin**.
|
|
|
- Gib nun bei **Add a user** den Username: **`meinNutzer`** und das Password: **`meinPasswort`** ein, klicke ausserdem bei **set** auf **`Admin`**, drücke dann auf den Knopf **Add user**.
|
|
|
![image](uploads/224327d456fa2933a55acaf77606b2fc/image.png)
|
|
|
- Klicke dann im Menü wo die User aufgelistet sind auf **meinNutzer**:
|
|
|
![image](uploads/9f9baafca087ccb0c0b989d4ae7e4127/image.png)
|
|
|
- Klicke jetzt auf **Set permission**:
|
|
|
![image](uploads/60228859a01d5feb39729b36f935f3b1/image.png)
|
|
|
- Nun musst du das Backend bauen lassen indem du **`npm run build:DEV`** in die Kommandozeile eingibst, um ein sauberes Build zu erhalten, du kannst während des Programmierens **`tsc --watch`** nutzen damit die geänderten Dateien direkt transpiliert werden.
|
|
|
- Als letztes musst du es (nurnoch) starten! Öffne zuerst eine neue Kommandozeile, gehe wieder in den Ordner des Backends, gib dann **`cd dist`** um in den durch **build** generierten Ordner zu navigieren und dann **`node main.js`** ein, um den Server zu starten.
|
|
|
- Sieht es so aus wenn du http://localhost:3010/ im Browser aufrufst?
|
|
|
![image](uploads/b016e17ebca517d87a56e60e8d2522c9/image.png)
|
|
|
Falls ja, dann hast du es geschafft!
|
|
|
- Wenn dennoch Probleme auftreten lese die Rückmeldungen im Terminal beim ausführen von **`node main.js`** und **`npm run test`**.
|
|
|
- Tipp: Gucke dir die Swagger Dokumentation unter http://localhost:3010/api/v1/api-docs/ an um ein strukturierten Einblick in die Routen des Backends zu bekommen.
|
|
|
9. Gib **`source arsnova-click-export.env`** ein um die .env Datei zu übergeben
|
|
|
|
|
|
10. Starte nun die Docker-Container mit **`docker-compose up -d mongodb rabbitmq`**
|
|
|
|
|
|
11. Zur Überprüfung gib `**docker ps`** ein, du solltest nun deine Container sehen:
|
|
|
![image](uploads/60117282cc9505e55e14d1b9e0a54fec/image.png)
|
|
|
|
|
|
12. Nun müssen wir ein Nutzer für RabbitMQ erstellen. Öffne zuerst http://localhost:15674/ direkt danach http://localhost:15672/. Du solltest eine Einlogmaske auffinden:
|
|
|
![image](uploads/21d175efd33d560211249d568606d753/image.png)
|
|
|
|
|
|
13. Logge dich ein mit Username: **`user`** und Passwort: **`bitnami`**
|
|
|
|
|
|
14. Klicke dann auf den Tab: **Admin**
|
|
|
|
|
|
15. Gib unter dem Punkt **Add a user** ein: **`myUser`** und das Passwort: **`myPassword`**, klicke dann auf **`Admin`** bei **set**, schließe die Erstellung eines Nutzers mit **Add user** ab
|
|
|
![image](uploads/84e5cf52504998b779e254688774c2c5/image.png)
|
|
|
|
|
|
16. Klicke auf den neu erstellten Nutzer **myUser** in dem Menü, welches alle Nutzer listet:
|
|
|
![image](uploads/3f042bc8c551139e6aaa779d23130f4c/image.png)
|
|
|
|
|
|
17. Und drück **Set permission**:
|
|
|
![image](uploads/5d9d3830afce4642a76f1fba31d77a1d/image.png)
|
|
|
|
|
|
18. Transpilier den Typescript code zu Javascript indem du **`npm run build:DEV`** eingibst
|
|
|
|
|
|
19. Öffne eine neue Kommandozeile in dem gleichen Verzeichnis und gib **`cd dist`** ein um in den gerade erstellten Ordner zu navigieren, mit **`node main.js`** kannst du den Backend Server starten
|
|
|
|
|
|
20. Du solltest ein ähnliches Bild sehen wenn du http://localhost:3010/statistics in deinem Browser öffnest:
|
|
|
![image](uploads/eac43ed44eee5c5526e38e10f69159c0/image.png)
|
|
|
Super!
|
|
|
|
|
|
21. Wenn du dennoch auf Probleme stößt, lese die Rückmeldungen beim ausführen von **`node main.js`** und **`npm run test`**, einige der häufigsten Fehler habe ich unten bei **Fehlerbehebung** gelistet
|
|
|
|
|
|
## Frontend
|
|
|
|
... | ... | |