61 lines
1.3 KiB
Markdown
61 lines
1.3 KiB
Markdown
# GIS-Actions 本地部署指南
|
|
|
|
## 架构
|
|
|
|
gis-actions 是**本地执行器**，直接从 Gitea 下载套件包并在本地 Docker 中运行：
|
|
|
|
```
|
|
用户 / CLI → gis-actions（本地）
|
|
→ 下载套件包（从 Gitea）
|
|
→ Docker 执行
|
|
→ 结果写入本地
|
|
```
|
|
|
|
不再需要云端 Worker 注册、心跳、任务队列轮询。
|
|
|
|
## 环境要求
|
|
|
|
- Python 3.10+
|
|
- Docker（用于执行容器化脚本任务）
|
|
|
|
## 安装
|
|
|
|
```bash
|
|
git clone https://git.mercator.cn/AgentGIS/gis-actions.git
|
|
cd gis-actions
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
## 配置
|
|
|
|
```bash
|
|
export GITEA_TOKEN=your_gitea_token_here
|
|
```
|
|
|
|
## 运行套件
|
|
|
|
```bash
|
|
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. 结果输出到工作目录
|