docs: add Windows install and dual-platform execution model
This commit is contained in:
+20
-1
@@ -13,6 +13,8 @@
|
||||
|
||||
## 安装
|
||||
|
||||
### Linux
|
||||
|
||||
```bash
|
||||
curl -sLO https://packages.mercator.cn/public/gis-actions/latest.deb
|
||||
sudo dpkg -i gis-actions_latest.deb
|
||||
@@ -20,6 +22,15 @@ sudo dpkg -i gis-actions_latest.deb
|
||||
|
||||
要求:Docker Engine 已安装。
|
||||
|
||||
### Windows
|
||||
|
||||
1. 下载 [latest-windows.zip](https://packages.mercator.cn/public/gis-actions/latest-windows.zip)
|
||||
2. 解压到 `%LOCALAPPDATA%\\AgentGIS\\gis-actions\\`
|
||||
3. 将路径加入 `PATH`
|
||||
4. 验证:`agc --help`
|
||||
|
||||
要求:ArcMap 10.8(arcpy 脚本需要)
|
||||
|
||||
## 配置 API Key
|
||||
|
||||
所有操作前需先配置 API Key(在套件市场个人中心生成):
|
||||
@@ -54,13 +65,21 @@ agc run /tmp/output --suite-id <suite-id> --input key=value --watch # 实时
|
||||
|
||||
### gis-actions 工作原理
|
||||
|
||||
GIS Actions 在本地执行:
|
||||
**Linux 版(Docker 容器执行):**
|
||||
1. 从套件市场获取脚本包地址
|
||||
2. 下载加密脚本包到本地(首次下载后自动缓存)
|
||||
3. 启动 Docker 容器(gis-base 镜像,内置解密密钥 + decrypt_runner)
|
||||
4. 容器内将加密脚本解密到 /dev/shm(内存)后执行
|
||||
5. 结果写入工作目录,脚本包和临时数据自动清理
|
||||
|
||||
**Windows 版(本机 subprocess 执行):**
|
||||
1. 从套件市场获取脚本包地址
|
||||
2. 下载并解密到临时目录
|
||||
3. 根据步骤的 runtime 选择执行器:
|
||||
- python3 -> agc 内置 Python
|
||||
- arcpy -> 调用系统 arcpy(ArcMap Python 2.7)
|
||||
4. 结果写入工作目录,临时文件自动清理
|
||||
|
||||
## 排查问题
|
||||
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user