diff --git a/suites-help/系统使用手册/GIS-Actions-本地部署.md b/suites-help/系统使用手册/GIS-Actions-本地部署.md index 0350903..c432b03 100644 --- a/suites-help/系统使用手册/GIS-Actions-本地部署.md +++ b/suites-help/系统使用手册/GIS-Actions-本地部署.md @@ -1,76 +1,41 @@ # GIS Actions 本地部署 +> **状态:待发布。** gis-actions 的安装包和安装文档目前尚未就绪。 +> 本文档记录部署方案,当前仅供参考。 + GIS Actions 是套件的本地执行引擎,跑在你的机器上。 ## 前提条件 -- **Python 3.10+**(验证:`python3 --version`) -- **Docker**(验证:`docker ps`) - - Linux:`apt install docker.io` 或 `yum install docker` - - Windows/Mac:安装 Docker Desktop +- **Python 3.10+** +- **Docker** - 能访问 `registry.mercator.cn`(拉取 gis-base 镜像) -## 安装 +## 安装方式(规划中) -目前 gis-actions 以源码形式提供,从 git 仓库获取: - -```bash -git clone https://git.mercator.cn/AgentGIS/gis-actions.git -cd gis-actions -``` - -Linux 用户也可使用 .deb 包(见 `packaging/deb/` 目录)。 +| 平台 | 方式 | 状态 | +|------|------|------| +| Linux | `.deb` 包 | 待构建 | +| Windows | installer | 待构建 | +| macOS | Homebrew / .dmg | 待构建 | +| 跨平台 | `pip install gis-actions` | 待发布到 PyPI | ## 配置 -创建 `config.json`: +需要创建配置文件,包含以下信息: -```json -{ - "worker": { - "id": "my-machine-001", - "capabilities": ["gis-operations"] - }, - "scheduler": { - "url": "https://suites.mercator.cn", - "poll_interval": 5, - "heartbeat_interval": 30 - }, - "auth": { - "api_key": "mk_xxxxxxxxxxxxxxxxxxxx" - } -} -``` - -API Key 从 [https://auth.mercator.cn](https://auth.mercator.cn) 获取。 +- **Worker ID**:唯一标识你的机器 +- **Scheduler URL**:`https://suites.mercator.cn` +- **API Key**:从 https://auth.mercator.cn 获取 ## 启动 ```bash -python3 -m gis_actions --config config.json +python3 worker.py --config config.json ``` 启动后自动连接调度中心,注册自身,开始等待任务。 -## 验证 - -日志中应看到: - -``` -Worker xxx started, polling https://suites.mercator.cn every 5s -Worker registered successfully -``` - -## 进程管理 - -- **Linux**:建议使用 systemd 或 supervisor 托管,开机自启 -- **Windows**:建议注册为 Windows Service -- **macOS**:建议使用 launchd - -## 停止 - -按 `Ctrl+C` 停止。脚本包自动清理,不留痕迹。 - ## 数据流向 ``` @@ -85,3 +50,7 @@ GIS Actions(你的机器) ▼ 结果文件(你的机器) ``` + +## 架构核心 + +**数据永不离开本地。** 你的文件始终在你的机器上,GIS Actions 在本地 Docker 容器中处理,不上传到云端。 \ No newline at end of file