后台管理迁移开源项目失败重试按钮
This commit is contained in:
+19
-8
@@ -918,7 +918,7 @@ URDF 缺失或大小不符时拒绝创建,不留下项目和任务。收到 20
|
||||
|
||||
```ts
|
||||
type ImportStatus = 'QUEUED' | 'RUNNING' | 'SUCCEEDED' | 'FAILED' | 'REVIEW';
|
||||
type ImportPhase = 'QUEUED' | 'PRECHECK' | 'MIGRATING' | 'MIGRATED'
|
||||
type ImportPhase = 'QUEUED' | 'CLEANING' | 'PRECHECK' | 'MIGRATING' | 'MIGRATED'
|
||||
| 'NORMALIZING' | 'BRANCH_READY' | 'LINKED';
|
||||
|
||||
interface TaskView {
|
||||
@@ -927,6 +927,8 @@ interface TaskView {
|
||||
status: ImportStatus;
|
||||
phase: ImportPhase;
|
||||
errorCode: string | null;
|
||||
canRetry: boolean;
|
||||
retryMessage: string | null;
|
||||
warnings: string[];
|
||||
createdAt: UtcDateTime;
|
||||
startedAt: UtcDateTime | null;
|
||||
@@ -946,6 +948,8 @@ interface TaskView {
|
||||
"status": "QUEUED",
|
||||
"phase": "QUEUED",
|
||||
"errorCode": null,
|
||||
"canRetry": false,
|
||||
"retryMessage": null,
|
||||
"warnings": [],
|
||||
"createdAt": "2026-10-20T02:30:00",
|
||||
"startedAt": null,
|
||||
@@ -961,7 +965,7 @@ interface TaskView {
|
||||
| --- | --- | --- |
|
||||
| `GET /admin-api/project-imports` | Query:page、size、status、projectCode,可选 | `PageResponse<TaskView>` |
|
||||
| `GET /admin-api/project-imports/{taskCode}` | 无 | `TaskView` |
|
||||
| `POST /admin-api/project-imports/{taskCode}/retry` | 无 body | HTTP 202,`TaskView` |
|
||||
| `POST /admin-api/project-imports/{taskCode}/retry` | 无 body;先展示 retryMessage 供用户确认 | HTTP 202,`TaskView`;后台清理或续跑 |
|
||||
|
||||
状态决定页面行为,阶段用于文字说明:
|
||||
|
||||
@@ -970,12 +974,13 @@ interface TaskView {
|
||||
| QUEUED | 排队中 | 持续轮询,不重复提交 |
|
||||
| RUNNING | 迁移中 | 持续轮询,展示阶段和 warnings |
|
||||
| SUCCEEDED | 迁移完成,待检查发布 | 停止轮询,跳转项目检查;不会自动发布 |
|
||||
| FAILED | 迁移失败 | 停止轮询,展示 errorCode、warnings,可由用户点击重试 |
|
||||
| REVIEW | 结果待核对 | 停止轮询,提示联系维护人员,不自动重试 |
|
||||
| FAILED | 迁移失败 | 停止轮询,展示提醒;canRetry=true 时显示“重试迁移” |
|
||||
| REVIEW | 结果待核对 | 停止轮询;canRetry=true 时可重试核验/续跑,否则提示联系维护人员 |
|
||||
|
||||
| phase | 建议文案 |
|
||||
| --- | --- |
|
||||
| QUEUED | 等待处理 |
|
||||
| CLEANING | 核验并清理失败仓库,准备重新迁移 |
|
||||
| PRECHECK | 校验来源和项目信息 |
|
||||
| MIGRATING | 迁移 Git 仓库与 LFS |
|
||||
| MIGRATED | 仓库迁移已确认 |
|
||||
@@ -983,7 +988,7 @@ interface TaskView {
|
||||
| BRANCH_READY | 主分支已准备 |
|
||||
| LINKED | 已关联社区项目 |
|
||||
|
||||
不展示百分比进度,接口没有 progress、duration、canRetry 字段。耗时可根据 startedAt、finishedAt 计算,空值显示 `—`。任务查询 HTTP 200、code=OK 只表示查询成功,必须再判断 data.status 是否失败或待核对。
|
||||
不展示百分比进度,接口没有 progress、duration 字段。canRetry 由后端判断,前端不要仅按 status/phase 猜测是否可重试;重试仍会校验项目最新状态,可能返回 409。retryMessage 是重试确认框或无法重试时的说明,正常执行中/成功时为 null。耗时可根据 startedAt、finishedAt 计算,空值显示 `—`。任务查询 HTTP 200、code=OK 只表示查询成功,必须再判断 data.status。
|
||||
|
||||
### 9.5 轮询示例
|
||||
|
||||
@@ -1027,10 +1032,14 @@ async function watchImport(
|
||||
|
||||
### 9.6 重试和功能边界
|
||||
|
||||
- FAILED 点击重试后,按返回任务恢复轮询;后端拒绝时显示 409 message,不循环重发。
|
||||
- REVIEW 可能涉及远端结果不明,需要维护人员核对。部分已确认阶段支持同一 retry 接口安全续跑,但判断所需信息不对前端暴露;默认不显示常规重试按钮,也不要只根据 phase 推断可重试。
|
||||
- canRetry=true 时显示“重试迁移”按钮,用 retryMessage 说明操作并确认;点击后禁用重复提交,收到 202 后恢复轮询。409 表示状态已变化或核验未通过,刷新任务并显示 message,不循环重发。
|
||||
- 对于明确失败的 `GITEA_MIGRATION_REJECTED`,新任务显示 FAILED。重试后经过 CLEANING:后台核验残留仓库的任务标识、组织、名称、来源及仓库身份,清理后确认不存在,再重新迁移。沿用原 taskCode/projectCode,保留项目资料、封面及 URDF。
|
||||
- 已取得成功迁移收据时,重试只核验并继续后续步骤,不删除已迁移仓库。项目已 READY、发布过、下架或删除时拒绝重试。
|
||||
- 超时、进程在远端迁移期间中断等未知结果,不自动删除仓库或重发迁移;canRetry=false 时由维护人员处理。清理本身超时或回写中断,可通过重试重新核验目标是否已删除后恢复。
|
||||
- 旧版本显示 REVIEW 且错误为 GITEA_MIGRATION_REJECTED 的任务,也可以显示重试按钮。若仓库已不存在可以重迁;若仍有残留,但缺少新版本的任务归属标识,则停止清理并返回 REVIEW,避免误删。
|
||||
- 如果返回 CLEANUP_REPOSITORY_UNSAFE 或 CLEANUP_REPOSITORY_REPLACED,说明仓库归属无法核实或身份变化,未删除仓库,canRetry=false,提示联系维护人员。
|
||||
- 重复来源可能返回 409 `DUPLICATE_SOURCE`,错误 data 中的 projectCode 可用于跳转现有项目。不要改项目名或重新预检后循环创建。
|
||||
- 没有取消任务、强行成功、删除目标仓库、定期同步源仓库的接口。
|
||||
- 没有取消任务、强行成功、任意删除仓库、定期同步源仓库的接口;失败仓库清理只能通过上述受保护的 retry 流程执行。
|
||||
- 迁移保留 Git 历史、分支、标签并迁移 LFS;不迁移 Issue、PR、Wiki、Release 附件,不递归复制子模块依赖。保留分支不代表后台可切换分支。
|
||||
- 原默认分支非 main 时进行适配;已有 main 内容冲突会停止,前端展示任务错误和提醒即可。
|
||||
- 成功后项目仍未发布;需要管理员查看文件并手动发布。迁移表单已提交的封面和 URDF 会保留,无需再次绑定;后续替换资源仍可使用普通项目接口。不会自动扫描 Git 仓库中的 URDF 并绑定。
|
||||
@@ -1052,6 +1061,7 @@ async function watchImport(
|
||||
| 409 PROJECT_BUSY | 项目正在执行其他写操作,稍后刷新状态 |
|
||||
| 409 PROJECT_BLOCKED | 项目被管理员下架,刷新详情,不继续发布 |
|
||||
| 409 DUPLICATE_SOURCE | 使用错误 data.projectCode 引导查看已有项目 |
|
||||
| 409 CLEANUP_REPOSITORY_UNSAFE / CLEANUP_REPOSITORY_REPLACED | 残留仓库核验不通过,停止清理;任务中的同名 errorCode 也按此提示 |
|
||||
| REMOTE_RESULT_UNKNOWN(状态码以响应为准) | 写入结果待核对,停止重复提交,展示 requestId |
|
||||
| 413 FILE_TOO_LARGE / UPLOAD_TOO_LARGE / URDF_UPLOAD_TOO_LARGE | 检查对应上传类型限额,拆批或减少文件 |
|
||||
| 429 ADMIN_LOGIN_LIMITED | 提示 15 分钟后重试,不循环发登录请求 |
|
||||
@@ -1095,3 +1105,4 @@ requestId 同时可能出现在响应头 `X-Request-Id`。错误提示可附“
|
||||
- 迁移 202 显示已受理;终态停止轮询;不把 FAILED/REVIEW 显示为成功。
|
||||
- 在迁移表单上传封面和 URDF 后即可创建任务;不必等待仓库 READY 再绑定 URDF;未完整上传时不能创建任务。
|
||||
- 重复来源提供现有项目入口;任务失败、超时及待核对不自动重建迁移任务。
|
||||
- 重试按钮使用 canRetry 控制,确认框显示 retryMessage;明确失败时可清理重迁,结果未知时不盲目删库;CLEANING 阶段展示清理提示。
|
||||
|
||||
Reference in New Issue
Block a user