agent-profiles/suites-help/系统使用手册/GIS-Actions-本地部署.md

GIS-Actions 本地部署指南

架构

gis-actions 是本地执行器，直接从 Gitea 下载套件包并在本地 Docker 中运行：

用户 / CLI → gis-actions（本地）
    → 下载套件包（从 Gitea）
    → Docker 执行
    → 结果写入本地

不再需要云端 Worker 注册、心跳、任务队列轮询。

环境要求

• Python 3.10+
• Docker（用于执行容器化脚本任务）

安装

git clone https://git.mercator.cn/AgentGIS/gis-actions.git
cd gis-actions
pip install -r requirements.txt

配置

export GITEA_TOKEN=your_gitea_token_here

运行套件

python cli.py run /tmp/my-workdir --input package_url=https://git.mercator.cn/.../suite.tar.gz

目录结构

gis-actions/
├── cli.py                  # 命令行入口
├── download_and_run.py     # 下载 + 执行核心逻辑
├── steps_executor.py       # Workflow 步骤执行器
├── docker-wrapper.sh       # Docker 包装脚本
├── workdir/                # 默认工作目录
└── e2e_test.py             # 端到端测试

工作流程

1. cli.py run 启动执行
2. download_and_run.run_suite() 根据 package_url 下载套件包
3. 解压到工作目录
4. 读取 workflow.yml，按步骤执行
5. 脚本步骤通过 Docker 容器运行
6. 结果输出到工作目录