aswi2020anonymous-gitlab/README.md @ 8ad6314c

# Indexace a fulltextové vyhledávání v historických obrazových dokumentech - ANONYMOUS

# Spuštění celé aplikace v dockeru
## Stažení image z docker hubu a spuštění (pro zadavatele)
- nainstalovat docker viz [Návody](#Návody)
- nastartovat docker
- stáhnout projekt nebo pouze soubory 
    - [docker-composer.yml](docker-compose.yml)
    - [run.sh](run.sh) Linux/Mac nebo [run.bat](run.bat) Windows     
- spustit skript `run.sh/run.bat`

## Lokální vytvoření image a spuštění
- nainstalovat docker viz Návody
- nastartovat docker
- přesunout se do root složky celého projektu (aswi2020anonymous)
- spustit příkaz `docker-compose build`
- spustit příkaz `docker-compose up -d`
    - `-d` flag spustí všechny kontejnery na pozadí, takže můžete terminál použít pro jiné účely.
- frontend nastartuje na adrese dockeru na portu 4200
- backend nastartuje na adrese dockeru na portu 8080


# Frontend - Angular
## Spuštění lokálně
- naistalovat a nastavit lokální prostředí [návod zde](https://angular.io/guide/setup-local).
- přesunout se do složky ./fe/fulltextsearch
- spustit příkaz `ng serve -o`
- frontend nastartuje na adrese `http://localhost:4200/`
- spuštění testů `ng test` a `ng e2e`

## Spuštění v dockeru
- nainstalovat docker viz Návody
- nastartovat docker `docker-machine start`
- přesunout se do složky ./fe/fulltextsearch
- spustit příkaz pro vytvoření docker image `docker build -t dockerangular .`
- spustit příkaz pro nastartování kontejneru `docker run -p4200:80 dockerangular`
- frontend nastartuje na adrese dockeru na portu 4200

# Backend - Spring boot
## Spuštění lokálně
- za pomocí IDE (Java 11)

## Spuštění v dockeru
- nainstalovat docker viz Návody
- nastartovat docker `docker-machine start`
- přesunout se do složky ./be/fulltextsearch
- spustit příkaz pro vytvoření docker image `docker build -t dockerspring .`
- spustit příkaz pro nastartování kontejneru `docker run -p8080:8080 dockerspring`
- backend nastartuje na adrese dockeru (většinou localhost) na portu 8080

# Database - Solr
## Solr - spuštění lokálně
- stáhnout si Solr [zde](https://lucene.apache.org/solr/downloads.html)
- přesunout se do složky ...\solr-8.4.1\bin 
- nastartovat Solr příkazem `solr start`
- vytvořit core "documents" příkazem `solr create -c documents`
## Solr - spuštění v dockeru
- nainstalovat docker viz Návody
- nastartovat docker 
- spustit příkaz `docker run -p8983:8983 solr`
- vytvoření core `docker exec <název kontejneru> solr create -c documents`

# Postup pro uvolnění nové verze a uložení na docker hub
- spustit docker
- povýšit verze v následujících souborech
    - backend [pom.xml](./be/fulltextsearch/pom.xml) (X.X.X-SNAPSHOT)
    - frontend [package.json](./fe/fulltextsearch/package.json) ("version": "X.X.X")
    - docker composer [docker-composer.yml](docker-compose.yml) (image: ondrejvane/fulltextsearch-backend:X.X.X a ondrejvane/fulltextsearch-frontend:X.X.X)
- přesunout se do root složky celého projektu (tam kde je soubor docker-composer.yml)
- přihlásit se ke svému docker repository příkazem `docker-login`, poté zadat svoje uživatelské jméno a heslo do docker hubu
- spustit příkaz `docker-compose build`
- spustit příkaz `docker-compose push`
- commitnout soubory s povýšenou verzí do gitu (commit message: Version X.X.X released)
- vytvořit tag s uvolněnou verzí na gitu ke commitu

# Návody
- Instalace dockeru [návod zde](https://docs.docker.com/docker-for-windows/install/)
- Instalace angularu [návod zde](https://angular.io/guide/setup-local)