Step-by-step Tutorial

In diesem Tutorial wird Schritt für Schritt erklärt wie das FrEDA-Framework eingerichtet und für die Entwicklung vorbereitet wird. Die Beschreibung der einzelnen Komponenten finden Sie im Docs-Bereich.

Installation Requirements

Git

Git ist ein Versionskontrollsystem zur Verfolgung von Änderungen im Quellcode während der Softwareentwicklung und kann Ihnen dabei helfen, Dateien zwischen Ihrem lokalen System und Ihrem Online-Repository zu synchronisieren und zu versionieren. Git für Windows enthält Git Bash, eine Terminalanwendung. Falls noch nicht installiert, siehe Git installieren.

Der schnellste Weg zur laufenden lokalen FrEDA Anwendung geht über Docker und Docker-Compose. Siehe Quick-run. Für die Entwicklung wird ein Setup ohne Docker bevorzugt, um detaillierte Fehleraufgaben pro Microservice zu erhalten.

NodeJS

NodeJS ist eine Umgebung, die JavaScript-Code außerhalb eines Webbrowsers ausführen kann und zum Schreiben und Ausf ühren von serverseitigen JavaScript-Apps verwendet wird. Die Installation von NodeJS umfasst npm, den Paketmanager , mit dem Sie NPM-Module von Ihrem Terminal aus installieren können.

Öffnen Sie Terminal auf einem Mac-, Linux- oder Unix-System. Öffnen Sie Git Bash auf einem Windows-System.
Wenn Sie auf Ihrem Betriebssystem "Brew" haben, führen Sie den folgenden Befehl aus, um Node zu installieren.

brew install node

NVM (optional)

nvm ist ein Versionsmanager für NodeJS, mit dessen Hilfe der parallele Betrieb und Wechsel von mehreren NodeJS -Versionen möglich ist. Details finden Sie hier: NVM-Github

nvm use 12

Alternativ können Sie ein Installationsprogramm für NodeJS von der NodeJS-Homepage herunterladen.

Überprüfen Sie Ihre NodeJS-Installation

Stellen Sie sicher, dass Sie die mindestens erforderliche Version installiert haben, indem Sie den folgenden Befehl ausführen:

node -v

Sie sollten eine Version sehen, die größer als Knoten 8 ist.

node -v
v12.14.0

Die von FrEDA mindestens unterstützte NodeJS-Version ist Node 12.

Yarn

FrEDA benötigt neben npm den NPM-Paketmanager Yarn, der eine hervorragende Leistung für die Verwaltung Ihrer NPM-Abhängigkeiten bietet. Die Installationsanleitung finden Sie hier,

Yarn wird vor allem für die Nutzung unterschiedlicher Workspaces im FrEDA-Monorepo genutzt, eine Funktion welche der standard NPM-Paketmanager nicht zur Verfügung stellt.

Lerna

Lerna ist ein Tool, das den Workflow für die Verwaltung von Repositorys mit mehreren Paketen mit git und npm/yarn optimiert. Installiert global auf dem System über:

yarn global add lerna

oder

npm i -g lerna

Mehr Infos unter: lerna.js.org

PostgreSQL + Datenbank

Für die Konfigurationen im FrEDA wird ein PostgreSQL-Datenbank benötigt. Die Einrichtungsdaten werden bei der Installation in die Datenbank geschrieben. Es wird lediglich die Verbindung zur Datenbank benötigt.

Die von FrEDA mindestens unterstützte PostgreSQL-Version ist 9.6.

FrEDA