Commit 91be44fd authored by xuwang's avatar xuwang
Browse files

docs: correct mirror sync timing (~5 min, not seconds) 



GitLab refreshes push mirrors at most once every ~5 minutes; reflect that in
the README/CLAUDE mirror notes.

Co-Authored-By: default avatarClaude Opus 4.8 <noreply@anthropic.com>
parent 90027998

CLAUDE.md

+1 −1
Original line number Diff line number Diff line
@@ -72,7 +72,7 @@ The `MAKELEVEL` guard prevents re-running on recursive make calls. The checkout 


`VERSION` (repo root) is the semver source of truth; releases are git tags `vX.Y.Z` with a generated `CHANGELOG.md` and a GitLab Release. `makefiles/release.mk` (included by the top-level `Makefile`, developer-only) drives `version` / `release-preview` / `release` / `release-{patch,minor,major}` via the `otica-version.sh`, `otica-changelog.sh`, `otica-release.sh` scripts. Releases publish to the canonical remote (`OTICA_RELEASE_REMOTE`, default `origin` = code.stanford.edu) and authenticate to the **OTICA hosting server** with `OTICA_SERVER_TOKEN[_FILE]` — distinct from a consumer's `GITLAB_TOKEN`.



**Mirroring:** code.stanford.edu is canonical; gitlab.med is an automatic **push mirror** (branches + tags), so a release pushed to `origin` reaches med within seconds. Never release to or push directly at med — it's overwritten to match code. GitLab Release *objects* aren't mirrored (only tags), which is all consumers need to pin.

**Mirroring:** code.stanford.edu is canonical; gitlab.med is an automatic **push mirror** (branches + tags), so a release pushed to `origin` reaches med on the next mirror sync (GitLab rate-limits push mirrors to about once every 5 minutes). Never release to or push directly at med — it's overwritten to match code. GitLab Release *objects* aren't mirrored (only tags), which is all consumers need to pin.



`CHANGELOG.md` is generated from `Changelog:` git trailers (config in `.gitlab/changelog_config.yml`). Consumers pin a release via `OTICA_VERSION` and are nudged to upgrade by `otica-upgrade-check.sh` (release-tag-aware). See the [README](README.md) "Releases & Versioning" and [CONTRIBUTING.md](CONTRIBUTING.md).

README.md

+3 −2
Original line number Diff line number Diff line
@@ -126,8 +126,9 @@ prompting for confirmation before any mutation. 
`code.stanford.edu/iac/cloud-framework` is the **canonical source of truth**.

`gitlab.med.stanford.edu/otica/cloud-framework` is an **automatic push mirror**

of it (branches **and** tags), so a release pushed to `origin` propagates to med

within seconds — no second publish step. Consumers may clone from **either** host

and pin the same `vX.Y.Z` tags.

with no second publish step. GitLab refreshes push mirrors **at most once every

~5 minutes**, so allow a few minutes for a new tag to appear on med. Consumers

may clone from **either** host and pin the same `vX.Y.Z` tags.



```

                make release  →  origin (code.stanford.edu)   ← canonical