# 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](<https://docs.logintegra.com/infokiosk/konfiguracja/index.md>).

## 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](<https://docs.logintegra.com/infokiosk/static/other/SDK.png>)

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

![Pole Gradle JVM w ustawieniach IntelliJ](<https://docs.logintegra.com/infokiosk/static/other/gradleJVM.png>)

### 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
```
