fix: 诚实描述 gis-actions 安装现状(待发布)
This commit is contained in:
@@ -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 容器中处理,不上传到云端。
|
||||||
Reference in New Issue
Block a user