# Teenus KL-MORPH-ANALYSER

Käesolev teenus kasutab Vabamorf käsurea utiliiti ja tagastab etteantava **lausestatud tekstifaili** kohta 
tekstifaili, milles on iga lausestamise käigus eraldi reale asetatud sõne järel read selle sõne 
morfoloogilise analüüsi variantidega.

## Komponendi docker-compose'ga kasutamise ettevalmistamine (Linuxis)
* Eeldame, et serveris on juba olemas järgmised projektid:
  * https://gitlab.keeleressursid.ee/keeleliin/keeleliin-master.git
  * https://gitlab.keeleressursid.ee/keeleliin/server.git
  * https://gitlab.keeleressursid.ee/keeleliin/klient.git
  * https://gitlab.keeleressursid.ee/keeleliin/kl-lausestaja.git
* Tee käesolevast projektist enda serveri kettale kloon:
  ```
  $ git clone https://gitlab.keeleressursid.ee/keeleliin/kl-morph-analyser.git
  ```
* Tutvu saadaoleva dokumentatsiooniga ja kui vaja, siis tee projekti failidesse vajalikud muudatused. Tavaliselt on vaja muuta faile
  * config_dist.js
  * Dockerfile
  
* Salvesta tehtud muudatused
  ```
  $ git commit -a
  ```
* Täienda konfiguratsioonifaili keeleliin-master/docker-compose.yml vastavalt failis keeleliin-master/README.MD kirjapandud juhistele. 
Näiteks antud teenuse nimeks konfiguratsioonis on morpher.
Jälgi, et config.js-is kirjeldatud teenuse port, Dockerfile #Expose port ja docker-compose.yml'is olev service.morpher.port oleksid sama väärtusega.
* Valmista ette teenuse konteineri image:
  ```
  $ cd keeleliin-master
  $ docker-compose build morpher
  ```
* Kui keeleliini rakendus juba töötab, siis käivita uue teenuse konteiner nii:
  ```
  $ docker-compose up -d morpher
  ```
* Kui keeleliini rakendus veel ei tööta, siis kogu rakendust korraga käivitakse nii:
  ```
  $ docker-compose up -d
  ```
* Uue teenuse funktsioneerimist saab kontrollida, kui pöörduda veebilehitsejaga serveri teenusele määratud pordi poole. Kui serveri nimeks on 'kl-host' ja
teenuse pordiks näiteks 3011, siis peaks näha olema infot järgmistel lehtedel:
  * http://kl-host:3011/
  * http://kl-host:3011/api/v1/check
  * http://kl-host:3011/api/v1/statistics
  * http://kl-host:3011/api/v1/service/install
* Soovi korral saab teenuse konteineris teha toiminguid, aga eeldatavasti ei ole vaja midagi täiendavat teha:
  ```
  $ docker-compose exec morpher bash
  ```
* Keeleliini üksiku teenuse (või kogu rakenduse) saab seisma panna nii:
  ```
  $ docker-compose down morpher
  $ docker-compose down
  ```