55 lines
2.4 KiB
Markdown
55 lines
2.4 KiB
Markdown
# Aether Docker Cheat Sheet 🚀
|
|
|
|
## 🚀 Deployment & Updates
|
|
- **Full Rebuild (Fast):** `docker compose up -d --build`
|
|
- **Rebuild SvelteKit UI:** `docker compose up -d --build ae_app`
|
|
- **Restart API (Pick up Python changes):** `docker compose restart ae_api`
|
|
- **Switch Build Mode:** Edit `.env` -> `AE_APP_BUILD_MODE=prod` -> `docker compose up -d --build ae_app`
|
|
|
|
## 🛠️ Management Links
|
|
- **SvelteKit Frontend:** [http://localhost:3001](http://localhost:3001)
|
|
- **FastAPI Documentation:** [https://dev-api.oneskyit.com/docs](https://dev-api.oneskyit.com/docs)
|
|
- **Database (phpMyAdmin):** [http://localhost:8081](http://localhost:8081)
|
|
- **Logs (Dozzle):** [http://localhost:8881](http://localhost:8881)
|
|
|
|
## 💾 Database Operations
|
|
- **Manual Backup:** `./backup_db.sh` (Hot backup, live container)
|
|
- **Manual Restore:** `./restore_db.sh [path_to_file.gz]` (Automated password/grant reset)
|
|
- **Conference Export:** `./export_db.sh` (Saves to `backups/conference_export/`)
|
|
- **Automated Import:** Drop file in `backups/import/` -> Run `./check_and_import.sh`.
|
|
|
|
## 📈 Scaling
|
|
|
|
### ae_api — scales via Docker DNS (no host ports needed)
|
|
`ae_api` has no host ports. External traffic enters via `ae_web_dev` (port 5060/443),
|
|
which round-robins across all `ae_api` replicas using Docker's internal DNS.
|
|
|
|
1. Edit `.env` → `AE_API_REPLICAS=X`
|
|
2. Run `docker compose up -d`
|
|
|
|
No home-server nginx changes needed.
|
|
|
|
### ae_app — two scaling options
|
|
|
|
**Option A (recommended): Route through ae_web_dev (same as ae_api)**
|
|
- Home server nginx points `dev-*.oneskyit.com` at `workstation:443`
|
|
- ae_web_dev round-robins to `ae_app` replicas via Docker DNS
|
|
- No host ports needed on ae_app, no home nginx changes when scaling
|
|
- Same topology as ae_api
|
|
|
|
**Option B (current): Direct host port binding**
|
|
- Home server nginx points at `workstation:3001`, `3002`, etc.
|
|
- `AE_APP_NODE_PORT_RANGE=3001-3006` in `.env`; Docker assigns one port per replica
|
|
- Must uncomment matching entries in home server nginx upstream when adding replicas
|
|
- Maximum 6 replicas without changing the range
|
|
|
|
To scale with Option B:
|
|
1. Edit `.env` → `AE_APP_REPLICAS=X` (max 6 with current range)
|
|
2. Run `docker compose up -d ae_app`
|
|
3. Uncomment matching port entries in home server nginx upstream
|
|
4. Reload home server nginx
|
|
|
|
## 🧹 Maintenance
|
|
- **Internal Logs:** Docker handles rotation automatically (10MB limit).
|
|
- **External Proxy:** Point your home server to `[Workstation_IP]:5060`.
|