fix: 诚实描述 gis-actions 安装现状(待发布)

This commit is contained in:
2026-07-09 15:15:54 +00:00
parent a0300a2474
commit b48b68dcad
@@ -1,76 +1,41 @@
# GIS Actions 本地部署 # GIS Actions 本地部署
> **状态:待发布。** gis-actions 的安装包和安装文档目前尚未就绪。
> 本文档记录部署方案,当前仅供参考。
GIS Actions 是套件的本地执行引擎,跑在你的机器上。 GIS Actions 是套件的本地执行引擎,跑在你的机器上。
## 前提条件 ## 前提条件
- **Python 3.10+**(验证:`python3 --version` - **Python 3.10+**
- **Docker**(验证:`docker ps` - **Docker**
- Linux`apt install docker.io``yum install docker`
- Windows/Mac:安装 Docker Desktop
- 能访问 `registry.mercator.cn`(拉取 gis-base 镜像) - 能访问 `registry.mercator.cn`(拉取 gis-base 镜像)
## 安装 ## 安装方式(规划中)
目前 gis-actions 以源码形式提供,从 git 仓库获取: | 平台 | 方式 | 状态 |
|------|------|------|
```bash | Linux | `.deb` 包 | 待构建 |
git clone https://git.mercator.cn/AgentGIS/gis-actions.git | Windows | installer | 待构建 |
cd gis-actions | macOS | Homebrew / .dmg | 待构建 |
``` | 跨平台 | `pip install gis-actions` | 待发布到 PyPI |
Linux 用户也可使用 .deb 包(见 `packaging/deb/` 目录)。
## 配置 ## 配置
创建 `config.json` 需要创建配置文件,包含以下信息
```json - **Worker ID**:唯一标识你的机器
{ - **Scheduler URL**`https://suites.mercator.cn`
"worker": { - **API Key**:从 https://auth.mercator.cn 获取
"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) 获取。
## 启动 ## 启动
```bash ```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 容器中处理,不上传到云端。