艺术码农的小栈

Ease Ops - 用户手册

2026/7/16 探索Ease Ops

# 前言

Ease-Ops 是新一代轻量化 DevOps CICD 持续交付平台，依托 DAG 拓扑并行调度、结构化日志管控、AI 智能故障诊断三大核心能力，解决传统 CI/CD 工具发布低效、排错繁琐、运维复杂、扩展困难等行业痛点。平台支持零代码拖拽编排流水线、多组件并行交付、全流程可追溯、AI秒级排错，大幅降低研发运维成本，适配中小企业各类前后端分离、混合部署架构项目，可轻量化替代传统 Jenkins 工具。

本手册面向平台日常使用人员，通俗易懂讲解核心功能、操作流程、配置规范及优势特性，适配日常项目管理、环境配置、任务搭建、流水线编排、MCP智能接口、权限管控、节点运维等全场景操作。

# 一、项目管理

在Ease Ops平台中，项目是研发交付全生命周期的核心管控容器，用于统一归集和隔离代码仓库、组件、主机、凭证、流水线、环境配置等所有研发资源，实现单项目全流程独立管控、权限隔离与链路追溯。

# 1.1 项目创建

# 1.1.1 新建项目

在平台右上角项目下拉菜单中选择「新建项目」，跟随智能化引导流程完成创建，核心填写信息如下：

  • 项目名称：自定义项目展示名称，便于日常识别管理；

  • 项目编码：平台唯一标识，作为后续资源路径隔离、变量识别、组件绑定的核心依据，创建后不可修改。

项目创建后自动初始化基础环境与默认流水线，无需手动从零搭建，快速落地DevOps流程。

image20260716191854522.png

编辑项目

image20260716191943570.png

# 1.1.2 项目核心资源说明

所有项目资源统一归属当前项目，相互独立，核心包含五大类资源：

  • 凭证：统一管理仓库拉取、服务器登录的鉴权信息；
  • 代码仓库：关联项目Git代码源，支撑代码检出、构建、持续集成流程；
  • 组件：最小独立部署单元，涵盖前端Web、后端API、分布式Runner代理等可独立发布的业务实体，支持按业务模块拆分管理；
  • 主机：归集项目所有部署服务器信息，按环境分类隔离；
  • 流水线：承载项目构建、测试、部署全流程工作流。

# 1.2 凭证管理

凭证用于统一托管代码仓库、远程主机的登录鉴权信息，支持多资源共享复用，避免明文泄露、重复配置，保障资源访问安全。

# 1.2.1 新建凭证

  1. 进入「资源管理」->「凭证管理」界面，点击「新建凭证」；

    image20260716192803184.png

    凭证信息

    image20260716193000784.png

  2. 自定义凭证名称，便于快速识别用途；

  3. 选择凭证类型，支持用户名密码、SSH秘钥两种主流类型；

  4. 按类型填写对应信息：密码类型填写账号密码，秘钥类型上传秘钥文件；

  5. 可选填写备注，标注适用仓库、主机或环境，完成创建。

# 1.2.2 凭证使用规则

  • 支持多仓库、多主机共享同一凭证，统一维护、修改一次全局生效；

  • 创建/编辑代码仓库、主机资源时，直接选择已有凭证关联，无需重复录入鉴权信息；

  • 凭证仅当前项目可见，实现跨项目权限隔离。

# 1.3 代码仓库管理

用于绑定项目Git代码源，支撑流水线代码检出、自动触发构建等核心能力，兼容各类标准Git仓库地址格式。

# 1.3.1 新增仓库

  1. 进入项目「代码仓库」模块，点击右侧「新增」；

    image20260716193057278.png

    新增界面 image20260716193223329.png

  2. 填写完整Git仓库地址、默认构建分支；

  3. 私有仓库必须关联已有凭证或新建凭证，保障代码拉取权限；

  4. 确认保存，完成仓库绑定。

# 1.3.2 仓库日常管理

  • 流水线详情可以查看仓库提交记录、分支列表、代码变更日志；

  • 支持编辑仓库配置、更新关联凭证、删除无效仓库；

  • 可配置Webhook钩子，实现代码提交自动触发流水线构建。

# 1.4 主机管理

统一管理项目所有部署服务器资源，按环境分类隔离，为流水线部署节点提供目标机器支撑。

