Compare commits
9 Commits
f24c173432
...
v1.0.1
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
2bc0a19ada | ||
|
|
9c75357150 | ||
| d3c6994d75 | |||
|
|
55ec4e653b | ||
|
|
8b029ade77 | ||
|
|
8b813c7e20 | ||
|
|
9dd62999bd | ||
| d7e3545a84 | |||
|
|
e4150d0bc3 |
@@ -13,3 +13,8 @@ COOKIE_SECURE=false
|
|||||||
# Auf true setzen, wenn hinter HTTPS/TLS-Terminierung (Reverse Proxy)
|
# Auf true setzen, wenn hinter HTTPS/TLS-Terminierung (Reverse Proxy)
|
||||||
ADMIN_BOOTSTRAP_EMAIL=admin@internal.local
|
ADMIN_BOOTSTRAP_EMAIL=admin@internal.local
|
||||||
ADMIN_BOOTSTRAP_PASSWORD=ChangeMe123!
|
ADMIN_BOOTSTRAP_PASSWORD=ChangeMe123!
|
||||||
|
# true = setzt Passwort/Rolle/Status des Bootstrap-Admins bei jedem Start
|
||||||
|
# auf die obigen Werte zurueck (auch wenn der User schon existiert).
|
||||||
|
# Nach erfolgreichem Login wieder auf false setzen, damit UI-Passwortaenderungen
|
||||||
|
# nicht beim naechsten Neustart ueberschrieben werden.
|
||||||
|
ADMIN_BOOTSTRAP_RESET=false
|
||||||
|
|||||||
@@ -28,20 +28,6 @@ jobs:
|
|||||||
- name: Docker Buildx einrichten
|
- name: Docker Buildx einrichten
|
||||||
uses: docker/setup-buildx-action@v3
|
uses: docker/setup-buildx-action@v3
|
||||||
|
|
||||||
- name: Registry-Anmeldung prüfen (Diagnose)
|
|
||||||
env:
|
|
||||||
REG_USER: ${{ secrets.REGISTRY_USER || github.repository_owner }}
|
|
||||||
REG_TOKEN: ${{ secrets.REGISTRY_TOKEN }}
|
|
||||||
run: |
|
|
||||||
echo "Registry: ${REGISTRY}"
|
|
||||||
echo "Username: '${REG_USER}' (Laenge: ${#REG_USER})"
|
|
||||||
echo "Token gesetzt: $([ -n "${REG_TOKEN}" ] && echo ja || echo NEIN) (Laenge: ${#REG_TOKEN})"
|
|
||||||
echo "--- Test 1: /v2/ mit Basic-Auth ---"
|
|
||||||
curl -s -o /dev/null -w "HTTP %{http_code}\n" -u "${REG_USER}:${REG_TOKEN}" "https://${REGISTRY}/v2/"
|
|
||||||
echo "--- Test 2: Token-Endpoint (Bearer-Flow) ---"
|
|
||||||
curl -s -o /dev/null -w "HTTP %{http_code}\n" -u "${REG_USER}:${REG_TOKEN}" \
|
|
||||||
"https://${REGISTRY}/v2/token?scope=repository:${IMAGE_NAME}:pull,push&service=container_registry" || true
|
|
||||||
|
|
||||||
- name: An Gitea Container Registry anmelden
|
- name: An Gitea Container Registry anmelden
|
||||||
uses: docker/login-action@v3
|
uses: docker/login-action@v3
|
||||||
with:
|
with:
|
||||||
|
|||||||
69
README.md
69
README.md
@@ -7,8 +7,8 @@ Produktionsnahes internes Tool zur Erstellung von Thomas-Krenn.AG Newslettern au
|
|||||||
- Login und Benutzerverwaltung mit RBAC (`admin`, `editor`, `reader`)
|
- Login und Benutzerverwaltung mit RBAC (`admin`, `editor`, `reader`)
|
||||||
- Verpflichtender CSRF-Schutz auf allen POST-Formularen
|
- Verpflichtender CSRF-Schutz auf allen POST-Formularen
|
||||||
- Filter in der Web-UI:
|
- Filter in der Web-UI:
|
||||||
- Zeitraum in Tagen
|
- Zeitraum in Tagen oder „Letzter Monat“
|
||||||
- Nur bearbeitete Artikel
|
- Artikel-Auswahl: alle, nur neue oder nur bearbeitete Artikel
|
||||||
- Kategorie
|
- Kategorie
|
||||||
- Redaktioneller Feinschliff pro Ausgabe:
|
- Redaktioneller Feinschliff pro Ausgabe:
|
||||||
- **Redaktionsnotiz** – optionaler Hinweistext, der als eigene Box im Newsletter erscheint
|
- **Redaktionsnotiz** – optionaler Hinweistext, der als eigene Box im Newsletter erscheint
|
||||||
@@ -25,7 +25,7 @@ Produktionsnahes internes Tool zur Erstellung von Thomas-Krenn.AG Newslettern au
|
|||||||
- Verteilerlisten
|
- Verteilerlisten
|
||||||
- tägliche Zeitplanung
|
- tägliche Zeitplanung
|
||||||
- Versandprotokoll
|
- Versandprotokoll
|
||||||
- Docker/Compose Betrieb
|
- Docker/Compose Betrieb, inkl. automatischem Image-Build & Push in die Gitea Container Registry (per Versions-Tag)
|
||||||
|
|
||||||
## Start mit Docker
|
## Start mit Docker
|
||||||
|
|
||||||
@@ -50,6 +50,69 @@ Produktionsnahes internes Tool zur Erstellung von Thomas-Krenn.AG Newslettern au
|
|||||||
4. Zugriff:
|
4. Zugriff:
|
||||||
- [http://localhost:8080/login](http://localhost:8080/login) (oder dein `HOST_PORT`)
|
- [http://localhost:8080/login](http://localhost:8080/login) (oder dein `HOST_PORT`)
|
||||||
|
|
||||||
|
## Container-Image (Gitea Packages)
|
||||||
|
|
||||||
|
Fertige Images werden automatisch in die Gitea Container Registry veröffentlicht:
|
||||||
|
|
||||||
|
```
|
||||||
|
git.hexahost.dev/smueller/tk-wiki-newsletter
|
||||||
|
```
|
||||||
|
|
||||||
|
Verfügbare Tags: `latest`, die Version (`X.Y.Z`, `X.Y`, `X`) sowie der kurze Commit-SHA.
|
||||||
|
|
||||||
|
Image ziehen und mit vorhandener `.env` starten:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker login git.hexahost.dev
|
||||||
|
docker pull git.hexahost.dev/smueller/tk-wiki-newsletter:latest
|
||||||
|
docker run -d --name tk-newsletter-admin \
|
||||||
|
--env-file .env \
|
||||||
|
-p 8080:8000 \
|
||||||
|
-v newsletter_data:/app/data \
|
||||||
|
git.hexahost.dev/smueller/tk-wiki-newsletter:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
Alternativ in `docker-compose.yml` statt `build: .` das Image referenzieren:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
services:
|
||||||
|
newsletter-admin:
|
||||||
|
image: git.hexahost.dev/smueller/tk-wiki-newsletter:latest
|
||||||
|
# build: . # <- nicht mehr nötig, wenn das fertige Image genutzt wird
|
||||||
|
```
|
||||||
|
|
||||||
|
### Automatischer Build (CI/CD)
|
||||||
|
|
||||||
|
Der Workflow `.gitea/workflows/docker-build.yml` baut und pusht das Image über Gitea Actions.
|
||||||
|
|
||||||
|
- **Auslöser**: nur beim Setzen eines Versions-Tags `v*` (kein Build bei normalen Pushes auf `dev`/`main`).
|
||||||
|
- **Release-Ablauf** (Build bei Merge `dev` → `main` mit Version):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git checkout main
|
||||||
|
git merge --no-ff dev
|
||||||
|
git push origin main
|
||||||
|
git tag v1.0.0
|
||||||
|
git push origin v1.0.0 # <- startet Build & Push
|
||||||
|
```
|
||||||
|
|
||||||
|
- **Benötigte Repo-Secrets** (Settings → Actions → Secrets):
|
||||||
|
- `REGISTRY_TOKEN`: Gitea Access-Token mit Scope **Package: Read and write**
|
||||||
|
- `REGISTRY_USER` (optional): Registry-Benutzername, falls abweichend vom Repo-Owner
|
||||||
|
- **Optionale Repo-Variable**: `REGISTRY`, um den Registry-Host zu überschreiben (Default `git.hexahost.dev`).
|
||||||
|
|
||||||
|
## Admin-Login & Passwort zurücksetzen
|
||||||
|
|
||||||
|
- Das Login erfolgt über **E-Mail + Passwort** (kein separater Benutzername). Beim ersten Start wird der Admin aus `ADMIN_BOOTSTRAP_EMAIL` / `ADMIN_BOOTSTRAP_PASSWORD` angelegt.
|
||||||
|
- **Wichtig:** Existiert der Admin bereits (persistente DB im Volume `newsletter_data`), wird eine spätere Passwort-Änderung in der `.env` normalerweise **nicht** übernommen.
|
||||||
|
- Um Passwort/Rolle/Status auf die `.env`-Werte zurückzusetzen: `ADMIN_BOOTSTRAP_RESET=true` setzen und Container neu starten:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
docker compose up -d --force-recreate
|
||||||
|
```
|
||||||
|
|
||||||
|
Nach erfolgreichem Login `ADMIN_BOOTSTRAP_RESET=false` setzen, damit UI-Passwortänderungen nicht bei jedem Neustart überschrieben werden.
|
||||||
|
|
||||||
## Sicherheits-Hinweise für Produktion
|
## Sicherheits-Hinweise für Produktion
|
||||||
|
|
||||||
- Reverse Proxy (z. B. Nginx/Traefik) mit TLS vor den Container setzen.
|
- Reverse Proxy (z. B. Nginx/Traefik) mit TLS vor den Container setzen.
|
||||||
|
|||||||
@@ -13,6 +13,9 @@ class Settings(BaseSettings):
|
|||||||
cookie_secure: bool = False
|
cookie_secure: bool = False
|
||||||
admin_bootstrap_email: str = "admin@internal.local"
|
admin_bootstrap_email: str = "admin@internal.local"
|
||||||
admin_bootstrap_password: str = "ChangeMe123!"
|
admin_bootstrap_password: str = "ChangeMe123!"
|
||||||
|
# Wenn true: setzt Passwort/Rolle/Status des Bootstrap-Admins beim Start
|
||||||
|
# auf die .env-Werte zurück (auch wenn der User bereits existiert).
|
||||||
|
admin_bootstrap_reset: bool = False
|
||||||
|
|
||||||
model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8")
|
model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8")
|
||||||
|
|
||||||
|
|||||||
@@ -97,6 +97,12 @@ def _bootstrap_admin() -> None:
|
|||||||
try:
|
try:
|
||||||
existing = db.query(User).filter(User.email == settings.admin_bootstrap_email).first()
|
existing = db.query(User).filter(User.email == settings.admin_bootstrap_email).first()
|
||||||
if existing:
|
if existing:
|
||||||
|
if settings.admin_bootstrap_reset:
|
||||||
|
existing.password_hash = hash_password(settings.admin_bootstrap_password)
|
||||||
|
existing.is_admin = True
|
||||||
|
existing.role = "admin"
|
||||||
|
existing.is_active = True
|
||||||
|
db.commit()
|
||||||
return
|
return
|
||||||
user = User(
|
user = User(
|
||||||
email=settings.admin_bootstrap_email,
|
email=settings.admin_bootstrap_email,
|
||||||
|
|||||||
@@ -11,7 +11,7 @@
|
|||||||
<form method="post" action="/login" class="form-grid">
|
<form method="post" action="/login" class="form-grid">
|
||||||
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
|
<input type="hidden" name="csrf_token" value="{{ csrf_token }}">
|
||||||
<label>E-Mail
|
<label>E-Mail
|
||||||
<input type="email" name="email" required autocomplete="username" placeholder="name@firma.de">
|
<input type="email" name="email" required autocomplete="username">
|
||||||
</label>
|
</label>
|
||||||
<label>Passwort
|
<label>Passwort
|
||||||
<input type="password" name="password" required autocomplete="current-password">
|
<input type="password" name="password" required autocomplete="current-password">
|
||||||
|
|||||||
Reference in New Issue
Block a user