openova/platform/gitea

Gitea

Self-hosted Git and CI/CD for OpenOva platform.

Status: Accepted | Updated: 2026-01-17

---

Overview

Gitea provides self-hosted Git with CI/CD capabilities:

• Internal Git repository hosting
• Gitea Actions (GitHub Actions compatible)
• Bidirectional mirroring for multi-region
• CNPG PostgreSQL backend

---

Architecture

flowchart TB
    subgraph Gitea["Gitea"]
        Web[Web UI]
        Git[Git Server]
        Actions[Gitea Actions]
    end

    subgraph Backend["Backend"]
        CNPG[CNPG Postgres]
        MinIO[MinIO Storage]
    end

    subgraph Integrations
        Flux[Flux CD]
        Catalyst console[Catalyst console]
    end

    Web --> CNPG
    Git --> CNPG
    Actions --> MinIO
    Flux -->|"Clone"| Git
    Catalyst console -->|"Discover"| Git

---

Multi-Region Mirroring

flowchart LR
    subgraph Region1["Region 1"]
        G1[Gitea 1]
    end

    subgraph Region2["Region 2"]
        G2[Gitea 2]
    end

    G1 <-->|"Bidirectional Mirror"| G2

Both Gitea instances maintain full repository copies. Each Flux installation pulls from its local Gitea.

---

Configuration

Gitea Deployment

apiVersion: apps/v1
kind: Deployment
metadata:
  name: gitea
  namespace: gitea
spec:
  replicas: 1
  template:
    spec:
      containers:
        - name: gitea
          image: gitea/gitea:1.21
          env:
            - name: GITEA__database__DB_TYPE
              value: postgres
            - name: GITEA__database__HOST
              value: gitea-postgres-rw.databases.svc:5432
            - name: GITEA__storage__STORAGE_TYPE
              value: minio
            - name: GITEA__storage__MINIO_ENDPOINT
              value: minio.storage.svc:9000

Mirror Configuration

# app.ini
[mirror]
ENABLED = true
DISABLE_NEW_PULL = false
DISABLE_NEW_PUSH = false
DEFAULT_INTERVAL = 1m

---

Gitea Actions

GitHub Actions compatible CI/CD:

# .gitea/workflows/ci.yaml
name: CI
on:
  push:
    branches: [main]

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: make build
      - name: Test
        run: make test

Actions Runner

apiVersion: apps/v1
kind: Deployment
metadata:
  name: gitea-runner
  namespace: gitea
spec:
  replicas: 2
  template:
    spec:
      containers:
        - name: runner
          image: gitea/act_runner:latest
          env:
            - name: GITEA_INSTANCE_URL
              value: https://gitea.<domain>
            - name: GITEA_RUNNER_REGISTRATION_TOKEN
              valueFrom:
                secretKeyRef:
                  name: gitea-runner-token
                  key: token

---

Integration Points

Integration	Purpose
Flux CD	GitOps source repository
Catalyst console	Repository discovery, templates
External Secrets	Token management
CNPG	PostgreSQL database
MinIO	LFS and Actions storage

---

Backup

Gitea data is backed up via:

• CNPG for PostgreSQL (WAL streaming)
• MinIO replication for storage
• Repository mirror for redundancy

---

Part of OpenOva