创建 App 与关联 Repository

Traduction en coursCe guide est actuellement disponible en chinois simplifié. Une version traduite sera ajoutée ultérieurement.

Cluster 定义“在哪里构建和运行”，App Repository 定义“构建什么”。每个 Pipeline App 必须同时具备 Repository 和 Pipeline 能力。

1. 创建 App

进入 Applications，点击创建应用：

1. 填写 App Name。
2. 填写稳定且唯一的 App Code。保存后不要把它当作显示名称频繁变更。
3. Preset 选择 Existing Application；或在 Custom 中同时选择 Repository 和 Pipeline。
4. Access URL 可暂时留空，部署完成后再填写或由发布过程同步。
5. 选择 Icon，填写 Description 并保存。

创建 Pipeline App展示 Existing Application 预设、Repository/Pipeline 能力、App Name、App Code、Access URL 和 Icon。images/spark-pipeline-app-create-01.webp

截图待补充

Vibe Coding App 默认也包含 Repository 和 Pipeline。Low-Code App 如果只有 Low-Code 能力，不会自动出现 Repository、Deployment 和 Pipeline 入口。

2. 配置 Repository

打开 App 详情，点击 Repository：

字段	说明
Language	Java、Node.js 或 Python；决定构建扩展和部署配置字段
Repository Type	当前选择 Git
Repository URL	完整的 HTTPS Git URL
Baseline Branch	默认分支，例如 master 或 main
Git Secret	私有仓库选择 Git 类型 Secret
Description	可记录仓库、目录或分支约定

关联 Git Repository展示 Language、Git URL、Baseline Branch 和 Git Secret 下拉框。images/spark-pipeline-app-repository-02.webp

截图待补充

Language 不是备注字段。它会选择 k8s.java、k8s.python、k8s.node_js 或对应 Docker 构建与部署能力；配置错误会导致字段、默认命令和构建镜像不匹配。

3. 三个示例的 Repository

App Code	Language	Repository	Baseline Branch
spark-console	Java	https://gitlab.hiforce.ai/spark-force/spark-all.git	master
pulse-force-server	Python	https://e.coding.net/hiforce-inc/pluse-force/pulse-force-server.git	master
front-era	Node.js	https://e.coding.net/hiforce-inc/hiforce-front/os-front.git	master

这些 URL 用于解释示例结构。没有对应仓库权限时，请替换为自己的仓库和 Secret，不要复制他人的访问令牌。

4. 仓库应满足什么条件

Java

• 仓库中有 Maven pom.xml。
• Pipeline 的 Build Command 能生成部署 Dockerfile 所引用的 JAR。
• Dockerfile Path 相对于仓库根目录，并位于 Build Context 中。
• 环境配置文件已经提交到仓库，且不包含明文 Secret。

Python

• 仓库包含可重复构建的 Dockerfile。
• 依赖版本写入 requirements.txt、pyproject.toml、environment.yml 或 Dockerfile。
• Dockerfile 的 CMD/ENTRYPOINT 与应用监听端口一致。
• 提供稳定的健康检查 URL。

Node.js

• 前端模块有 package.json 和 lockfile。
• 使用 Managed NPM Build 时，Frontend Build Path 指向模块目录，Output Path 相对于该目录。
• 使用 Dockerfile Build 时，Dockerfile 负责安装、构建和运行。
• SPA 容器需要可用的 Nginx 配置或等价静态服务器配置。

5. 保存后的检查

进入 Pipeline 前，先确认：

• App 详情中 Repository、Deployment、Pipeline 三个入口可见。
• 私有仓库已选择 Git Secret。
• Baseline Branch 在远端存在。
• Language 与源码一致。
• Git URL 没有把用户名、密码或 Token 写进地址。

下一步配置部署环境。