122 lines
2.4 KiB
Markdown
122 lines
2.4 KiB
Markdown
# TOOLS.md — 套件使用工具
|
||
|
||
## 市场前端
|
||
|
||
https://suites.mercator.cn
|
||
|
||
浏览套件、查看详情、提交执行任务。
|
||
|
||
## CLI（可选）
|
||
|
||
```bash
|
||
# 安装 agentgis-cli
|
||
pip install https://git.mercator.cn/api/packages/SuiteHub/generic/agentgis-cli/0.1.0/agentgis_cli-0.1.0-py3-none-any.whl
|
||
|
||
# 配置 API Key
|
||
agc config set api-key mk_xxxxxxxxx
|
||
|
||
# 执行套件（在市场找到 suite-id 后）
|
||
agc run <suite-id> --inputs '{"input_path": "/data/myfile.shp"}'
|
||
|
||
# 查看套件列表
|
||
agc suites list
|
||
|
||
# 查看执行状态
|
||
agc status <task-id>
|
||
```
|
||
|
||
## gis-actions（本地执行器部署）
|
||
|
||
gis-actions 是套件的本地执行引擎，跑在你的机器上。
|
||
|
||
### 前提条件
|
||
|
||
- **Debian / Ubuntu 系统**
|
||
- **Docker**（验证：`docker ps`）
|
||
- `sudo apt install docker.io`
|
||
- 能访问 `registry.mercator.cn`（拉取 gis-base 镜像）
|
||
|
||
### 安装
|
||
|
||
```bash
|
||
# 下载并安装 gis-actions
|
||
wget -O agentgis-worker.deb https://git.mercator.cn/api/packages/SuiteHub/generic/gis-actions/v2.0.0-alpha/agentgis-worker_2.0.0-alpha_all.deb
|
||
sudo dpkg -i agentgis-worker.deb
|
||
|
||
# 安装后会自动配置 systemd 服务和 Docker insecure-registry
|
||
```
|
||
|
||
### 配置
|
||
|
||
编辑 `/etc/agentgis/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": "你的 API Key"
|
||
}
|
||
}
|
||
```
|
||
|
||
API Key 从 https://auth.mercator.cn 获取。
|
||
|
||
### 启动
|
||
|
||
```bash
|
||
sudo systemctl start agentgis-worker
|
||
sudo systemctl status agentgis-worker
|
||
```
|
||
|
||
### 验证
|
||
|
||
```bash
|
||
journalctl -u agentgis-worker -f
|
||
# 应看到：Worker xxx started, polling https://suites.mercator.cn every 5s
|
||
```
|
||
|
||
### 停止
|
||
|
||
```bash
|
||
sudo systemctl stop agentgis-worker
|
||
```
|
||
|
||
### 卸载
|
||
|
||
```bash
|
||
sudo dpkg --purge agentgis-worker
|
||
```
|
||
|
||
### 数据流向
|
||
|
||
```
|
||
你本地的 SHP/GeoJSON/TIFF 文件
|
||
│
|
||
▼
|
||
gis-actions（你的机器）
|
||
│ ← 从调度中心拉取任务
|
||
│ ← 下载套件脚本包
|
||
│ ← docker run gis-base + 套件脚本
|
||
│ → 结果写入 /tmp/output/
|
||
▼
|
||
结果文件（你的机器）
|
||
```
|
||
|
||
## 支持的输入类型
|
||
|
||
| 类型 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| `file` | 本地文件路径 | `/data/land_use.shp` |
|
||
| `string` | 文本 | `"缓冲区距离: 500"` |
|
||
| `number` | 数值 | `500.0` |
|
||
| `integer` | 整数 | `100` |
|
||
| `boolean` | 布尔值 | `true` |
|