# 1.4.1 新建主机

  1. 进入项目「主机管理」界面，点击「新建主机」；

    image20260716193511624.png

    新增界面 image20260716193700830.png

  2. 填写主机名称、IP地址、SSH登录端口；

  3. 关联所属环境（开发、测试、生产等），实现环境资源隔离；

  4. 选择已有SSH登录凭证或新建凭证，完成主机绑定。

# 1.4.2 主机日常管理

  • 可视化查看主机硬件配置、在线状态、心跳信息、部署记录；

  • 支持主机信息编辑、状态刷新、无效主机删除；

  • 部署任务仅可调用当前环境绑定的主机，杜绝跨环境误部署。

# 1.5 组件管理

组件是平台可独立部署、独立迭代的最小业务单元，是流水线任务编排、构建部署的核心绑定对象。 image20260716193859515.png

# 1.5.1 组件定义规范

  • 按业务架构拆分，支持前端Web、后端API、分布式Runner、数据服务等各类组件定义；
  • 大仓库模式下，同一代码仓库内的多业务模块，需按独立部署规则拆分多个组件，适配单独构建、部署需求。

# 1.5.2 新建组件

进入项目详情，点击组件框旁边的“新增组件”，弹出新增引导，功能和创建项目的引导类似，参考「快速入门 (opens new window)」

image20260716194148849.png

# 1.5.3 组件日常管理

  • 查看组件关联的代码仓库、构建配置、环境变量、部署历史、版本记录；

  • 支持组件配置编辑、手动触发构建、指定环境部署、版本回滚等操作；

  • 所有流水线任务均围绕组件配置，实现单组件独立管控、多组件自由编排。

# 二、环境管理

Ease Ops 环境配置模块依托树形继承架构、模板变量拆分、全链路追溯核心能力，解决传统研发多环境配置重复、易错、难追溯、不一致的行业痛点，实现多环境配置高效复用、差异化适配、风险可控，是流水线构建、部署的核心环境依托。

image20260716195119905.png

# 2.1 核心特性与架构优势

# 2.1.1 树形继承，配置高效复用

平台采用「根节点通用模板+子环境差异化变量」的树形架构，彻底摒弃全环境重复配置模式：

  • 缺省环境（根节点）统一维护全环境通用配置、公共默认变量；

  • 测试、生产、自定义子环境自动继承父级所有配置与资源；

  • 差异化参数（数据库地址、账号、端口、密钥等）通过变量单独配置，无需重写完整配置文件，大幅降低维护成本与人工失误率。

# 2.1.2 快速拓容，适配多样研发场景

支持一键新建多级子环境，自动完整继承父环境所有配置、变量、主机、Runner资源，仅需微调少量差异化参数，即可快速搭建调试、测试、预发等专属环境，适配功能迭代、问题复现、版本验证等全场景需求。

# 2.1.3 全程追溯，变更风险可控

系统每次构建、配置更新自动生成配置快照，支持新旧配置差异对比、变更记录溯源，精准定位配置修改节点与内容，有效规避漏改、错改、配置不一致等问题，大幅降低线上变更故障风险。

# 2.2 默认基础环境架构

项目创建后，平台自动初始化三套隔离式基础环境，树形层级固定，资源相互独立，用户可按需新增多级自定义子环境：

缺省环境（根节点·全局通用）
└── 测试环境（研发调试）
└── 生产环境（正式上线）
1
2
3

  • 所有子环境默认继承父级全部配置、变量、主机、Runner资源；

  • 各环境流水线、部署资源、配置数据完全隔离，互不干扰。

# 2.3 配置文件管理规范

# 2.3.1 新增配置规则

为保障全局配置统一规范，仅支持在缺省环境新增配置文件，填写配置文件相对路径及文件内容即可，相对路径用于配置分组，支持部署时单文件、目录批量拷贝。

image20260716195551938.png

默认子环境继承

image20260716195649365.png

# 2.3.2 变量引用规范

通用配置文件固定模板化，差异化参数通过 “大括号+ 变量名”引用变量，系统自动识别提取变量并支持统一设置默认值。

标准配置示例（相对路径：config/app.yaml）：

server:
  http:
    addr: {{http_addr}}
    timeout: 300s
