Files
DB/README.md
Zombori Péter eab1e413c5 Readme Update
Módosítottam a readme-t szövegesebbre és látványosabbra
2025-10-08 18:51:35 +02:00

104 lines
2.6 KiB
Markdown

# DB
Konténerizált MariaDB engine, ami tárolja a Telefonkönyv Webalkalmazás adatait.
## Táblák:
### users
| **id** | **uname** | **pw** | **admin** | **note**
| --- | --- | --- | --- | --- |
| *int* | *varchar* | *varchar* | *tiny int - bool* | *text* |
| *pk, ai* | *not null* | *not null* | *not null, default false* | *null* |
### contacts
| **id** | **name** | **phone** | **address** | **note**
| --- | --- | --- | --- | --- |
| *int* | *varchar* | *varchar* | *varchar* | *text* |
| *pk, ai* | *not null* | *not null* | *not null* | *null* |
## Futtatás:
Az adatbázis konténert a `docker-compose.yml` file írja le. Futtatása a következő:
### Indítás
```bash
docker compose up -d
```
> *Bizonyos operációs rendszereken `docker-compose up -d`*
Logokkal való indításhoz a `docker compose logs` használható, folyamatos debug logokért a következő indítóparancs használatos Windows-on:
```bash
docker compose up -d ; docker compose logs -f
```
> Linux alatt `docker compose up -d && docker compose logs -f`
> Vagy `docker-compose up -d && docker-compose logs -f`
### Leállítás
A konténer és hozzá tartozó network leállítása a következővel érhető el:
```bash
docker compose down
```
> *Bizonyos operációs rendszereken `docker-compose down`*
### Linux - *sudo* probléma
Néha Linux alatt - verziótól függően - gyakori probléma az, hogy minden docker és docker compose process *root* alatt fut. Ezért ilyenkör a következő parancsokkat érdemes használni:
```bash
# Indítás:
sudo docker compose up -d
# Logok:
sudo docker compose logs -f
# Indítás - logokkal:
sudo docker compose up -d && sudo docker compose logs -f
# Leállítás:
sudo docker compose down
```
Illetve a *Docker Compose* verziójától függően ugyan ez vonatkozik:
```bash
# Indítás:
sudo docker-compose up -d
# Logok:
sudo docker-compose logs -f
# Indítás - logokkal:
sudo docker-compose up -d && sudo docker-compose logs -f
# Leállítás:
sudo docker-compose down
```
### Windows
A Docker Dekstopot telepítve egyből lejön a `docker compose` parancs, amit cmd-ből, vagy PowerShell-ből tudunk használni, ugyan úgy, mint Linux alatt.
> #### Fontos!
> Fontos, hogy a cmd-t és a PowerShellt is ***adminisztrátorként*** futtassuk!
## Kapcsolódás
A kapcsolódás a szokásos MariaDB SQL portokon működik a következő módon:
- hostname: `localhost` vagy `127.0.0.1`
- port: `3306`
- database: `telefonkonyv`
- user: `appuser`
- password: `apppass`
> Az adatbázis *root* felhasználójának a jelszava: `rootpw`, De ezek az adatok is mind konfigurálhatóak a `docker-compose.yml`-ben