Skip to main content

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/:

WorkflowTriggerPurposeKey Checks
ci.ymlPush, PRBaseline code healthgolangci-lint, go vet, tsc, shellcheck, hadolint
pr-quality-gate.yamlPRMerge-blocking quality gateGo test coverage >60%, OpenAPI drift, cryptographic checksum
api-drift.yamlPR, weeklyOpenAPI contract stabilityoapi-codegen round-trip validation, breaking-change detection
security-qa.yamlPR, dailySupply-chain & runtime securitygovulncheck, npm audit, trivy, secret scan (gitleaks)
migration-test.yamlPRDatabase schema integritygolang-migrate up/down, table-lock timeout audit
e2e-qa.yamlPR, nightlyEnd-to-end browser validationPlaywright matrix (Chromium/Firefox/WebKit), PostgreSQL + MinIO ephemeral
race-detector.yamlPR, nightlyGo concurrency safety-race detector, go test -race ./...
docker-publish.yamlTag, manualMulti-arch container imagesbuildx amd64/arm64, cosign keyless signing
changelog.yamlTagRelease notes generationConventional Commits → categorized markdown
deploy.yamlTag, manualCoolify production deploymentZero-downtime rolling, log streaming, health-check
docs-site.yamlTag, manualPublic Docusaurus syncnpm run build + docusaurus deploy to docs.origin.projectdefcorp.com
coolify-logs.yamlManualLive container log inspectorREST log tail, filter by severity
rollback.yamlManualEmergency production rollbackCommit/tag revert, DB migration down, container restart
wiki-sync.yamlPush to mainGitea Wiki syncdocs/ → Origin-By-Corvus.wiki.git transform

3. Operational Reference​

3.1 Trigger Semantics​

EventWorkflows Activated
push to mainci.yml, pr-quality-gate.yaml, api-drift.yaml, security-qa.yaml, wiki-sync.yaml
pull_requestci.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_dispatchdeploy.yaml, docs-site.yaml, coolify-logs.yaml, rollback.yaml

3.2 Secret Inventory (Repository Settings → Actions → Secrets)​

SecretPurposeRotation
GITEA_TOKENPackage registry, release automation90 days
COOLIFY_URLhttps://server.projectdefcorp.comStatic
COOLIFY_DEPLOY_TOKEN / COOLIFY_TOKENCoolify management API90 days
COOLIFY_APP_UUIDbmqut3ytvlfk2yvsju2ywbr9Static
COOLIFY_PROJECT_UUID2omxwnodfypkn2nljida2g1mStatic
COOLIFY_ENVIRONMENT_UUIDvcv3hwepjdjixasxkfq6twb0Static
COOLIFY_DOCS_APP_UUIDPublic documentation app identifierStatic
COOLIFY_FQDNhttps://origin.projectdefcorp.comStatic

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​

SymptomLikely CauseResolution
golangci-lint timeoutLarge diff, slow static analysisSplit PR, increase act timeout (--timeout 60m)
go test -race flakeNon-deterministic race in testRe-run workflow; investigate with go test -race -count=10 ./...
docker-publish manifest errorMissing buildx builderdocker buildx create --name multiarch --driver docker-container --use
Coolify deploy health-check failApp not ready within timeoutIncrease HEALTHCHECK interval in Dockerfile, check app logs
wiki-sync auth failGITEA_TOKEN expiredRegenerate 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-migrate up/down idempotency.
  • Coolify Operations: deploy.yaml, coolify-logs.yaml, rollback.yaml → COOLIFY_* secrets.
  • Public Documentation: docs-site.yaml → docusaurus deploy → docs.origin.projectdefcorp.com.