diff --git a/suite-developer/TOOLS.md b/suite-developer/TOOLS.md index dff7e8d..a4715b6 100644 --- a/suite-developer/TOOLS.md +++ b/suite-developer/TOOLS.md @@ -2,13 +2,17 @@ ## 安装 -### gis-actions(CLI + 执行引擎) +### gis-actions(Linux CLI) ```bash curl -sLO https://packages.mercator.cn/public/gis-actions/latest.deb sudo dpkg -i latest.deb ``` +### gis-actions(Windows CLI) + +下载 [latest-windows.zip](https://packages.mercator.cn/public/gis-actions/latest-windows.zip),解压到 `%LOCALAPPDATA%\\AgentGIS\\gis-actions\\`,加入 `PATH`。 + --- ## CLI 用法 @@ -52,7 +56,8 @@ name: 我的套件 description: 套件描述 version: 1.0.0 author: 作者 -slug: my-suite-english-name # 可选,英文包名。不传则自动转拼音 +platform: all # 运行平台: linux / windows / all +slug: my-suite-english-name # 可选,英文包名。不传则自动转拼音 tags: [标签1, 标签2] category: 业务分类 @@ -62,17 +67,29 @@ params: required: true desc: 输入文件路径 -base_image: gis-base:latest +base_image: gis-base:latest # 仅 Docker 模式需要 steps: - id: step1 name: 步骤名称 - type: python + runtime: python3 # 执行环境: docker / python3 / arcpy script_id: run params: input: $params.input_path ``` +### runtime 字段说明 + +| runtime | 执行方式 | 适用平台 | +|---------|----------|----------| +| docker | Docker 容器(steps_executor) | Linux | +| python3 | agc 内置 Python(subprocess) | Linux + Windows | +| arcpy | 系统 arcpy(Python 2.7) | Windows only | + +- 所有步骤 runtime 相同 -> 全部用对应执行器 +- 混用 docker 和其他 -> 分步骤各自执行 +- 一个套件可以同时包含 docker 和 python3 步骤 + ## 包命名规则 套件发布到 Gitea Packages 时,包名由套件名称自动生成 slug: