# **Správa Používateľov - Docker Aplikácia** ## **1. Podmienky na nasadenie a spustenie aplikácie** Aby ste mohli aplikáciu spustiť, musíte mať nainštalované: - **Linux** (napr. Ubuntu vo WSL, alebo iná distribúcia) - **Docker** (https://docs.docker.com/get-docker/) - **Docker Compose** (https://docs.docker.com/compose/install/) ## **2. Opis aplikácie** Aplikácia poskytuje jednoduché webové rozhranie na správu používateľov. Používateľlia sú uložení v databáze PostgreSQL a aplikácia ich dokáže pridávať alebo mazať cez jednoduché API a webové rozhranie. ## **3. Opis virtuálnych sietí a pomenovaných zväzkov** - **Virtuálna sieť `app_network`** - Umožňuje komunikáciu medzi kontajnermi (web, db, pgAdmin). - **Pomenovaný zväzok `pgdata`** - Používa sa na trvalé uloženie databázových údajov PostgreSQL, aby sa nestratili pri reštarte kontajnerov. ## **4. Opis konfigurácie kontajnerov** Aplikácia používa **Docker Compose**, kde sú definované tri kontajnery: - **Web** (Flask aplikácia) - Počúva na porte **5000** - Komunikuje s databázou `db` - **DB** (PostgreSQL) - Používa volume `pgdata` na trvalé uloženie údajov - Počúva na porte **5432** - **pgAdmin** (Grafické rozhranie na správu PostgreSQL) - Počúva na porte **8080** ## **5. Zoznam použitých kontajnerov** - **Web (Flask)** - Používa Python 3.9 a Flask na poskytovanie webovej aplikácie. - **PostgreSQL** - Používa obraz `postgres:13`, databázu `mydatabase`. - **pgAdmin** - Používa obraz `dpage/pgadmin4`, port **8080**. ## **6. Ako pripraviť, spustiť, pozastaviť a vymazať aplikáciu** ### **Príprava aplikácie:** ```bash ./prepare-app.sh ``` Týmto príkazom sa vytvorí sieť, volume a pripraví databáza. ### **Spustenie aplikácie:** ```bash ./start-app.sh ``` Aplikácia sa spustí a bude dostupná na **http://localhost:5000**. ### **Pozastavenie aplikácie:** ```bash ./stop-app.sh ``` Pozastavenie aplikácie neodstráni údaje. ### **Vymazanie aplikácie:** ```bash ./remove-app.sh ``` Tento príkaz **vymaže všetky kontajnery, sieť a volume**, čo znamená, že **databáza bude kompletne vymazaná**. ## **7. Ako si pozrieť aplikáciu v prehliadači** - **Hlavná aplikácia:** [http://localhost:5000](http://localhost:5000) - **pgAdmin (správa databázy):** [http://localhost:8080](http://localhost:8080) ## **8. Príklad práce s aplikáciou** ### **Pridanie používateľa:** 1. Otvorte aplikáciu na **http://localhost:5000** 2. Zadajte meno do textového poľa. 3. Kliknite na **"Pridať"**. 4. Používateľ sa uloží do databázy a zobrazí na stránke. ### **Odstránenie používateľa:** 1. Kliknite na tlačidlo **"Odstrániť"** pri konkrétnom používateľovi. 2. Používateľ bude vymazaný z databázy.