Uruchomienie i budowanie¶
Strona opisuje, jak zbudować Infokiosk, uruchomić go lokalnie i w Dockerze oraz jak uruchomić testy. Jest dla programistów, którzy zaczynają pracę z repozytorium.
Wymagania¶
- Java 17 albo nowsza
- Gradle Wrapper z repozytorium, czyli
./gradlew - dostęp do Apollo i do mikroserwisu SMS z ustawień w
env.properties - IntelliJ IDEA, jeśli uruchamiamy z IDE
Kiosk nie potrzebuje bazy danych.
Konfiguracja przed pierwszym startem¶
Aplikacja nie wystartuje bez pliku src/main/resources/env.properties.
Tworzymy go z pliku wzorcowego:
Znaczenie zmiennych opisuje strona Konfiguracja.
Uruchomienie lokalne¶
IntelliJ¶
- Po sklonowaniu repozytorium otwieramy strukturę projektu skrótem
Shift+Ctrl+Alt+Si wybieramy SDK Java 17 albo nowsze. - W ustawieniach
Build, Execution, Deployment,Build Tools,Gradleustawiamy to samo w polu "Gradle JVM". - Budujemy projekt, klikając przycisk przy
build.gradle.ktsalbo zadanieTasks,build,build. - Uruchamiamy klasę
InfokioskApplication.kt.
Konfiguracja uruchomieniowa InfokioskApplication leży w katalogu .run i wykonuje zadanie compileSass przed startem.
Ustawia też zmienną KIOSK_NAME.

Błąd A problem occurred configuring root project 'infokiosk' oznacza zwykle złą wersję Javy w polu "Gradle JVM".

Wiersz poleceń¶
Aplikacja odpowiada pod adresem http://localhost:<KIOSK_PORT><KIOSK_CONTEXT_PATH>, np. http://localhost:8090/infokiosk.
Budowanie¶
Kompilacja plików SCSS do CSS jest częścią budowania.
Task compileSass uruchamia się przed testami i przed ustaleniem klasy startowej.
Gotowe pliki trafiają do build/resources/main/static/styles.
Projekt jest zbudowany jako WAR, a kontener Docker uruchamia wersję bootJar.
Docker¶
Obraz buduje dwuetapowy Dockerfile.
| Etap | Obraz | Zadanie |
|---|---|---|
| budowanie | gradle:7.6.4-jdk17-jammy |
./gradlew clean bootJar |
| uruchomienie | eclipse-temurin:17-jre-jammy |
java -jar /usr/local/app/app.jar |
Obraz zawiera aplikację, ale nie zawiera pliku env.properties.
Konfigurację trzeba dostarczyć przy starcie kontenera, np. montowaniem pliku albo przez zmienne środowiskowe.
docker-compose.yaml buduje obraz i publikuje port 8088 hosta na port 8080 kontenera:
W pełnym stacku kiosk działa jako usługa infokiosk w repozytorium apollo-docker na porcie 8086.
Testy¶
Ostatnia zmiana: 2026-10-08 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e