data:
  database:
    driver: mysql
    source: {{mysql_username}}:{{mysql_password}}@tcp({{mysql_host}}:3306)/ease_ops?parseTime=True&loc=Local
1
2
3
4
5
6
7
8

变量会自动被提前：

image20260716195819986.png

# 2.3.3 继承与覆盖规则

  • 子环境默认完整继承缺省环境的所有配置文件与变量；

  • 支持子环境按需修改变量值、重写配置文件，实现个性化覆盖适配；

  • 核心规则：变量依托配置存在，若子环境重写配置并移除变量引用，当前及下级子环境将不再继承该变量。

# 2.3.4 配置状态标识

平台自动标注配置/变量来源，快速区分配置状态，便于运维核查：

  • 继承「xx环境」：当前配置无自定义修改，完全继承自父级环境；

  • 覆盖「xx环境」：当前配置已自定义修改，覆盖父级原有内容；

  • 本地定义：当前配置/变量由本环境独立创建，无上级继承关系。

2026_07_14_18_37_16_image20260714181853121.dccb3234.png

# 2.3.5 部署引用方式

部署脚本通过 “大括号 + conf:配置路径” 精准引用配置，系统自动适配当前生效环境生成最终配置，支持修改后差异预览，规避误操作。两种常用引用方式：

  • 单文件精准拷贝：

    rsync -avc {{conf/config/app.yaml}} /usr/local/my_app/conf/app.yaml
    1

  • 目录批量同步：

    rsync -avc {{conf:config}}/ /usr/local/my_app/conf/
    1

# 2.4 环境变量与资源绑定管理

# 2.4.1 环境变量分类

环境变量支持继承、覆盖，全局统一引用格式：var:环境类型.变量名，分为两类：

  • ext 自定义变量：用户按需在对应环境手动维护，适配项目个性化配置；

  • sys 系统内置变量：平台原生自带（组件编码、版本号等），无需手动配置，可直接全局引用。

# 2.4.2 主机资源绑定

各环境可独立绑定专属主机资源，流水线部署仅可调用当前环境绑定主机，实现跨环境资源隔离；子环境未绑定主机时，自动继承父级环境主机资源。

image20260716200033835.png

# 2.4.3 Runner资源绑定

Runner节点区分构建、部署双场景独立绑定，适配环境继承规则，资源调度优先级：环境专属Runner > 平台公共Runner，保障任务执行稳定、资源高效利用。

image20260716200125206.png

# 2.5 环境管理价值与规范

# 2.5.1 核心落地收益

  • 提效降错：一套通用模板多环境复用，减少80%重复配置，规避人工配置失误；

  • 提速迭代：快速搭建个性化子环境，大幅缩短环境部署、调试周期；

  • 风险可控：配置变更全程可追溯、可对比，精准管控线上变更风险。

# 2.5.2 基础环境定位规范

  • 缺省环境：全局根节点，统一维护全项目通用配置、默认变量、公共资源模板；

  • 测试环境：用于日常研发调试、问题复现、版本迭代验证，支持个性化配置修改；

  • 生产环境：线上正式业务环境，配置、资源严格管控，仅允许合规变更，保障业务高可用。

# 2.5.3 标准化配置流程

  1. 模板搭建：在缺省环境创建通用配置文件模板，固定通用内容，差异化参数用变量占位；

  2. 变量配置：为所有自定义变量设置默认值，保障基础流程可正常运行；

  3. 环境适配：子环境按需覆盖变量值、绑定专属主机/Runner资源，完成环境差异化适配；

  4. 变更校验：配置修改后预览差异，构建自动生成快照，留存变更记录。

# 三、任务管理配置（流水线基础单元）

所有流水线节点均依赖前置任务配置，任务统一在「任务管理」模块创建维护，默认关联「缺省环境」，仅部署任务支持单独指定所属环境。核心包含代码检出、单元测试、构建、部署四大类任务。

image20260716200225726.png

# 3.1 代码检出任务

用于拉取代码仓库源码，是所有流程的起始节点，支持单组件、多组件批量检出（大仓库模式适配）。

image20260716200314645.png

# 配置规范

  • 任务名称：单个组件仅1个检出任务时，使用默认名称即可，无需额外添加组件名，流水线界面自动展示对应组件信息。

  • 关联组件：绑定当前检出任务对应的业务组件，支持一对一、一对多（大仓库）绑定。

  • 检出分支：填写需拉取的代码分支（如main、dev、test）。

  • 检出目录：默认跟随Git克隆目录，支持自定义子目录路径。

