docs: TOOLS.md 更新 gis-actions 名称、v2.0.8 URL、registry 凭据、已知问题

This commit is contained in:
Ubuntu
2026-07-13 14:18:46 +08:00
parent 8dc7b8c041
commit 6cd8b3b05e
2 changed files with 22 additions and 28 deletions
+12 -15
View File
@@ -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 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 ```bash
# 安装依赖(Docker # 安装依赖(Docker
sudo apt-get install -y docker.io sudo apt-get install -y docker.io
sudo usermod -aG docker $USER sudo usermod -aG docker $USER
# 重新登录或执行 newgrp docker newgrp docker
# 安装 worker # 安装 gis-actions
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 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 agentgis-worker.deb sudo dpkg -i gis-actions_2.0.8_all.deb
# 登录 Docker Registry(拉取 gis-base 镜像) # 登录 Docker Registry(拉取 gis-base 镜像)
docker login registry.mercator.cn -u <用户名> --password-stdin echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin
# 启动
sudo systemctl start agentgis-worker
``` ```
--- ---
@@ -54,7 +51,7 @@ agc suites list | grep <关键词> # 搜索已有套件
# 初始化新套件(脚手架) # 初始化新套件(脚手架)
agc init ./my-analysis agc init ./my-analysis
# 测试执行(需先安装 agentgis-worker # 测试执行(需先安装 gis-actions
agc run <suite-id> --inputs '{"key": "val"}' --wait --poll 5 agc run <suite-id> --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` 镜像地址:`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 | 描述 | 状态 | | Issue | 描述 | 状态 |
|-------|------|------| |-------|------|------|
| [#5](https://git.mercator.cn/SuiteHub/agent-profiles/issues/5) | Docker Registry 认证 | 已修复(agentgis-worker/agw_readonly_2026 | | [#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 未挂载输入文件 + 镜像缺包 | 待修复 | | [#6](https://git.mercator.cn/SuiteHub/agent-profiles/issues/6) | gis-actions worker 兼容性问题 | ⏳ 待修复 |
+10 -13
View File
@@ -33,15 +33,12 @@ agc suites list
### 安装本地执行器 ### 安装本地执行器
```bash ```bash
# 安装 worker # 安装 gis-actions
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 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 agentgis-worker.deb sudo dpkg -i gis-actions_2.0.8_all.deb
# 配置 Docker Registry 认证 # 配置 Docker Registry 认证
echo "agw_readonly_2026" | docker login registry.mercator.cn -u agentgis-worker --password-stdin 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 <suite-id> --inputs '{"input_path": "/data/myfile.shp"}' --wait --poll 5
你本地的 SHP/GeoJSON/TIFF/XLS 文件 你本地的 SHP/GeoJSON/TIFF/XLS 文件
worker(你的机器) gis-actions(你的机器)
│ ← 从市场下载套件脚本包 │ ← 从市场下载套件脚本包
│ ← docker run gis-base + 套件脚本 │ ← docker run gis-base + 套件脚本
│ → 结果写入 /tmp/output/ │ → 结果写入 /tmp/output/
@@ -72,23 +69,23 @@ worker(你的机器)
```bash ```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 修复 | | 输入文件 | shapefile 需传入目录路径而非单文件路径(因 .dbf/.shx 配套文件) |
| 基础镜像缺包 | gis-base 暂缺 openpyxl/xlrdExcel 套件运行时会自动 pip install | | 模板文件 | 含 Excel 模板的套件需确保 templates/ 目录随脚本包一起发布 |
详见 https://git.mercator.cn/SuiteHub/agent-profiles/issues/6 详见 https://git.mercator.cn/SuiteHub/agent-profiles/issues/6