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