gitea-ci-library/docs/tickets/0010-report-service-retention-cronjob.md

Ticket 0010: report-service/ — retention CronJob

Vaihe: 10/12 Status: pending Feature branch: feature/0010-report-service-retention-cronjob TDD required: Yes Feature file required: No

Required context:

• docs/test-plan/tdd-guide.md
• Skills: tdd, implementation, clean-code, bash-script

---

TDD — Red-Green-Refactor

Red

Kirjoita tests/retention-cleanup.bats mock-MinIO:a ja mock-Gitea API:a vasten:

• retention-cleanup.sh --dry-run listaa poistettavat objektit
• Yli 90 vrk vanha feature-build → merkitään poistettavaksi
• Tagattu commit → ei merkitä poistettavaksi
• keepMin: 3 uusinta säilyy branchista
• ConfigMap-pohjainen retention: retention.yaml luetaan oikein

bats tests/retention-cleanup.bats
# FAIL

Green

Toteuta report-service/retention-cleanup.sh + CronJob.yaml + ConfigMap.yaml.

bats tests/retention-cleanup.bats
# PASS

Refactor

Parametrisoi retention-säännöt, paranna lokitusta.

DoD

• tests/retention-cleanup.bats — kaikki testit läpi
• report-service/retention-cleanup.sh toimii --dry-run-tilassa
• report-service/CronJob.yaml — schedule 0 3 * * *
• report-service/ConfigMap.yaml — retention.yaml oikea muoto
• Aika-, branch-, tagi- ja keepMin-säännöt toimivat

---

Toiminto

Kubernetes CronJob, joka ajaa siivousskriptin päivittäin. Skripti lukee ConfigMap-pohjaisen retention policyn ja poistaa vanhentuneet raportit MinIO:sta.

Artefaktit

report-service/retention-cleanup.sh

Skripti joka:

1. Listaa kaikki bucketin objektit (mc ls --recursive)
2. Parsii polusta repo_slug ja commit_short
3. Hakee Gitea API:sta commitin metadata (GET /api/v1/repos/{owner}/{repo}/commits/{sha} → branch, onko tagattu)
4. Soveltaa ConfigMapin retention-sääntöjä
5. Poistaa vanhentuneet (mc rm)

ConfigMap

apiVersion: v1
kind: ConfigMap
metadata:
  name: minio-report-retention
data:
  retention.yaml: |
    rules:
      - branch: "master"
        maxAgeDays: 365
        keepMin: 20
      - branch: "feature/*"
        maxAgeDays: 90
        keepMin: 5
      - tagged: true
        maxAgeDays: -1   # ei koskaan
        keepMin: -1
      - default:
        maxAgeDays: 90
        keepMin: 3

CronJob

apiVersion: batch/v1
kind: CronJob
metadata:
  name: minio-report-cleanup
spec:
  schedule: "0 3 * * *"  # kerran päivässä klo 03:00
  jobTemplate:
    spec:
      template:
        spec:
          containers:
          - name: cleanup
            image: minio/mc:latest
            command: ["/scripts/retention-cleanup.sh"]
            volumeMounts:
            - name: config
              mountPath: /etc/retention
            - name: script
              mountPath: /scripts
          volumes:
          - name: config
            configMap:
              name: minio-report-retention
          - name: script
            configMap:
              name: minio-cleanup-script

Verifiointi

1. Aja retention-cleanup.sh --dry-run → listaa poistettavat objektit
2. Tarkista: yli 90 vrk vanha feature-build → merkitään poistettavaksi
3. Tarkista: tagattu commit → ei merkitä poistettavaksi
4. Tarkista: keepMin-säännön tuorein 3 säilyy

Viitteet

• docs/report-hosting.md — Retention policy
• docs/architecture.md — report-service/-moduuli