核心概念

本文介绍 Zadig 的核心概念，帮助用户建立对 Zadig 的基本认知。

# 项目

Zadig 项目是一个完整的业务单元、产品或系统，包含工作流、环境、服务、构建、测试、代码审查、版本等资源。用户可在项目中进行服务开发、部署、集成测试、版本发布等操作，实现持续交付。

支持五种项目类型：

• K8s YAML 项目：以 Kubernetes 为基础设施，使用 YAML 管理和部署服务
• K8s Helm Chart 项目：以 Kubernetes 为基础设施，使用 Helm Chart 管理和部署服务
• K8s 托管项目：托管已有集群中的资源，在平台中查看日志、进入 Pod 调试、更新镜像
• 自由项目：面向主机，以及 Android、iOS、Windows、小程序等端侧发布
• 智能体项目：统一注册和管理外部智能体，供工作流中的 AI 任务调用

# 工作流

典型软件开发过程包括：编写代码 → 构建 → 部署 → 测试 → 发布。

Zadig 工作流是对上述交付流程的编排实现，由阶段和任务组成：多个阶段串行执行，一个阶段可包含多个任务，任务可串行或并发。支持界面化和 YAML 两种配置方式，也可基于模板新建。

工作流可编排构建、部署、代码审查、测试、人工审批、灰度发布、配置与数据变更、AI 任务等步骤，并支持 Git 触发、定时触发以及项目管理系统触发。

# 环境

Zadig 环境是一组服务及其配置、运行环境的总称。K8s 类环境与 Kubernetes Namespace 一一对应，基于同一套服务配置可创建多套环境。

按基础设施分为 K8s YAML 环境、K8s Helm Chart 环境、K8s 托管环境和主机环境；按场景分为测试环境和生产环境。环境支持自测模式、睡眠与唤醒，也可使用 AI 环境巡检 识别运行风险。

# 服务

Zadig 服务是可部署、可对外提供能力的业务单元：可以是一组 Kubernetes 资源（Ingress、Service、Deployment/StatefulSet/DaemonSet/CronJob、ConfigMap 等），也可以是完整的 Helm Chart 或主机服务。

按基础设施对应为 K8s YAML 服务、Helm Chart 服务、托管服务和主机服务；按场景分为测试服务和生产服务，分别用于测试环境和生产环境。

# 服务组件

服务组件是容器服务中可被独立更新的最小单元（通常对应一个镜像）。一个服务可包含多个服务组件，工作流的构建与部署围绕服务组件进行。

# 构建

Zadig 构建定义如何从代码生成交付物，支持拉取代码、编译、构建镜像或安装包、推送镜像、上传对象存储，并可使用构建缓存。构建可运行在 Kubernetes 或主机上。

一个服务可配置多套构建，工作流中按需选择；一套构建也可被多个服务共享。

# 测试

Zadig 测试管理自动化测试的配置与执行，覆盖单元、集成、接口、UI、性能、端到端等场景，可单独执行或在工作流中调用，支持跨项目共享。

# 代码审查

Zadig 代码审查属于项目资源，支持 AI 审查、Sonar 扫描和自定义扫描。可单独执行，也可在工作流中编排；支持质量门禁、多仓库扫描，以及基于代码变更自动触发。

# 版本管理

Zadig 版本是从环境中固化下来的完整交付物：K8s YAML 项目交付镜像与服务配置，Helm Chart 项目交付 Chart 与镜像。版本可通过工作流部署到指定环境，也可在新建环境时回溯使用。

# 发布计划

发布计划用于规划、审批和执行一次发布。可关联需求与工作流，设置发布窗口和负责人，支持 Zadig、飞书、钉钉审批，并记录完整操作日志。