122 lines
2.5 KiB
Markdown
122 lines
2.5 KiB
Markdown
# GIS Actions 本地部署
|
||
|
||
## 是什么
|
||
|
||
GIS Actions 是套件的本地执行引擎。它在你的机器上跑一个后台进程，从调度中心拉取任务，在 Docker 中执行。
|
||
|
||
## 前提条件
|
||
|
||
- **Python 3.10+**
|
||
- **Docker**（验证：`docker ps`）
|
||
- 能访问 `suites.mercator.cn` 和 `registry.mercator.cn`
|
||
|
||
## 依赖
|
||
|
||
GIS Actions 使用 Python 标准库，无第三方包依赖。
|
||
所有 GIS 计算在 Docker 容器中完成，不需要在你的机器上安装 GDAL 等库。
|
||
|
||
## 获取代码
|
||
|
||
### 方案 A：从 Gitea Packages 下载
|
||
|
||
```bash
|
||
curl -L -o gis-actions.tar.gz \
|
||
"https://git.mercator.cn/api/packages/AgentGIS/generic/gis-actions/2.2.2/gis-actions.tar.gz"
|
||
tar xzf gis-actions.tar.gz
|
||
cd gis-actions
|
||
```
|
||
|
||
### 方案 B：从 git 仓库获取（需仓库访问权限）
|
||
|
||
```bash
|
||
git clone https://git.mercator.cn/AgentGIS/gis-actions.git
|
||
cd gis-actions
|
||
```
|
||
|
||
## 配置
|
||
|
||
创建 `worker.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": "***"
|
||
},
|
||
"logging": {
|
||
"level": "INFO",
|
||
"file": "/var/log/gis-actions.log"
|
||
}
|
||
}
|
||
```
|
||
|
||
API Key 从 https://auth.mercator.cn 获取。
|
||
|
||
## 启动
|
||
|
||
```bash
|
||
python3 worker.py --config worker.json
|
||
```
|
||
|
||
启动后自动注册到调度中心，开始轮询任务。
|
||
|
||
## 验证
|
||
|
||
日志中应看到：
|
||
|
||
```
|
||
Worker my-machine-001 started, polling https://suites.mercator.cn every 5s
|
||
Worker registered successfully
|
||
```
|
||
|
||
## 进程管理
|
||
|
||
建议使用进程管理工具保持后台运行：
|
||
|
||
**Linux：**
|
||
```bash
|
||
# 使用 nohup
|
||
nohup python3 worker.py --config worker.json > gis-actions.log 2>&1 &
|
||
|
||
# 或 supervisor（推荐）
|
||
# 配置见 packaging/deb/ 目录
|
||
```
|
||
|
||
**Windows / macOS：** 可放入开机启动脚本或使用进程管理器。
|
||
|
||
## 停止
|
||
|
||
```bash
|
||
# 前台运行：Ctrl+C
|
||
# 后台运行：kill 进程
|
||
```
|
||
|
||
停止时自动发送下线心跳。
|
||
|
||
## 数据流向
|
||
|
||
```
|
||
你的 SHP/GeoJSON/TIFF 文件（本地路径）
|
||
│
|
||
▼
|
||
GIS Actions（你的机器）
|
||
│ ← 轮询调度中心
|
||
│ ← 下载套件脚本包
|
||
│ ← docker run --rm registry.mercator.cn/agentgis/gis-base:latest
|
||
│ → 结果写入 /tmp/output/
|
||
│ → 脚本包自动清理
|
||
▼
|
||
结果文件（你的机器 /tmp/output/）
|
||
```
|
||
|
||
## 架构核心
|
||
|
||
**数据永不离开本地。** 你的文件始终在你的机器上处理，不上传到云端。 |