You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 8e11572
Browse filesBrowse the repository at this point in the historyBrowse files
docs: ImportRepo update contract and lifecycle user docs (FU-22, #26, #27)
- user-guide(.zh).md: new section 2.6 "ImportRepo lifecycle", the home of
the ImportRepo update/removal/retention contract and of the operator CLI
`mega2 import-repo remove` (usage, prerequisites, outcome lines and exit
codes, continuation, ledger checks, recovery after a kill, legacy mount
exceptions); section 4.6 for the HTTP removal endpoint; a CLI table row.
Wording that contradicted the update contract is scoped to Monorepo
paths (2.1, 4.2, the MONO_PATH_NOT_ALLOWED note, the write-queue claims
in section 1 and 4.1).
- quick-start(.zh).md: the migration example gains a second push, mirror
sync (with the LFS steps) and removal with the CLI inside the container.
- README(.zh).md: one contract sentence (later pushes accepted; removal via
POST /api/v1/import-repo/remove with a token, or the CLI on
push_auth=none deployments).
- errors.md: the ImportRepo rows and the cleanup scenarios name the CLI
and its exit code.
No code change. C/D coverage comes from FU-23. Plan:
docs/plan/plan-20260923.md (FU-22; DEFER-FU-49).
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Signed-off-by: Eli Ma <eli@patch.sh>
Copy file name to clipboardExpand all lines: README.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,7 +24,7 @@ Use `libra mega2 browser --server https://mega2.example.com` to browse a remote
24
24
25
25
Mega2 provides trunk-based Git storage and hosting for monorepos. Regular Monorepo paths expose `refs/heads/main` as the public trunk; Git clients cannot push other branches or tags. Use the HTTP API or Libra's terminal browser for supported Tag and directory operations. The open-source edition does not include the multi-branch Change List feature.
26
26
27
-
Git metadata is stored in Postgres, while Git objects live in local or S3-compatible object storage. ImportRepos under `[monorepo].import_dir` (default `/third-party`) follow ordinary Git semantics, including multiple branches and client-managed tags, and can hold third-party repositories that need independent synchronization. See [Monorepo path policy and first use](docs/user-guide.md#25-monorepo-path-policy-and-first-use) for path provisioning and push rules.
27
+
Git metadata is stored in Postgres, while Git objects live in local or S3-compatible object storage. ImportRepos under `[monorepo].import_dir` (default `/third-party`) follow ordinary Git semantics, including multiple branches and client-managed tags, and can hold third-party repositories that need independent synchronization. ImportRepos accept later pushes (branches and tags) and can be removed through `POST /api/v1/import-repo/remove` (which needs a push token; `push_auth=none` deployments run `mega2 import-repo remove` on the server instead); see [ImportRepo lifecycle](docs/user-guide.md#26-importrepo-lifecycle). See [Monorepo path policy and first use](docs/user-guide.md#25-monorepo-path-policy-and-first-use) for path provisioning and push rules.
- 例:`{"req_result":false,"data":null,"err_message":"IMPORT_REPO_HAS_CHILDREN: \"/third-party/p\" contains other ImportRepos; remove them first"}`、`{"req_result":false,"data":null,"err_message":"IMPORT_REPO_CLEANUP_NOT_FOUND: no cleanup \"12\" for \"/third-party/p\""}`。
0 commit comments