Vitest med enhetstester utan databas och databastester mot en egen testdatabas vars namn måste sluta på _test. Rättar tomma MAP_*-värden i .env och säkerhetskopior med å, ä och ö i filnamnet. Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
127 lines
4.9 KiB
Markdown
127 lines
4.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
|
||
|
||
- 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.
|