ASWI - Pokročilé softwarové inženýrství » ASWI 2023 » Vylepšení funkcí a rozhraní frameworku SPADe (Pícha) - PRO_grammers.

h1. Rozchození a spuštění projektu

h2. Spuštění v Dockeru

_Aktuální k 11.3.2022_

h3. Potřebné nástroje

* Docker

* Docker Compose

h3. Postup

*1) Naklonovat projekt z GitHub repozitáře*

<pre><code class="shell">

git clone -b <nazev_vetve> https://github.com/jimdixx/SPADe-Web-GUI.git

</code></pre>

*2) Do složky /db nakopírovat soubor _spade-data.sql_*

* Soubor je dostupný na našem sdíleném Google Disku

*3) Nakonfigurovat aplikaci*

* V souboru _docker_compose.yml_

** Nastavit MYSQL_ROOT_PASSWORD (řádek 9)

** Nastavit SPRING_DATASOURCE_USERNAME a SPRING_DATASOURCE_PASSWORD pro phpMyAdmin (řádky 28, 29)

** Nastavit SPRING_DATASOURCE_USERNAME a SPRING_DATASOURCE_PASSWORD pro spring boot aplikaci (řádky 49, 50)

** Na řádek 17 přidat kopírování souboru s daty do souborového systému v Dockeru:

<pre>

./db/spade-data.sql:/usr/local/etc/spade-data.sql

</pre>

* V souboru _src/main/resources/application.properties_

** Nastavit _spring.datasource.username_ a _spring.datasource.password_ (stejné jako v _docker_compose.yml_)

** Nastavit _account.user.name_ a _account.user.password_

*4) Otevřít příkazový řádek v kořenovém adresáři projektu*

*5) Vytvořit potřebné komponenty aplikace*

<pre><code class="shell">

docker-compose build

</code></pre>

*6) Spustit aplikaci*

<pre><code class="shell">

docker-compose up

</code></pre>

*7) Provést obnovu a konfiguraci databáze*

Obnovu a konfiguraci databáze lze provést pomocí rozhraní phpMyAdmin nebo pomocí příkazového řádku

h4. Pomocí rozhraní phpMyAdmin

* Otevřít rozhraní phpMyAdmin - _localhost:8082_

* Přihlásit se pomocí údajů nastavených v konfiguračním souboru _docker_compose.yml_ (bod 2)

* Vytvořit novou databázi s názvem _spade_ a charset _utf8mb4_general_ci_

* V záložce _Import_ postupně importovat soubory (Vybrat soubor -> Import): 

** _db/spade.sql_

** _db/spade-views.sql_ 

** _db/spade-config.sql_

** _spade-data.sql_

h4. Pomocí příkazového řádku

* Postupně vykonat příkazy: 

<pre><code>

docker exec -it mysql-db bin/bash

mysql -u <uzivatel> -p

Heslo: <heslo>

create database spade;

use spade;

source /usr/local/etc/spade.sql;

source /usr/local/etc/spade-views.sql

source /usr/local/etc/spade-config.sql

source /usr/local/etc/spade-data.sql

</code></pre>

*8) Aplikace běží na _localhost:8080_*