Readme Update
Módosítottam a readme-t szövegesebbre és látványosabbra
This commit is contained in:
102
README.md
102
README.md
@@ -1,3 +1,103 @@
|
|||||||
# DB
|
# DB
|
||||||
|
|
||||||
Az adatbázis konfiguráció, ami tárolja a webalkalmazás adatait
|
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
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user