OneDev mirror of an upstream gitforge repo

This project is a pull-only mirror of an upstream repository. The upstream forge is the source of truth; this project keeps a read-only copy in sync for browsing and for feature-branch development in OneDev workspaces (PRs are opened upstream).

Layout

• Default branch mirror-spec — carries this .onedev-buildspec.yml (the cron Pull from Remote job) and this README. It is a project-local branch that does not exist upstream, so the sync never touches it.
• main and other branches/tags — mirrored copies of the upstream refs, updated by the cron job (fast-forward only). Feature branches pushed here but not present upstream are left untouched by the sync.

The mirror job

Mirror from upstream (cron, hourly) runs a Pull from Remote step:

• refs/heads/* refs/tags/* pulled from upstream
• force: false → updates must fast-forward; anything that diverges (e.g. a local-only branch that later collides with an upstream name) fails the job loudly instead of clobbering work.

Working on feature branches

1. Push a feature branch here (e.g. feat/foo) and open a workspace on it.
2. Rebase onto the freshly-mirrored main, then when it's in good shape push the branch upstream and open the PR there.
3. After merge, delete the branch here.

Guardrails

• Keep local feature-branch names distinct from upstream branch/tag names.
• Don't push to main here — upstream is the source of truth for it.
• The mirror is pull-only; no write-back to upstream is configured.