diff --git a/suite-developer/TOOLS.md b/suite-developer/TOOLS.md index dbabdde..cd0484f 100644 --- a/suite-developer/TOOLS.md +++ b/suite-developer/TOOLS.md @@ -21,25 +21,22 @@ agc config set api-key mk_xxxxxxxxxxx pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-sdk/0.1.0/agentgis_sdk-0.1.0-py3-none-any.whl ``` -### agentgis-worker(本地执行器,`agc run` 必需) +### gis-actions(本地执行器,`agc run` 必需) -`agc run` 在 v0.2.0 中改为本地执行,不再调用平台 API。需要安装 worker: +`agc run` 在 v0.2.0 中改为本地执行,需要 gis-actions 在本地运行: ```bash # 安装依赖(Docker) sudo apt-get install -y docker.io sudo usermod -aG docker $USER -# 重新登录或执行 newgrp docker +newgrp docker -# 安装 worker -wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb -sudo dpkg -i agentgis-worker.deb +# 安装 gis-actions +curl -OJ https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/2.0.8/gis-actions_2.0.8_all.deb +sudo dpkg -i gis-actions_2.0.8_all.deb # 登录 Docker Registry(拉取 gis-base 镜像) -docker login registry.mercator.cn -u <用户名> --password-stdin - -# 启动 -sudo systemctl start agentgis-worker +echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin ``` --- @@ -54,7 +51,7 @@ agc suites list | grep <关键词> # 搜索已有套件 # 初始化新套件(脚手架) agc init ./my-analysis -# 测试执行(需先安装 agentgis-worker) +# 测试执行(需先安装 gis-actions) agc run --inputs '{"key": "val"}' --wait --poll 5 # 发布到市场 @@ -118,11 +115,11 @@ steps: ## 基础镜像 -所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas, numpy +所有套件在 gis-base 镜像中执行,包含:Python 3, GDAL, Shapely, GeoPandas, numpy, openpyxl, xlrd 镜像地址:`registry.mercator.cn/agentgis/gis-base:latest` -> ⚠️ 已知限制:gis-base 镜像暂缺 openpyxl / xlrd,涉及 Excel 读写的套件需要在脚本中 pip install。详见 Issue #6。 +> 当前 digest:`sha256:48c31cb3`(验证含 openpyxl/xlrd) ## 知识库 @@ -140,5 +137,5 @@ steps: | Issue | 描述 | 状态 | |-------|------|------| -| [#5](https://git.mercator.cn/SuiteHub/agent-profiles/issues/5) | Docker Registry 认证 | 已修复(agentgis-worker/agw_readonly_2026) | -| [#6](https://git.mercator.cn/SuiteHub/agent-profiles/issues/6) | worker 未挂载输入文件 + 镜像缺包 | 待修复 | +| [#5](https://git.mercator.cn/SuiteHub/agent-profiles/issues/5) | Docker Registry 认证 | ✅ 已修复(agentgis-worker/agw_readonly_2026) | +| [#6](https://git.mercator.cn/SuiteHub/agent-profiles/issues/6) | gis-actions worker 兼容性问题 | ⏳ 待修复 | diff --git a/suite-user/TOOLS.md b/suite-user/TOOLS.md index 02c8bd7..3573c73 100644 --- a/suite-user/TOOLS.md +++ b/suite-user/TOOLS.md @@ -33,15 +33,12 @@ agc suites list ### 安装本地执行器 ```bash -# 安装 worker -wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb -sudo dpkg -i agentgis-worker.deb +# 安装 gis-actions +curl -OJ https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/2.0.8/gis-actions_2.0.8_all.deb +sudo dpkg -i gis-actions_2.0.8_all.deb # 配置 Docker Registry 认证 echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin - -# 启动 worker -sudo systemctl start agentgis-worker ``` ### 执行套件 @@ -60,7 +57,7 @@ agc run --inputs '{"input_path": "/data/myfile.shp"}' --wait --poll 5 你本地的 SHP/GeoJSON/TIFF/XLS 文件 │ ▼ -worker(你的机器) +gis-actions(你的机器) │ ← 从市场下载套件脚本包 │ ← docker run gis-base + 套件脚本 │ → 结果写入 /tmp/output/ @@ -72,23 +69,23 @@ worker(你的机器) ```bash # 查看状态 -sudo systemctl status agentgis-worker +sudo systemctl status gis-actions # 查看日志 -journalctl -u agentgis-worker -f +journalctl -u gis-actions -f # 停止 -sudo systemctl stop agentgis-worker +sudo systemctl stop gis-actions # 卸载 -sudo dpkg --purge agentgis-worker +sudo dpkg --purge gis-actions ``` ## 已知限制 | 问题 | 说明 | |------|------| -| 输入文件挂载 | worker 暂未自动将输入文件挂载到容器内,需等待 Issue #6 修复 | -| 基础镜像缺包 | gis-base 暂缺 openpyxl/xlrd,Excel 套件运行时会自动 pip install | +| 输入文件 | shapefile 需传入目录路径而非单文件路径(因 .dbf/.shx 配套文件) | +| 模板文件 | 含 Excel 模板的套件需确保 templates/ 目录随脚本包一起发布 | 详见 https://git.mercator.cn/SuiteHub/agent-profiles/issues/6