zkt25/z1

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:

./prepare-app.sh

Týmto príkazom sa vytvorí sieť, volume a pripraví databáza.

Spustenie aplikácie:

./start-app.sh

Aplikácia sa spustí a bude dostupná na http://localhost:5000.

Pozastavenie aplikácie:

./stop-app.sh

Pozastavenie aplikácie neodstráni údaje.

Vymazanie aplikácie:

./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
• pgAdmin (správa databázy): 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.