# 3.2 单元测试任务

用于代码质量校验，拦截不合格代码，从源头降低线上故障率，目前原生支持 Go-gotestsum 测试工具，其他语言工具持续迭代完善中。

image20260716200418218.png

# 配置规范

  • 任务名称：单个组件仅1个单测任务时，使用默认名称，流水线自动关联展示组件信息。

  • 关联组件：绑定需进行单元测试的业务组件。

  • 执行环境：选择对应组件适配的Go版本环境。

  • 测试工具：固定选择gotestsum。

  • 测试范围：支持自定义测试根目录、通过正则表达式排除无需测试的包；输入框内置常用正则示例，支持表达式测试校验，确保规则精准生效。

核心价值：单测失败自动阻断后续构建部署流程，配合AI智能诊断，秒级定位用例失败、报表缺失、缓存挂载异常等问题。

# 3.3 构建任务

用于代码编译、打包生成可部署工件，支持常规构建、Docker镜像构建两种模式，支持工件本地归档、阿里云云效仓库远程上传，适配各类部署场景。

image20260716200503297.png

# 通用配置规范

  • 任务名称：单个组件仅1个构建任务时，使用默认名称即可。

  • 关联组件：绑定需构建的业务组件。

# 3.3.1 常规构建（二进制/安装包构建）

image20260716200626317.png

适用于传统代码编译打包，生成二进制文件、压缩包等部署工件，核心配置如下：

  • 运行环境：下拉选择适配项目的构建镜像环境。

  • 工作目录：默认使用代码检出根目录，支持自定义子目录。

  • 构建脚本：填写编译打包命令（如mvn clean package、go build），编辑器内置智能变量补全功能： image20260716200819625.png

    变量自动胶囊高亮，无效变量实时提示，支持快捷键快速唤起变量面板、常用构建命令模板。

    • 自定义变量：格式 var:ext.xx，读取缺省环境自定义环境变量；

    • 系统变量：格式 var:sys.xx，内置版本号、组件编码等系统通用变量；

    • 配置变量：格式 conf:xx，读取缺省环境配置文件/目录路径；

  • 工件提取：定义构建产物的提取规则，供后续部署使用：

    image20260716200848036.png

    • 工件名：仅支持字母、数字、下划线、连字符、点，作为部署流程变量占位符；

    • 提取路径：默认检出目录，支持自定义子路径；

    • 匹配过滤：基于Glob语法匹配产物文件，支持正则排除、规则测试，可配置多路径、多工件提取。

# 3.3.2 Docker构建

支持自定义Dockerfile，一站式完成代码编译、镜像制作，平台管控基础镜像来源，仅支持平台内置镜像列表。

image20260716201001380.png

镜像推送仓库信息通过项目级别内置变量配置：

  • ALI_IMAGE_REGISTRY：镜像仓库地址

  • ALI_IMAGE_NS：镜像命名空间

  • ALI_IMAGE_USERNAME：仓库用户名

  • ALI_IMAGE_PASSWORD：仓库密码

# 3.3.3 工件归档配置

默认工件归档至构建机本地目录，支持自动上传至阿里云云效制品仓库，只需在项目级别配置变量 ARTIFACT_ARCHIVE

image20260716201050770.png

配置示例：

method: aliyun
aliyun:
  upload_api_root: https://packages.aliyun.com/api/protocol/6248ee889491f3d1689b80d7/generic/repo-ifvee/files
  username: xxx
  password: yyy
1
2
3
4
5

# 3.4 部署任务

用于将构建完成的工件、配置文件分发至目标服务器，完成服务启动、更新，支持SSH远程部署、全流程日志留痕。

image20260716201128260.png

# 基础配置规范

  • 任务名称：单个组件仅1个部署任务时，使用默认名称。

  • 关联组件：绑定待部署的业务组件。

  • 所属环境：默认缺省环境，流水线编排时可自定义调整。

公共配置：服务启动、停止、状态检查命令统一配置在对应组件的环境变量中，与环境绑定，无需单个任务重复配置。

# 部署脚本示例（标准通用模板）

