agent-profiles/suites-help/系统使用手册/GIS-Actions-本地部署.md

GIS Actions 本地部署

状态：待发布。 gis-actions 的安装包和安装文档目前尚未就绪。 本文档记录部署方案，当前仅供参考。

GIS Actions 是套件的本地执行引擎，跑在你的机器上。

前提条件

• Python 3.10+
• Docker
• 能访问 registry.mercator.cn（拉取 gis-base 镜像）

安装方式（规划中）

平台	方式	状态
Linux	.deb 包	待构建
Windows	installer	待构建
macOS	Homebrew / .dmg	待构建
跨平台	pip install gis-actions	待发布到 PyPI

配置

需要创建配置文件，包含以下信息：

• Worker ID：唯一标识你的机器
• Scheduler URL：https://suites.mercator.cn
• API Key：从 https://auth.mercator.cn 获取

启动

python3 worker.py --config config.json

启动后自动连接调度中心，注册自身，开始等待任务。

数据流向

你本地的 SHP/GeoJSON/TIFF 文件
    │
    ▼
GIS Actions（你的机器）
    │  ← 从调度中心拉取任务
    │  ← 下载套件脚本包
    │  ← docker run gis-base + 套件脚本
    │  → 结果写入 /tmp/output/
    ▼
结果文件（你的机器）

架构核心

数据永不离开本地。 你的文件始终在你的机器上，GIS Actions 在本地 Docker 容器中处理，不上传到云端。