Przejdź do treści

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:

cp src/main/resources/env.default.properties src/main/resources/env.properties

Znaczenie zmiennych opisuje strona Konfiguracja.

Uruchomienie lokalne

IntelliJ

  1. Po sklonowaniu repozytorium otwieramy strukturę projektu skrótem Shift+Ctrl+Alt+S i wybieramy SDK Java 17 albo nowsze.
  2. W ustawieniach Build, Execution, Deployment, Build Tools, Gradle ustawiamy to samo w polu "Gradle JVM".
  3. Budujemy projekt, klikając przycisk przy build.gradle.kts albo zadanie Tasks, build, build.
  4. Uruchamiamy klasę InfokioskApplication.kt.

Konfiguracja uruchomieniowa InfokioskApplication leży w katalogu .run i wykonuje zadanie compileSass przed startem. Ustawia też zmienną KIOSK_NAME.

Wybór SDK w IntelliJ

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

Pole Gradle JVM w ustawieniach IntelliJ

Wiersz poleceń

./gradlew bootRun

Aplikacja odpowiada pod adresem http://localhost:<KIOSK_PORT><KIOSK_CONTEXT_PATH>, np. http://localhost:8090/infokiosk.

Budowanie

./gradlew clean bootJar
./gradlew war

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:

docker compose up --build

W pełnym stacku kiosk działa jako usługa infokiosk w repozytorium apollo-docker na porcie 8086.

Testy

./gradlew test

Ostatnia zmiana: 2026-10-08 · Dariusz Bakowski
Zbudowano: 2026-11-20 10:32 UTC · wersja 1.0.0 · rewizja: 19fcdc12e