- Automatisk nattlig säkerhetskopiering (zip per bok med bilder), schemaläggare via instrumentation, adminsida med manuell körning och nedladdning - Papperskorg för poster (ögonblicksbild med relationer, scheman, markeringar) och böcker (zip), återställning och automatisk rensning - Ändringshistorik för poster med fältvis diff och återställning - Härdning: säkerhetsrubriker och CSP via middleware, hastighetsbegränsning, lagringskvot per användare, konfigurerbar sessionstid - Bildoptimering med sharp (EXIF-rotation, nedskalning, metadata borttagen) och miniatyrer - Strukturerade JSON-loggar, onRequestError och Prometheus-mätvärden på /api/metrics - Snabbsök och kommandopalett (Ctrl+K) med sökning i poster och mallfält - Migration 0005_system, nya volymer och miljövariabler, versionsinfo via build-args - README, .env.example och TODO uppdaterade Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
87 lines
3.7 KiB
Markdown
87 lines
3.7 KiB
Markdown
# Att göra senare
|
||
|
||
## Automatisk bygg och publicering med Gitea Actions
|
||
|
||
Bygg och publicera imagen till `gitea.labsconnect.se` automatiskt vid push till `main` och vid versionstaggar. Uppdateringen av prod behålls manuell (`pull` och `up -d`).
|
||
|
||
**Behövs först**
|
||
|
||
1. Gitea Actions påslaget på instansen (`[actions] ENABLED = true`) och i repots inställningar.
|
||
2. En `act_runner` registrerad mot Gitea med tillgång till Docker (till exempel `/var/run/docker.sock` monterad).
|
||
3. En åtkomsttoken i Gitea med `write:package`, sparad som repo-hemligheten `REGISTRY_TOKEN`.
|
||
4. Om runnern körs på samma maskin som Gitea kan den pusha via en intern adress och slippa proxyn.
|
||
|
||
**Utkast till `.gitea/workflows/publish.yml`**
|
||
|
||
```yaml
|
||
name: Bygg och publicera image
|
||
|
||
on:
|
||
push:
|
||
branches: [main]
|
||
tags: ["v*"]
|
||
|
||
env:
|
||
REGISTRY: gitea.labsconnect.se
|
||
IMAGE: gitea.labsconnect.se/bobban/bookmanager
|
||
|
||
jobs:
|
||
publish:
|
||
runs-on: ubuntu-latest
|
||
steps:
|
||
- uses: actions/checkout@v4
|
||
|
||
- name: Bestäm taggar
|
||
id: tags
|
||
run: |
|
||
SHA7=$(echo "${{ gitea.sha }}" | cut -c1-7)
|
||
if [ "${{ gitea.ref_type }}" = "tag" ]; then
|
||
VERSION="${{ gitea.ref_name }}"
|
||
VERSION="${VERSION#v}"
|
||
echo "list=$IMAGE:$VERSION,$IMAGE:latest" >> "$GITHUB_OUTPUT"
|
||
else
|
||
echo "list=$IMAGE:main-$SHA7,$IMAGE:latest" >> "$GITHUB_OUTPUT"
|
||
fi
|
||
|
||
- uses: docker/setup-buildx-action@v3
|
||
|
||
- uses: docker/login-action@v3
|
||
with:
|
||
registry: ${{ env.REGISTRY }}
|
||
username: ${{ gitea.actor }}
|
||
password: ${{ secrets.REGISTRY_TOKEN }}
|
||
|
||
- uses: docker/build-push-action@v6
|
||
with:
|
||
context: .
|
||
target: prod
|
||
push: true
|
||
tags: ${{ steps.tags.outputs.list }}
|
||
build-args: |
|
||
APP_VERSION=${{ gitea.ref_type == 'tag' && gitea.ref_name || 'main' }}
|
||
APP_COMMIT=${{ gitea.sha }}
|
||
cache-from: type=registry,ref=${{ env.IMAGE }}:buildcache
|
||
cache-to: type=registry,ref=${{ env.IMAGE }}:buildcache,mode=max
|
||
```
|
||
|
||
**Släppa en version:** `git tag v1.0.3 && git push --tags`, och sätt sedan `APP_IMAGE=gitea.labsconnect.se/bobban/bookmanager:1.0.3` i `.env` på servern.
|
||
|
||
**Valfritt:** automatisk uppdatering av prod (Watchtower, eller ett SSH-steg som bara körs på versionstaggar). Rekommendation: vänta tills flödet känns tryggt.
|
||
|
||
## Verifiera
|
||
|
||
- Ladda upp en stor kartbild (10–15 MB). Gränsen för förfrågningar via inloggningskontrollen höjdes till 300 MB i samband med import och export, men en stor kartbild är inte testad.
|
||
- Kör Docker-filerna på riktigt (`docker compose ... config` och en full start). Dev- och prod-compose har inte körts i miljön där koden skrevs.
|
||
- Bygg imagen med den mindre Dockerfile och jämför storleken mot den gamla.
|
||
- Efter uppdateringen med säkerhetskopior, papperskorg och bildoptimering (testat lokalt, men inte i Docker):
|
||
- Att `sharp` (bildbehandling) installeras och fungerar i imagen (Debian, linux-x64) och att bilder skalas vid uppladdning.
|
||
- Att `uploads-init` ger skrivrätt till `./data/backups` och `./data/trash`, och att nattens säkerhetskopia skapas där.
|
||
- Att Content-Security-Policy inte stör inloggningen mot Authentik (omdirigeringen till och från Authentik) i en riktig miljö.
|
||
- Att `ADMIN_EMAILS` och `TZ` ger rätt administratör och rätt tid för säkerhetskopian.
|
||
- Att `/api/metrics` fungerar mot din Prometheus (sätt `METRICS_TOKEN`).
|
||
|
||
## Idéer
|
||
|
||
- Flera val i kopplingsfält (till exempel flera lokaler för ett företag). Idag är det en koppling per fält.
|
||
- Äldre år i namngeneratorn har färre namn, eftersom SCB bara publicerar de 200 vanligaste namnen totalt för födda före 1998.
|