From dcc1af2771f73718002167e0a7925740b4cbf187 Mon Sep 17 00:00:00 2001 From: Huawei Date: Mon, 13 Jul 2026 16:44:11 +0000 Subject: [PATCH] =?UTF-8?q?fix:=20=E5=A5=97=E4=BB=B6=E5=8F=91=E5=B8=83?= =?UTF-8?q?=E6=8C=87=E5=8D=97=20=E2=80=94=20=E7=AE=80=E5=8C=96=EF=BC=8C?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=E6=97=A0=E6=95=88=20UI=20=E5=92=8C=20upload?= =?UTF-8?q?=20=E7=AB=AF=E7=82=B9=E6=8F=8F=E8=BF=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- suites-help/开发者指南/套件发布指南.md | 53 +++----------------------- 1 file changed, 5 insertions(+), 48 deletions(-) diff --git a/suites-help/开发者指南/套件发布指南.md b/suites-help/开发者指南/套件发布指南.md index f1e4d22..4991459 100644 --- a/suites-help/开发者指南/套件发布指南.md +++ b/suites-help/开发者指南/套件发布指南.md @@ -5,15 +5,7 @@ - 一个 API Key（从 https://auth.mercator.cn 获取） - 套件目录包含 `workflow.yaml` 和 `scripts/` -## 一、通过 Web UI 发布 - -登录 https://suites.mercator.cn → 进入套件详情页 → 点击「发布」。 - -系统会自动打包 `workflow.yaml` + `scripts/` + `templates/` 为 `-.tar.gz` 并上传到 Gitea Packages。 - -## 二、通过 API 发布 - -### 1. 直接发布（推荐） +## 通过 API 发布 ```bash curl -X POST https://suites.mercator.cn/api/v1/publish \ @@ -28,46 +20,11 @@ curl -X POST https://suites.mercator.cn/api/v1/publish \ }' ``` -### 2. 上传包文件发布 - -先手动打包： - -```bash -cd my-suite -# 打包为 -.tar.gz（slug 为套件名的 ASCII 转换） -tar czf my-suite-1.0.0.tar.gz workflow.yaml scripts/ -``` - -上传： - -```bash -curl -X POST https://suites.mercator.cn/api/v1/publish/upload \ - -H "Authorization: Bearer mk_xxxx" \ - -F "file=@my-suite-1.0.0.tar.gz" \ - -F "name=my-suite" \ - -F "version=1.0.0" -``` - -## 三、发布流程说明 +## 发布流程 ``` 1. 提交 workflow.yaml + scripts/ 内容 -2. 系统自动校验： - - workflow.yaml 格式是否正确 - - 参数声明是否完整 - - 脚本文件是否存在 - - 参数类型是否匹配 -3. 校验通过 → 打包为 -.tar.gz → 上传到 Gitea Packages -4. 在数据库中注册套件记录，package_url 指向包地址 +2. 系统自动校验格式 +3. 校验通过 → 打包上传到 Gitea Packages +4. 在数据库中注册套件记录 ``` - -## 合规检测 - -发布时自动检测： - -- `workflow.yaml` 格式是否正确 -- 参数声明是否完整 -- 脚本文件是否存在 -- 参数类型是否匹配 - -不通过则发布失败，返回具体错误信息。