diff --git a/suites-help/系统使用手册/执行任务与查看结果.md b/suites-help/系统使用手册/执行任务与查看结果.md index 281f0f5..4ed79f1 100644 --- a/suites-help/系统使用手册/执行任务与查看结果.md +++ b/suites-help/系统使用手册/执行任务与查看结果.md @@ -1,47 +1,50 @@ -# 执行任务与查看结果 +# 执行套件与查看结果 -## 提交任务 +## 执行套件 -1. 进入套件详情页 -2. 填写输入参数: - - **本地文件路径**:GIS Actions 将在你的机器上读取这些文件 - - **数值参数**:如缓冲区距离、精度等 -3. 点击「执行」按钮 +使用 `agc run` 命令在本地执行套件: + +```bash +SUITE_MARKET_URL="https://suites.mercator.cn" \ +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`,文件路径用本地绝对路径 ## 执行流程 ``` -你提交任务 - │ - ▼ -调度中心接收 → 放入队列 - │ - ▼ -GIS Actions(你的机器)拉取任务 - │ - ├── 下载套件脚本包 - ├── Docker 容器中执行 - └── 结果写入本地目录 - │ - ▼ -任务状态更新为「已完成」 +agc run 执行 + │ + ├── 从市场查询套件的脚本包地址 + ├── 下载脚本包到本地 + ├── 复制输入文件到工作目录 + │ + ├── Step 1: docker run gis-base 执行脚本 + ├── Step 2: docker run gis-base 执行下一步(如有) + │ + └── 结果写入 /tmp/output/ ``` ## 查看结果 -- **执行状态**:任务列表显示每个任务的状态(待处理 / 运行中 / 已完成 / 失败) -- **执行结果**:完成后可以看到输出的结果数据 -- **本地文件**:GIS Actions 处理后的文件保存在你机器上的指定输出目录 +- **控制台输出**:执行过程实时打印,每个步骤的状态、产出一目了然 +- **结果文件**:在工作目录(如 `/tmp/my-output/`)的 `_step_outputs/` 下 ## 错误处理 -如果任务失败: +如果执行失败: -1. 查看错误信息 +1. 查看控制台错误信息 2. 检查输入文件路径是否正确 -3. 检查文件格式是否支持 -4. 确认 GIS Actions 是否正常运行 +3. 确认 Docker 是否正常运行(`docker ps`) +4. 确认 gis-actions 版本(`dpkg -l gis-actions`) ## 数据安全 -**数据永不离开本地。** 你提供的输入文件始终在你的机器上,GIS Actions 在你的本地 Docker 容器中处理,不上传到云端。 +**数据永不离开本地。** 输入文件始终在你的机器上,在本地 Docker 容器中处理,不上传到云端。