Compare commits
2 Commits
22e1944637
...
92c892c42b
| Author | SHA1 | Date | |
|---|---|---|---|
| 92c892c42b | |||
| e36b254282 |
51
README.md
Normal file
51
README.md
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
# Gobas Web
|
||||||
|
|
||||||
|
Tento projekt obsahuje jednoduchý statický web a backend pre kontaktný formulár. Celá aplikácia je kontajnerizovaná pomocou Dockeru a beží za NGINX reverzným proxy serverom pre bezproblémový a rýchly deployment.
|
||||||
|
|
||||||
|
## Architektúra
|
||||||
|
|
||||||
|
Projekt sa skladá z troch hlavných služieb definovaných v `docker-compose.yaml`:
|
||||||
|
|
||||||
|
* **Proxy (NGINX):** Prijíma prichádzajúcu prevádzku na porte 80 a smeruje ju buď na statický frontend alebo na API backendu.
|
||||||
|
* **Frontend:** Jednoduchá webová prezentácia.
|
||||||
|
* **Backend (Flask):** Python mikroservis, ktorý slúži na spracovanie a odosielanie emailov z kontaktného formulára pomocou knižnice `Flask-Mail`.
|
||||||
|
|
||||||
|
## Požiadavky
|
||||||
|
|
||||||
|
Pre úspešné lokálne spustenie alebo nasadenie na server je potrebné mať nainštalované:
|
||||||
|
* Docker
|
||||||
|
* Docker Compose
|
||||||
|
|
||||||
|
## Konfigurácia prostredia (.env)
|
||||||
|
|
||||||
|
Backendová časť potrebuje na odosielanie správ z formulára prístup k SMTP serveru (predvolený je Gmail).
|
||||||
|
V koreňovom adresári projektu (kde sa nachádza `docker-compose.yaml`) vytvorte súbor `.env` a doplňte doň svoje údaje:
|
||||||
|
|
||||||
|
```env
|
||||||
|
MAIL_USERNAME=tvoj@email.sk
|
||||||
|
MAIL_PASSWORD=tvoje_tajne_heslo_alebo_app_password
|
||||||
|
```
|
||||||
|
|
||||||
|
> **Poznámka pre Gmail:** Ak máte na Google účte zapnuté dvojfázové overenie (2FA), klasické heslo nebude fungovať. Je potrebné si v nastaveniach Google účtu vygenerovať tzv. Heslo aplikácie (App Password).
|
||||||
|
|
||||||
|
## Spustenie
|
||||||
|
|
||||||
|
Pre zostavenie Docker obrazov a naštartovanie všetkých služieb na pozadí spustite nasledujúci príkaz:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker-compose up --build -d
|
||||||
|
```
|
||||||
|
|
||||||
|
Po úspešnom spustení bude webová stránka dostupná vo vašom prehliadači na adrese `http://localhost`.
|
||||||
|
|
||||||
|
Pre zastavenie bežiacich kontajnerov použite:
|
||||||
|
```bash
|
||||||
|
docker-compose down
|
||||||
|
```
|
||||||
|
|
||||||
|
## Štruktúra projektu
|
||||||
|
|
||||||
|
* `/frontend/` - Zdrojové kódy pre statický web a príslušný `Dockerfile`.
|
||||||
|
* `/backend/` - Zdrojové kódy pre Python Flask API a jeho `Dockerfile`.
|
||||||
|
* `/nginx/` - Konfiguračný súbor `nginx.conf` pre reverzné proxy.
|
||||||
|
* `docker-compose.yaml` - Hlavný predpis pre Docker služby.
|
||||||
@@ -13,7 +13,7 @@ services:
|
|||||||
|
|
||||||
frontend:
|
frontend:
|
||||||
build:
|
build:
|
||||||
context: ./frontned
|
context: ./frontend
|
||||||
dockerfile: Dockerfile
|
dockerfile: Dockerfile
|
||||||
container_name: gobas_frontend
|
container_name: gobas_frontend
|
||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
|
|||||||
22
nginx.conf
Normal file
22
nginx.conf
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
server {
|
||||||
|
listen 80;
|
||||||
|
server_name localhost;
|
||||||
|
|
||||||
|
# Smerovanie bežných požiadaviek na frontend kontajner
|
||||||
|
location / {
|
||||||
|
proxy_pass http://frontend:80;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Forwarded-Proto $scheme;
|
||||||
|
}
|
||||||
|
|
||||||
|
# Smerovanie API požiadaviek (odosielanie emailu) na backend kontajner
|
||||||
|
location /send-email {
|
||||||
|
proxy_pass http://backend:5000/send-email;
|
||||||
|
proxy_set_header Host $host;
|
||||||
|
proxy_set_header X-Real-IP $remote_addr;
|
||||||
|
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
|
||||||
|
proxy_set_header X-Forwarded-Proto $scheme;
|
||||||
|
}
|
||||||
|
}
|
||||||
Reference in New Issue
Block a user