Skip to content

Latest commit

 

History

History
125 lines (77 loc) · 4.4 KB

INSTALL_online_fullstack.md

File metadata and controls

125 lines (77 loc) · 4.4 KB
Raw

Spring-GraphQL Training

Hier findest Du alles, was Du zur Vorbereitung auf das GraphQL Training wissen musst.

Voraussetzungen

Für dein Laptop/PC

Auf deinem Laptop/PC sollte installiert sein:

  • Git (zum klonen des Workspaces)
  • Java JDK (mindestens Version 11)
  • Docker
  • Browser
  • Eine Java IDE, zum Beispiel IntelliJ IDEA (Evaluationsversion reicht)
  • Für Schulungen, die wir über Zoom machen: bitte den Zoom Client installieren (und nicht die Web-Version von Zoom verwenden). Du benötigst keinen Zoom-Account.

Während des Trainings

  • Da wir vor und während des Trainings ggf. noch Aktualisierungen installieren müssen, bitte sicherstellen, dass auch während des Trainings auf deinem Computer der Internet-Zugang (logisch, online-Schulung 🙃) funktioniert - und zwar auch für Git, Gradle und Docker (Proxies beachten!)
  • Ich freue mich, wenn Du während des Trainings deine Kamera an hast, damit wir uns sehen können 🎥. Mikrofon hingegen bitte nur anmachen, wenn Du etwas sagen oder fragen möchtest (was Du natürlich jederzeit darfst!)
  • W-LAN ist bequem, aber gerade bei (langen) Streamings ist ein Kabel-gebundenes Netzwerk stabiler als W-LAN, also im Zweifel lieber das Kabel einstecken (und W-LAN deaktivieren) 😊

Installation und Vorbereitung des Workspaces für die Schulung

Um Zeit während des Workshops zu sparen, kannst Du im Vorweg schon den Workspace klonen und die Projekte installieren.

Verzeichnisse

Das Repository besteht aus zwei Verzeichnissen: app und workspace

  • Wir arbeiten nur in workspace. Es reicht, wenn Du dieses Verzeichnis in deiner IDE öffnest (am Besten als Gradle-Projekt importieren)
  • Das app-Verzeichnis entält eine "fertige" Anwendung, die braucht ihr nicht zu verwenden. Falls ihr die ausprobieren wollt, findet ihr weiter unten eine Beschreibung.

Die folgenden Schritte beziehen sich also immer auf das workspace-Verzeichnis, soweit nicht anders angegeben.

Ports

Die Anwendung benötigt folgende folgende Ports:

  • 8090 (Backend für die GraphQL API)
  • 8091 (UserService)

Bitte achte darauf, dass diese Ports nicht belegt sind.

Den Workspace für die Übungen einrichten

Schritt 1: Repository klonen

  1. Das Repository klonen:
git clone https://github.com/nilshartmann/spring-graphql-training

Schritt 2: Testweise den Workspace bauen

  1. Im Verzeichnis workspace des Repositories einmal den Gradle-Build ausführen, damit werden dann auch gleich alle benötigten Module geladen:
cd workspace

./gradlew clean build -x :hello-graphql-java:test

Schritt 3: Frontend Packages installieren

Achtung! Port 3000 darf nicht belegt sein.

Voraussetzung: Der Package-Manager pnpm (Version 7.9.5) ist installiert.

  • Installation von pnpm siehe: https://pnpm.io/installation
  • Bei mir habe ich pnpm wie folgt installiert: 
    corepack enable
corepack prepare [email protected] --activate
  • (Möglicherweise funktioniert das Starten auch mit yarn oder npm, aber ich teste mit pnpm).
  • Meine Node-Version ist 16.17.0

Installieren der Packages und testweise Bauen des Frontends:

cd workspace/publy-frontend

pnpm install

pnpm build

Wenn Du möchtest, kannst Du das Frontend auch testweise starten:

cd workspace/publy-frontend

pnpm start

Du kannst nun das Frontend über http://localhost:3000 in deinem Browser öffnen.

Schritt 4: Öffnen des Workspaces in der IDE

Wenn Du möchstest, kannst Du das workspace-Verzeichnis schon in deiner IDE öffnen. Dort sollten vier (Gradle-)Projekte erkannt und compiliert werden:

  • hello-graphql-java
  • publy-backend
  • publy-userservice
  • publy-frontend

Die anderen Verzeichnisse in diesem Repository brauchst Du nicht in der IDE zu öffnen. Wir arbeiten ausschliesslich in dem workspace-Verzeichnis.

Das ist alles!

Bei Fragen oder Problemen melde dich gerne bei mir.

Die fertige Anwendung

Im Verzeichnis app findest Du eine vollständige GraphQL-Anwendungen. Einen kleinen Teil dieser Anwendung, bzw. dessen API, werden wir im Laufe des Trainings gemeinsam bauen.

Es ist nicht erforderlich, dass Du die fertige Anwendung ausführst oder verwendest. Ich werde sie dir auf meinem Computer zeigen.

Falls Du die Anwendung ausführen möchtest, findest Du in der README-Datei im app-Verzeichnis weitere Informationen. Achtung! Für die fertige Anwendung benötigst du Java 17.