docs+chore(setup): Debian 13 statt Ubuntu, versionsneutrale Doku, unattended-upgrades
- Doku auf Debian 13 "trixie" umgestellt, Python/PostgreSQL/Redis als Debian-Standard - setup_server.sh installiert und konfiguriert unattended-upgrades (kein Auto-Reboot) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
7e165d37b6
commit
119b10d943
7 files changed
+24
-13
No files matched your search
@@ -4,9 +4,9 @@ Zeiterfassung & HR-Tool (Zeiterfassung, Abwesenheiten, Kiosk-Terminals, Reports)
|
|||||||
|
|
||||||
## Tech-Stack
|
## Tech-Stack
|
||||||
|
|
||||||
- **Backend**: Python 3.12 · FastAPI · SQLAlchemy (async) · PostgreSQL 16 · Redis 7 · Alembic
|
- **Backend**: Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) · PostgreSQL (Debian-Standard) · Redis · Alembic
|
||||||
- **Frontend**: React 18 · TypeScript · Tailwind CSS · Vite
|
- **Frontend**: React 18 · TypeScript · Tailwind CSS · Vite
|
||||||
- **Deployment**: nativ auf Ubuntu (systemd + nginx), kein Docker
|
- **Deployment**: nativ auf Debian (systemd + nginx), kein Docker
|
||||||
- **Tests**: pytest + pytest-asyncio + pytest-cov
|
- **Tests**: pytest + pytest-asyncio + pytest-cov
|
||||||
|
|
||||||
## Features (Auszug)
|
## Features (Auszug)
|
||||||
|
|||||||
+4
-4
@@ -1,15 +1,15 @@
|
|||||||
# TimeMaster – agent-01-auth
|
# TimeMaster – agent-01-auth
|
||||||
|
|
||||||
Backend: Python 3.12 · FastAPI · SQLAlchemy (async) · PostgreSQL · Redis
|
Backend: Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) · PostgreSQL · Redis
|
||||||
Laufend nativ auf dem Server (kein Docker in Phase 1).
|
Laufend nativ auf dem Server (kein Docker in Phase 1).
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Voraussetzungen (Ubuntu 22.04 / 24.04)
|
## Voraussetzungen (Debian 13 "trixie")
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
sudo apt update && sudo apt install -y \
|
sudo apt update && sudo apt install -y \
|
||||||
python3.12 python3.12-venv python3.12-dev \
|
python3 python3-venv python3-dev \
|
||||||
postgresql postgresql-contrib \
|
postgresql postgresql-contrib \
|
||||||
redis-server nginx git build-essential libpq-dev
|
redis-server nginx git build-essential libpq-dev
|
||||||
```
|
```
|
||||||
@@ -46,7 +46,7 @@ sudo chown $USER:$USER /opt/timemaster
|
|||||||
git clone https://github.com/dein-repo/timemaster.git /opt/timemaster
|
git clone https://github.com/dein-repo/timemaster.git /opt/timemaster
|
||||||
|
|
||||||
cd /opt/timemaster/backend
|
cd /opt/timemaster/backend
|
||||||
python3.12 -m venv venv
|
python3 -m venv venv
|
||||||
source venv/bin/activate
|
source venv/bin/activate
|
||||||
pip install --upgrade pip
|
pip install --upgrade pip
|
||||||
pip install -r requirements.txt
|
pip install -r requirements.txt
|
||||||
|
|||||||
@@ -4,9 +4,9 @@
|
|||||||
|
|
||||||
| Schicht | Technologie |
|
| Schicht | Technologie |
|
||||||
|---------|------------|
|
|---------|------------|
|
||||||
| Backend | Python 3.12 · FastAPI · SQLAlchemy (async) |
|
| Backend | Python 3 (Debian-Standard) · FastAPI · SQLAlchemy (async) |
|
||||||
| Datenbank | PostgreSQL 16 |
|
| Datenbank | PostgreSQL (Debian-Standard) |
|
||||||
| Cache / Sessions | Redis 7 |
|
| Cache / Sessions | Redis (Debian-Standard) |
|
||||||
| Frontend | React 18 · TypeScript · Tailwind CSS |
|
| Frontend | React 18 · TypeScript · Tailwind CSS |
|
||||||
| Prozess-Manager | systemd |
|
| Prozess-Manager | systemd |
|
||||||
| Reverse Proxy | Nginx + Let's Encrypt |
|
| Reverse Proxy | Nginx + Let's Encrypt |
|
||||||
|
|||||||
@@ -8,7 +8,7 @@ Stand: 2026-05-24
|
|||||||
|
|
||||||
| Schicht | Technologie | Version |
|
| Schicht | Technologie | Version |
|
||||||
|---------|-------------|---------|
|
|---------|-------------|---------|
|
||||||
| Backend | Python / FastAPI | 3.12 / 0.115+ |
|
| Backend | Python / FastAPI | Debian-Standard / 0.115+ |
|
||||||
| ORM | SQLAlchemy async | 2.x |
|
| ORM | SQLAlchemy async | 2.x |
|
||||||
| Datenbank | PostgreSQL | 16 |
|
| Datenbank | PostgreSQL | 16 |
|
||||||
| Cache / Sessions | Redis | 7 |
|
| Cache / Sessions | Redis | 7 |
|
||||||
|
|||||||
+1
-1
@@ -11,7 +11,7 @@ Stand: 2026-05-24
|
|||||||
| Primary | 192.168.1.137 | Produktion, Tests, Primär-DB |
|
| Primary | 192.168.1.137 | Produktion, Tests, Primär-DB |
|
||||||
| Secondary | 192.168.1.164 | Replikat / Fallback |
|
| Secondary | 192.168.1.164 | Replikat / Fallback |
|
||||||
|
|
||||||
Beide Server laufen Ubuntu 22.04 oder 24.04 LTS (amd64). Kein Docker in Phase 1 – alle Dienste laufen nativ als systemd-Units.
|
Beide Server laufen Debian 13 "trixie" (amd64). Kein Docker in Phase 1 – alle Dienste laufen nativ als systemd-Units.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
|||||||
+1
-1
@@ -8,7 +8,7 @@ Stand: 2026-05-24
|
|||||||
|
|
||||||
### Voraussetzungen (lokal)
|
### Voraussetzungen (lokal)
|
||||||
|
|
||||||
- Python 3.12+
|
- Python 3 (Debian-Standard, aktuell 3.13)
|
||||||
- Node.js 20+ und npm
|
- Node.js 20+ und npm
|
||||||
- SSH-Zugang zu `root@192.168.1.137` (Tests und Datenbank laufen dort)
|
- SSH-Zugang zu `root@192.168.1.137` (Tests und Datenbank laufen dort)
|
||||||
- Git-Zugang zu `gitea.perlbach24.de/scripte/timemaster.git`
|
- Git-Zugang zu `gitea.perlbach24.de/scripte/timemaster.git`
|
||||||
|
|||||||
+12
-1
@@ -22,9 +22,20 @@ apt-get install -y \
|
|||||||
postgresql postgresql-contrib \
|
postgresql postgresql-contrib \
|
||||||
redis-server \
|
redis-server \
|
||||||
nginx \
|
nginx \
|
||||||
git curl build-essential libpq-dev openssl sudo \
|
git curl build-essential libpq-dev openssl sudo unattended-upgrades \
|
||||||
libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz0b
|
libpango-1.0-0 libpangoft2-1.0-0 libharfbuzz0b
|
||||||
|
|
||||||
|
cat > /etc/apt/apt.conf.d/20auto-upgrades <<'APTEOF'
|
||||||
|
APT::Periodic::Update-Package-Lists "1";
|
||||||
|
APT::Periodic::Unattended-Upgrade "1";
|
||||||
|
APT::Periodic::AutocleanInterval "7";
|
||||||
|
APTEOF
|
||||||
|
cat > /etc/apt/apt.conf.d/52timemaster-unattended <<'APTEOF'
|
||||||
|
Unattended-Upgrade::Automatic-Reboot "false";
|
||||||
|
Unattended-Upgrade::Remove-Unused-Dependencies "true";
|
||||||
|
APTEOF
|
||||||
|
systemctl enable --now unattended-upgrades
|
||||||
|
|
||||||
echo "==> [3/7] PostgreSQL einrichten"
|
echo "==> [3/7] PostgreSQL einrichten"
|
||||||
systemctl enable postgresql && systemctl start postgresql
|
systemctl enable postgresql && systemctl start postgresql
|
||||||
|
|
||||||
|
|||||||
Reference in new issue
Block a user