ASWI - Pokročilé softwarové inženýrství » ASWI 2022 » Zpracování geografických údajů v novoasyrských textech (KBS FF) - Code of Duty

h1. Deployment

Pro deployment aplikace je využíváno Kubernetes. Byl pro nás vytvořen namespace *cnat*.

Adresa Kuberenes Dashboardu: https://dashboard.kube.zcu.cz/#/overview?namespace=cnat

Přístup nejspíš jenom pro uživatele správce deploymentu (anonymní já :D)

h2. Prerekvizity

Konfigurační soubory pro _deployment_ a _service_ databáze, aplikace a frontendu jsou uloženy v repozitory

h3. Frontend

V nginx configu pro frontend musí být vytvořeno přesměrování volání /api na backend server

Requesty na backend se posílají na base adresu /api - nastaveno ve složce _frontend/src/_ v souboru _.env_ (pro deployment musí být nastaveno *_REACT_APP_DEV_ENV=false_*)

Dockerfile pro frontend

h3. Backend

Před buildem docker image je potřeba spustit build aplikace přes maven příkazem _mvn clean install_

Dockerfile pro backend

h2. Kroky pro deploy aplikace:

h3. Build docker image

Nejdříve je potřeba sestavit docker image pro backend a frontend. Stačí spustit příkaz *docker-compose up* ve složce _backend_. Před buildem je ještě potřeba smazat lokální docker image nebo povýšit verzi v souboru _backend/docker-compose.yml_.

Následně image nahrát do docker hubu - příkaz *docker push* a název image, tj. *schwobik/frontend-app:<verze>* nebo *schwobik/backend-app:<verze>*. Verze musí odpovídat verzi uvedené v _docker-compose.yaml_ ve složce _backend_.

h3. Vytvoření konfiguračních souborů pro Kubernetes

Konfigurační soubory jsou uloženy v repozitáři. Pokud je potřeba nějaká změna, upravte patřičně soubor_backend/docker-compose.yml_ a pokračujte následujícím návodem, nebo soubory upravte ručně.

Soubory se vytvoří příkazem *kompose convert* , pokud je stažen kompose (https://kubernetes.io/docs/tasks/configure-pod-container/translate-compose-kubernetes/)

Soubor frontend-service.yaml je třeba ještě upravit, je třeba přidat řádku _type: LoadBalancer_ do elementu _specs_, jinak by Service nebyla přístupná z venku.

h3. Deployment

Dále stačí nahrát soubory do Kubernetes Clusteru.

h3. Zálohování aplikace

Pro databázi je vytvořen v Kubernetes Physical Volume Claim (PVC) _db-data_, který zajišťuje uchování dat databáze i v případě ukončení či spadnutí Podu s databází.

Data z databáze jsou navíc periodicky zálohována na PVC _db-data-backup_ na cestu _/var/backups/_ pomocí Cron Jobu, který je načasován na běh jednou týdně. K záloze je použit nástroj pg_dump.