Gitea Actions Workflows Handbook
Origin by Corvus - Enterprise Continuous Integration, Quality Gates & Deployment Quantum Tiger (Morning Bay Technology Pvt. Ltd.)
1. Architectural Overview & Workflow Matrix
Origin by Corvus utilizes Gitea Actions (compatible with GitHub Actions syntax) on the enterprise Gitea server (https://git.projectdefcorp.com) for end-to-end automation. The repository incorporates fourteen specialized workflows spanning static analysis, unit testing, container compilation, public documentation deployment, wiki synchronization, and production release management.
[ Git Push / Pull Request / Tag Push ]
│
▼
┌────────────────────────────────────────────────────────────────────────┐
│ Stage 1: Validation & Code Quality │
├────────────────────────────────────────────────────────────────────────┤
│ • ci.yml - Installer Linting, Go Vet, TS Typecheck │
│ • pr-quality-gate.yaml - Test Coverage (>60%), Cryptographic Check │
│ • api-drift.yaml - OpenAPI 3 Contract & Struct Validation │
│ • security-qa.yaml - Secrets Audit, Govulncheck, NPM Audit │
│ • migration-test.yaml - PostgreSQL Schema Up/Down & Lock Audit │
└───────────────────────────────────┬────────────────────────────────────┘
│ (Passed)
▼
┌────────────────────────────────────────────────────────────────────────┐
│ Stage 2: Packaging & Integration Testing │
├────────────────────────────────────────────────────────────────────────┤
│ • e2e-qa.yaml - Ephemeral Postgres/MinIO Playwright E2E │
│ • race-detector.yaml - Go ThreadSanitizer Concurrency Profiling │
│ • docker-publish.yml - Multi-Arch (amd64/arm64) Image Publisher │
│ • changelog.yaml - Conventional Commits Release Notes Gen │
└───────────────────────────────────┬────────────────────────────────────┘
│ (Merge / Tag Trigger)
▼
┌────────────────────────────────────────────────────────────────────────┐
│ Stage 3: Deployment & Operations Delivery │
├────────────────────────────────────────────────────────────────────────┤
│ • deploy.yaml - Coolify Continuous Deploy & Log Streamer │
│ • docs-site.yaml - Public Docusaurus Sync & Deployer │
│ • coolify-logs.yaml - Live Container Runtime Log Inspector │
│ • rollback.yaml - Emergency Commit / Tag Production Rollback │
└────────────────────────────────────────────────────────────────────────┘
2. Comprehensive Workflows Catalog
The following table summarizes all workflows registered in .gitea/workflows/:
| Workflow | Trigger | Purpose | Key Checks |
|---|---|---|---|
ci.yml | Push, PR | Baseline code health | golangci-lint, go vet, tsc, shellcheck, hadolint |
pr-quality-gate.yaml | PR | Merge-blocking quality gate | Go test coverage >60%, OpenAPI drift, cryptographic checksum |
api-drift.yaml | PR, weekly | OpenAPI contract stability | oapi-codegen round-trip validation, breaking-change detection |
security-qa.yaml | PR, daily | Supply-chain & runtime security | govulncheck, npm audit, trivy, secret scan (gitleaks) |
migration-test.yaml | PR | Database schema integrity | golang-migrate up/down, table-lock timeout audit |
e2e-qa.yaml | PR, nightly | End-to-end browser validation | Playwright matrix (Chromium/Firefox/WebKit), PostgreSQL + MinIO ephemeral |
race-detector.yaml | PR, nightly | Go concurrency safety | -race detector, go test -race ./... |
docker-publish.yaml | Tag, manual | Multi-arch container images | buildx amd64/arm64, cosign keyless signing |
changelog.yaml | Tag | Release notes generation | Conventional Commits → categorized markdown |
deploy.yaml | Tag, manual | Coolify production deployment | Zero-downtime rolling, log streaming, health-check |
docs-site.yaml | Tag, manual | Public Docusaurus sync | npm run build + docusaurus deploy to docs.origin.projectdefcorp.com |
coolify-logs.yaml | Manual | Live container log inspector | REST log tail, filter by severity |
rollback.yaml | Manual | Emergency production rollback | Commit/tag revert, DB migration down, container restart |
wiki-sync.yaml | Push to main | Gitea Wiki sync | docs/ → Origin-By-Corvus.wiki.git transform |
3. Operational Reference
3.1 Trigger Semantics
| Event | Workflows Activated |
|---|---|
push to main | ci.yml, pr-quality-gate.yaml, api-drift.yaml, security-qa.yaml, wiki-sync.yaml |
pull_request | ci.yml, pr-quality-gate.yaml, security-qa.yaml, migration-test.yaml, race-detector.yaml |
tag (v*.*.*) | docker-publish.yaml, changelog.yaml, deploy.yaml, docs-site.yaml |
schedule (daily 02:00 UTC) | security-qa.yaml, race-detector.yaml |
workflow_dispatch | deploy.yaml, docs-site.yaml, coolify-logs.yaml, rollback.yaml |
3.2 Secret Inventory (Repository Settings → Actions → Secrets)
| Secret | Purpose | Rotation |
|---|---|---|
GITEA_TOKEN | Package registry, release automation | 90 days |
COOLIFY_URL | https://server.projectdefcorp.com | Static |
COOLIFY_DEPLOY_TOKEN / COOLIFY_TOKEN | Coolify management API | 90 days |
COOLIFY_APP_UUID | bmqut3ytvlfk2yvsju2ywbr9 | Static |
COOLIFY_PROJECT_UUID | 2omxwnodfypkn2nljida2g1m | Static |
COOLIFY_ENVIRONMENT_UUID | vcv3hwepjdjixasxkfq6twb0 | Static |
COOLIFY_DOCS_APP_UUID | Public documentation app identifier | Static |
COOLIFY_FQDN | https://origin.projectdefcorp.com | Static |
3.3 Local Development Quick-Start
# Install `act` for local Actions execution
curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
# Run full CI pipeline locally (requires Docker)
act push -s GITEA_TOKEN=$(gitea_token_value)
# Run quality gate only
act pull_request -s GITEA_TOKEN=$(gitea_token_value) -j pr-quality-gate
3.3 Troubleshooting Common Failures
| Symptom | Likely Cause | Resolution |
|---|---|---|
golangci-lint timeout | Large diff, slow static analysis | Split PR, increase act timeout (--timeout 60m) |
go test -race flake | Non-deterministic race in test | Re-run workflow; investigate with go test -race -count=10 ./... |
docker-publish manifest error | Missing buildx builder | docker buildx create --name multiarch --driver docker-container --use |
| Coolify deploy health-check fail | App not ready within timeout | Increase HEALTHCHECK interval in Dockerfile, check app logs |
wiki-sync auth fail | GITEA_TOKEN expired | Regenerate in Gitea UI → Settings → Applications → Personal Access Tokens |
4. Cross-Reference Index
- CI/CD Pipeline Diagram: See §1 Architectural Overview above.
- Security & Compliance:
security-qa.yaml→govulncheck,trivy,gitleaks,npm audit. - Database Migrations:
migration-test.yaml→golang-migrateup/down idempotency. - Coolify Operations:
deploy.yaml,coolify-logs.yaml,rollback.yaml→COOLIFY_*secrets. - Public Documentation:
docs-site.yaml→docusaurus deploy→docs.origin.projectdefcorp.com.