# 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. 结果输出到工作目录