Entwicklungsumgebung¶
Als Entwicklungsumgebung für das Geoportal 2.0 wird Visual Studio Code + Docker verwendet. Diese Anleitung bezieht sich auf Windows 10 Professional. Für die Entwicklung mit Windows 10 Home müssen wir
WSL2 (https://docs.microsoft.com/de-de/windows/wsl/wsl2-install) abwarten, das von Docker Desktop for Windows verwendet werden kann -- übergangsweise kann nodejs auch direkt unter Windows installiert werden (dabei fehlt allerdings der Komfort von docker-compose).
- Git als Versionsverwaltung: https://git-scm.com/
- Visual Studio Code als IDE: https://code.visualstudio.com/
- Die Erweiterungen "Docker" und "Remote Development" werden benötigt.
- Docker Desktop for Windows als Laufzeitumgebung: https://hub.docker.com/editions/community/docker-ce-desktop-windows/
- Im Behördennetz muss der Proxy in den Einstellungen von Docker Desktop eingerichtet werden.
- Nicht die Geduld verlieren, Docker Desktop startet sehr langsam.
Anschließend das Git-Repository https://gitlab.geoportal.de/geoportal/geoportal klonen. In der Datei ".git/config" die Zeile worktree = ... löschen, sonst kommt es zu Problemen da der Windows-Pfad in den Linux-Containern natürlich anders heißt. Mit "git submodule update --init --recursive" anschließend die Submodule (Unter-Repositories) laden.
Nun den Repo-Ordner in Visual Studio Code Öffnen. Ist alles richtig eingerichtet, erscheint nun unten rechts ein Popup, dass das Repo auch in einem Container geöffnet werden kann, hier "Open in Container" auswählen.
Das Aufbauen des Containers dauert wieder einige Zeit, da zuerst die nodejs-Pakete installiert werden. Hier wieder geduldig sein, solange keine Fehlermeldung erscheint geht es voran.
Visual Studio Code startet nun automatisch auch alle in docker-compose.yml definierten Service-Container. Die eigentliche Anwendung kann jetzt aus dem Terminal mit "npm run start" gestartet werden. Den erscheinenden Link zu "http://localhost:8080" einfach mit Strg+Klick im Browser öffnen, VS Code richtet automatisch die passende Port-Weiterleitung ein. (Achtung: Wird der Link kopiert und nicht angeklickt, fehlt die Weiterleitung und die Verbindung kann nicht aufgebaut werden)
ALTE VERSION:
Einrichten Entwicklungsumgebung¶
Eclipse EE Java¶
maven.apache¶
Hibernate in Eclipse EE Java¶
NodeJS in Eclipse EE Java¶
Masterportal Hamburg in Visual Studio integrieren¶