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>
4.9 KiB
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
- Gitea Actions påslaget på instansen (
[actions] ENABLED = true) och i repots inställningar. - En
act_runnerregistrerad mot Gitea med tillgång till Docker (till exempel/var/run/docker.sockmonterad). - En åtkomsttoken i Gitea med
write:package, sparad som repo-hemlighetenREGISTRY_TOKEN. - 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
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
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 ... configoch 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-initger skrivrätt till./data/backupsoch./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_EMAILSochTZger rätt administratör och rätt tid för säkerhetskopian. - Att
/api/metricsfungerar mot din Prometheus (sättMETRICS_TOKEN).
- Att
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.