fix: 执行任务 — 从调度中心模型改为 agc run CLI 模型

This commit is contained in:
2026-07-13 16:43:14 +00:00
parent 633466fb1b
commit 008baf4b24
@@ -1,47 +1,50 @@
# 执行任务与查看结果 # 执行套件与查看结果
## 提交任务 ## 执行套件
1. 进入套件详情页 使用 `agc run` 命令在本地执行套件:
2. 填写输入参数:
- **本地文件路径**:GIS Actions 将在你的机器上读取这些文件 ```bash
- **数值参数**:如缓冲区距离、精度等 SUITE_MARKET_URL="https://suites.mercator.cn" \
3. 点击「执行」按钮 agc run /tmp/my-output \
--suite-id 2c99a1cb-84a5-42dd-9147-1c8e8f7f2941 \
--input bid_xls=/path/to/标段清单.xls \
--input points_shp=/path/to/点状工程.shp
```
参数说明:
- `--suite-id`:套件 ID,从市场获取
- `--input`:输入参数,每个参数一个 `--input`,文件路径用本地绝对路径
## 执行流程 ## 执行流程
``` ```
你提交任务 agc run 执行
├── 从市场查询套件的脚本包地址
调度中心接收 → 放入队列 ├── 下载脚本包到本地
├── 复制输入文件到工作目录
├── Step 1: docker run gis-base 执行脚本
GIS Actions(你的机器)拉取任务 ├── Step 2: docker run gis-base 执行下一步(如有)
├── 下载套件脚本包 └── 结果写入 /tmp/output/
├── Docker 容器中执行
└── 结果写入本地目录
任务状态更新为「已完成」
``` ```
## 查看结果 ## 查看结果
- **执行状态**:任务列表显示每个任务的状态(待处理 / 运行中 / 已完成 / 失败) - **控制台输出**:执行过程实时打印,每个步骤的状态、产出一目了然
- **执行结果**:完成后可以看到输出的结果数据 - **结果文件**:在工作目录(如 `/tmp/my-output/`)的 `_step_outputs/`
- **本地文件**GIS Actions 处理后的文件保存在你机器上的指定输出目录
## 错误处理 ## 错误处理
如果任务失败: 如果执行失败:
1. 查看错误信息 1. 查看控制台错误信息
2. 检查输入文件路径是否正确 2. 检查输入文件路径是否正确
3. 检查文件格式是否支持 3. 确认 Docker 是否正常运行(`docker ps`
4. 确认 GIS Actions 是否正常运行 4. 确认 gis-actions 版本(`dpkg -l gis-actions`
## 数据安全 ## 数据安全
**数据永不离开本地。** 你提供的输入文件始终在你的机器上,GIS Actions 在你的本地 Docker 容器中处理,不上传到云端。 **数据永不离开本地。** 输入文件始终在你的机器上,本地 Docker 容器中处理,不上传到云端。