Böcker kan delas med roller (läsare, redaktör, administratör), och behörigheten kontrolleras på servern. Formulär för poster, relationer och händelser skickar med version, och en krock visar vad som skiljer och låter användaren spara ändå eller ladda om. Ifyllda Word-mallar kan importeras med förhandsgranskning. Importerade ID flyttar nu räknaren. Migrering 0007. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
135 lines
5.9 KiB
Markdown
135 lines
5.9 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.
|
||
|
||
## Köra testerna automatiskt i Gitea Actions
|
||
|
||
Kör typkontroll och tester vid varje push och pull request, innan imagen byggs. Databastesterna behöver en PostgreSQL-tjänst; databasen måste heta något som slutar på `_test` (testerna lägger själva på `_test` om det saknas).
|
||
|
||
**Utkast till `.gitea/workflows/test.yml`**
|
||
|
||
```yaml
|
||
name: Tester
|
||
|
||
on:
|
||
push:
|
||
branches: [main]
|
||
pull_request:
|
||
|
||
jobs:
|
||
test:
|
||
runs-on: ubuntu-latest
|
||
services:
|
||
postgres:
|
||
image: postgres:16
|
||
env:
|
||
POSTGRES_USER: test
|
||
POSTGRES_PASSWORD: test
|
||
POSTGRES_DB: bookmanager
|
||
env:
|
||
DATABASE_URL: postgresql://test:test@postgres:5432/bookmanager
|
||
steps:
|
||
- uses: actions/checkout@v4
|
||
- uses: actions/setup-node@v4
|
||
with:
|
||
node-version: 22
|
||
cache: npm
|
||
- run: npm ci
|
||
- run: npx prisma generate
|
||
- run: npm run typecheck
|
||
- run: npm test
|
||
```
|
||
|
||
Samma `act_runner` som för publiceringen räcker. Tjänstecontainern nås som `postgres` när jobbet körs i en container; om runnern kör direkt på värden byts adressen mot `localhost` och en publicerad port. Låt publiceringsflödet vänta på testerna (`needs: test`) när båda finns på plats.
|
||
|
||
## Verifiera
|
||
|
||
- Importen från Word är provad mot de blanka mallarna i `Mall/` och `Register/` och mot versioner jag fyllt i på de sätt som beskrivs i README. Prova med några av dina egna ifyllda dokument och berätta vad som tolkas fel, särskilt hur du markerar val (X, symbol eller ruta) och var du skriver värden.
|
||
- Delning: logga in som en andra användare med riktiga Authentik-konton och prova rollerna (läsare, redaktör, administratör) i en delad bok.
|
||
|
||
- 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
|
||
|
||
- Delning med en inbjudningslänk (roll och giltighetstid) för den som inte har loggat in än. Idag delas bara med e-postadressen till en befintlig användare.
|
||
- Skydd mot kolliderande ändringar även i mallredigeraren, bokinställningarna och kartmarkeringar. Idag gäller det poster, relationer och händelser.
|
||
- Import från Word av scheman (Schema dag och natt) och kartregistret. De importeras inte idag.
|
||
- Visa vem som har en post öppen just nu (ett diskret märke), så att krockar undviks i förväg.
|
||
|
||
- 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.
|