#!/bin/bash
set -euo pipefail
# 创建组件运行目录
mkdir -p /opt/{{var:sys.COMPONENT_CODE}}/bin/
# 赋予二进制文件执行权限
chmod +x {{artifact:devops-runner}}/{{var:sys.COMPONENT_CODE}}
# 同步程序二进制文件
rsync -avc {{artifact:devops-runner}}/{{var:sys.COMPONENT_CODE}} /opt/{{var:sys.COMPONENT_CODE}}/bin/
# 同步业务配置文件
rsync -avc {{conf:conf}}/ /opt/{{var:sys.COMPONENT_CODE}}/conf/
# 注册系统服务
rsync -c {{conf:ease-ops-runner.service}} /etc/systemd/system/
1
2
3
4
5
6
7
8
9
10
11
12

变量说明：

  • var:sys.COMPONENT_CODE：系统变量，自动读取当前组件编码；

  • artifact:devops-runner：关联构建任务输出的工件包；

  • conf:xxx：读取项目配置文件/目录，支持精准文件、目录批量同步。

# 四、流水线

# 4.1 流水线核心概述

# 4.1.1 流水线定义

流水线是平台核心工作流，用于实现代码检出、单元测试、构建打包、自动化部署全流程持续集成与持续交付，支持多组件并行执行、流程自由编排、任务灵活组合，实现研发交付全自动化闭环。

image20260716201210072.png

# 4.1.2 环境分类与流水线权限规则

平台以环境继承树的二级环境为核心分类，展示在流水线页面顶部导航，所有流水线均归属固定环境，不同环境流水线权限、数量规则独立：

  • 生产环境（特殊环境）：仅允许创建1条正式发布流水线，仅支持编辑操作，禁止新增、删除、替换流程，作为项目唯一正式上线通道，保障生产发布稳定性。

  • 测试环境/自定义环境：无流程数量限制，支持自由新增、编辑、删除多条流水线，适配多版本测试、多场景迭代需求。

补充规则：部署任务为特殊流程节点，可在环境基础上，按主备环境、业务模块等架构维度二次分类，适配差异化部署场景。

# 4.1.3 双维度管理模式（任务+流程）

平台采用任务定义 + 流程编排解耦式管理，灵活性远超传统流水线脚本模式，核心逻辑：

  • 任务层（基础单元）：在「任务管理」模块独立维护，提前配置好各组件的检出、单测、构建、部署规则，可复用、可单独修改，一次配置多次使用。

  • 流程层（组合编排）：创建流水线时，仅关联已配置的任务，自定义任务执行顺序、串行/并行规则，无需重复编写基础配置。

核心优势：修改单一任务参数不影响整体流程，调整流程顺序无需改动任务配置，彻底规避传统脚本“一处修改、全流程报错”的问题。

# 4.1.4 默认初始化规则

新建项目后，平台自动初始化测试环境、生产环境两大分类，且每个环境默认生成1条基础流水线，用户可直接使用，也可手动新增、自定义流水线，快速落地研发流程。

# 4.2 流水线编排与配置

完成所有任务创建后，即可通过可视化拖拽编排搭建流水线，零代码实现多组件、多节点流程组合，支持并行/串行自定义。

image20260716201303772.png

# 4.2.1 新增/编辑流水线

image20260716201353514.png

  1. 仅测试环境、自定义环境支持新增流水线，生产环境仅可编辑已有流程；

  2. 选择所需组件及对应任务，默认规则：组件间检出、单测、构建全程并行执行，部署环节可自主选择串行/并行模式；

  3. 确认后进入可视化编排界面，支持拖拽调整节点顺序、左右新增串行步骤、上下插入并行分支，像搭积木一样搭建流程。

# 4.2.2 流水线核心配置项

image20260716201430211.png

  • 流水线标题：鼠标悬浮标题可编辑，自定义流程名称，便于场景区分；

  • 所属环境：支持调整至当前大类下的子环境（如测试环境下的QA环境），精准归类流程；

  • 复用空间：开启后构建不清理本地代码，通过Pull拉取增量更新，大幅提升构建效率；生产环境禁止开启，避免目录污染导致发布异常；

  • 触发钩子（自动构建）：平台提供专属Webhook地址，配置至代码仓库即可实现代码提交自动触发构建，支持两种防抖策略：

    image.png

    • 延迟合并：触发后重置倒计时，避免频繁提交重复构建；

      • 防抖延迟：默认300秒，窗口内多次提交合并为一次构建；

    • Cron定时触发：支持配置定时执行规则，仅检测到代码变更时构建，无变更自动跳过，适配夜间迭代、定时更新场景，输入框内

      • Cron 表达式：填写标准的Cron表达式，内置常用Cron示例。

