Files

T

Jonathan Miller 551307efed Complete Gitea-primary migration: templates, docs, bot identity

- All remaining github-actions[bot] → gitea-actions[bot]
- All remaining gh api calls in non-mirror steps → Gitea API curl
- COMPOSER_AUTH uses GA_TOKEN for Gitea composer registry
- 7 docs updated with correct bot identity and token refs
- gh release create/edit only remains in GitHub mirror sections

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

2026-04-16 23:00:59 -05:00

3.1 KiB

Raw Blame History

Build & Release Pipeline

Every governed repo has an auto-release.yml workflow that runs a 7-step build and release pipeline on every push to main.

Pipeline Steps

Push to main
  │
  ├─ 1. Read VERSION from README.md
  │
  ├─ 2. Create version/XX branch (snapshot)
  │
  ├─ 3. Set platform version
  │     ├─ Dolibarr: $this->version in mod*.class.php
  │     └─ Joomla: <version> in XML manifest
  │
  ├─ 4. Update [VERSION: XX.YY.ZZ] badges in markdown files
  │
  ├─ 5. Write update.txt (Dolibarr only — plain text version for checkForUpdate)
  │
  ├─ 6. Create git tag vXX.YY.ZZ
  │
  └─ 7. Create GitHub Release with changelog notes

Triggers

Push to main or master
Skips commits by gitea-actions[bot] and commits with [skip ci]
Skips if tag + branch already exist (idempotent)

What Each Step Does

Step 1: Read version

Reads VERSION: from the README.md FILE INFORMATION block using version_read.php.

Step 2: Create version branch

Creates version/XX as a frozen snapshot of main at release time. If the branch already exists, this step is skipped.

Step 3: Set platform version

Dolibarr: sets $this->version in src/core/modules/mod*.class.php to the real version AND rewrites $this->url_last_version to point to the main branch
Joomla: sets <version> in XML manifest files

Step 4: Update version badges

Finds all [VERSION: XX.YY.ZZ] badges in markdown files and updates them to the current version.

Step 5: Write update.txt

For Dolibarr repos only: writes the version number as plain text to update.txt. Dolibarr's checkForUpdate() expects raw text < 30 chars from $this->url_last_version.

Step 6: Create git tag

Creates vXX.YY.ZZ tag and pushes to remote.

Step 7: Create GitHub Release

Extracts release notes from CHANGELOG.md (section matching the version heading) and creates a GitHub Release targeting the version branch.

Version Lifecycle

Phase	Branch	Module Version	Badge	Release?
Development	`dev/**`	`"development"`	Dev version	No
Merge to main	`main`	Real version	Updated	Yes
Version bump	`main`	Auto-incremented	Updated	Next push

Workflow	Role
`sync-version-on-merge.yml`	Auto-bumps patch version in README on push to main
`auto-release.yml`	This pipeline — builds, branches, tags, releases
`deploy-dev.yml`	Deploys to dev server with version="development"
`deploy-demo.yml`	Deploys to demo with real version
`repository-cleanup.yml`	Deletes old version branches on schedule

3.1 KiB Raw Blame History