# 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.