# 4.2.3 流程快速编辑能力

  • 右侧面板展示当前流程所有组件、任务信息，支持批量新增缺失组件及对应任务； image20260716201741018.png

  • 点击任意节点可查看关联组件、任务详情，支持单点编辑、删除； image20260716201818084.png

  • 部署节点专属能力：支持绑定多套环境配置、指定机器/标签批量部署，适配集群、多环境差异化发布。

    image20260716201909079.png

# 4.3 流水线构建与详情查看

流水线支持手动构建、自动触发构建两种方式，全流程可视化、日志结构化、结果可追溯、故障可智能诊断。

# 4.3.1 构建触发方式

手动构建：点击页面「构建」按钮，选择待构建组件、填写流程版本/组件版本；若开启工作空间复用，可自主选择是否清理缓存，确认后启动构建。

image20260716202107502.png

自动构建：配置仓库Webhook且开启流程触发开关后，代码提交自动触发构建；触发前置闹钟图标闪动，悬浮可查看待触发组件及倒计时，全程可视化提示。

image20260716202243948.png

# 4.3.2 构建详情与日志能力

构建发起后，可进入详情页查看全流程状态、执行进度、最终结果：

image20260716202031333.png

核心能力如下：

  • 双视图展示：上方DAG流程图直观展示节点状态、耗时、用例覆盖率，下方结构化日志面板精准留存全流程记录；

  • 日志精准过滤：支持按组件、节点筛选日志，关键词检索、错误日志标红高亮，支持日志下载、锁定禁止自动滚动；

  • 各节点详情追溯

    • 配置打包：展示配置/变量新增、修改、删除数量，支持查看详细变更记录；

    • 代码检出：记录当前及上一次成功构建的Commit版本，精准追溯代码变更；

    • 单元测试：展示用例成功/失败数、测试覆盖率，支持查看详细测试报告；

    • 构建打包：展示工件名称、大小，支持在线下载产物；

    • 部署节点：展示部署机器数量、执行结果，支持单独重试失败机器，无需全量重跑。

  • 构建历史审计：右上角统一归档所有构建记录，支持随时回溯查询，满足研发运维审计需求。

# 4.3.3 AI智能故障诊断（核心优势）

构建、单测、部署任意节点异常时，平台自动唤起AI诊断助手，无需人工逐行排查日志：

  • 自动抓取全量异常日志，凝练故障核心问题；
  • 分层解析直接原因、间接根因，精准定位代码缺失、路径错误、权限不足、用例失败等问题；
  • 同步输出标准化整改方案，将传统小时级排错压缩至秒级，排错效率提升90%。

2026_06_05_10_51_06_image.4ece9bc7.png

# 五、MCP AI接口能力

Ease Ops 平台内置MCP开放接口能力，作为独立智能化能力模块，支持外部AI工具、自动化系统对接调用平台全量DevOps能力，实现流水线智能调度、自动化运维、故障智能处置，赋能研发流程智能化升级。

image20260716202502541.png

# 5.1 能力概述

MCP接口为平台标准化对外交互接口，打通AI智能工具与DevOps流水线的联动能力，可远程调用项目管理、环境配置、任务构建、流水线执行、日志查询、故障诊断等核心功能，适配智能化持续交付、无人值守运维、批量自动化发布等场景。

# 5.2 密钥创建与鉴权规范

所有MCP接口请求需通过专属密钥鉴权，保障接口访问安全，配置流程如下：

  1. 进入平台「系统管理」-「MCP API Key」模块；

  2. 点击「新增密钥」，自定义密钥备注、适配场景，生成专属鉴权密钥；

  3. 妥善保存密钥，密钥仅生成一次，丢失无法找回；

  4. 支持密钥启用、禁用、删除管理，可按需回收接口访问权限。

鉴权报错说明：未携带密钥、密钥过期或密钥无效时，接口将返回 invalid or missing token 401无权限报错，需核对密钥有效性或重新生成密钥配置。

# 5.3 接口标准配置示例

标准MCP接口对接配置格式如下，将配置中xxx替换为平台生成的专属MCP密钥即可完成对接：

{
    "mcpServers": {
      "cicd-mcp": {
        "url": "https://devops.itart.cn/mcp",
        "headers": {
          "Authorization": "Bearer xxx"
        }
      }
    }
  }
1
2
3
4
5
6
7
8
9
10

# 5.4 核心应用场景

  • 智能流水线调度：通过AI工具远程触发构建、启停流水线、查询构建状态，实现无人值守自动化发布；

  • 批量运维管控：对接外部运维系统，批量查询项目、环境、主机资源状态，实现规模化DevOps运维；

  • 故障智能联动：结合平台AI诊断能力，通过接口推送故障日志、根因分析、整改方案，实现故障自动预警与处置；

  • 流程智能化扩展：支持自定义AI场景联动，拓展平台原生能力，适配个性化智能化研发运维需求。

# 六、权限管理

平台采用角色化分级授权模式，区分平台级、项目级权限，权限隔离清晰、管控精准，适配多用户协作场景。

# 6.1 权限资源分类

image20260716202623438.png

  • 平台资源：平台全局配置、权限管理、Runner管理等跨项目通用资源，仅平台管理员可操作；

  • 项目资源：组件、流水线、机器、凭证等项目专属资源，由项目角色独立管控。

# 6.2 角色分类

image20260716202700697.png

  • 平台角色：管控平台级资源，负责全局配置、用户管理、Runner审核分配；

  • 项目角色：管控单项目资源，每个项目可独立定义、单独授权，互不干扰。

# 6.3 用户管理规则

image20260716202807177.png

  • 单个用户可绑定多个角色，兼顾多场景权限需求；

  • 新用户加入项目后，默认授予项目管理员基础权限；

  • 仅项目管理员拥有「邀请用户、修改项目角色权限」的能力，保障项目权限安全。

# 七、Runner 管理

Runner 为平台分布式执行代理，承担代码构建、远程部署两大核心职能，支持集群扩容、智能调度，解决单节点性能瓶颈，仅平台管理员可管理配置。

image20260716202827988.png

# 7.1 Runner 核心能力

  • 构建职能：拉取代码、执行编译打包、完成工件归档/上传至本地或阿里云云效制品仓库；

  • 部署职能：远程连接目标服务器、分发工件与配置、执行部署脚本、启停服务。

# 7.2 新增 Runner 节点

  1. 下载平台专属Runner程序，部署至目标服务器并启动；

  2. 程序自动注册至平台，管理员在「系统管理-Runner管理」列表查看节点信息；

  3. 管理员完成节点审核（通过/拒绝）、工作空间配置、项目分配；

  4. 支持标签配置：内置「构建、部署」系统标签，精准区分节点用途。

# 7.3 Runner 调度策略

平台采用精准匹配+一致性哈希调度机制，保障流程运行稳定：

  1. 优先匹配流水线所属环境绑定的、对应标签的Runner节点；

  2. 无专属节点时，自动使用平台内置公共Runner；

  3. 多节点匹配时，通过一致性哈希将同一流水线ID固定调度至同一节点，保证执行环境一致性。

# 八、平台核心优势（核心亮点）

  1. 效率大幅提升：DAG多组件并行调度，整体发布耗时缩短60%+，分钟级完成全流程交付，告别人工通宵发布；

  2. 故障精准可控：单测卡点拦截缺陷，线上故障率下降82%；AI秒级智能排错，无需人工日志排查；

  3. 运维成本极低：零代码拖拽编排，无需编写复杂脚本，运维人力减负70%，专注架构优化而非重复发布；

  4. 架构灵活稳定：任务与流程解耦、三层架构隔离，支持插件化扩展，新增业务无需重构底层；

  5. 全流程可追溯：结构化日志分组件隔离，所有操作、变更、部署记录全程留痕，审计溯源有据可依；

  6. 轻量化易落地：无需复杂环境搭建，开箱即用，低成本替代传统Jenkins，适配各类中小企业研发场景。

# 九、适配场景

  • 前后端分离多组件分布式项目；

  • 物理机、容器混合部署的研发环境；

  • 需要标准化、规范化研发交付流程的团队；

  • 希望简化CI/CD运维、降低落地成本的中小企业。