Skip to content

Add zeus-platform-design.html — self-contained DevOps platform design doc#1

Merged
wufeiqun merged 1 commit intomasterfrom
copilot/create-html-file-zeus-platform-design
Mar 25, 2026
Merged

Add zeus-platform-design.html — self-contained DevOps platform design doc#1
wufeiqun merged 1 commit intomasterfrom
copilot/create-html-file-zeus-platform-design

Conversation

Copy link
Copy Markdown

Copilot AI commented Mar 25, 2026

Creates a standalone, offline-capable HTML design document for the Zeus DevOps collaboration platform, covering architecture, module specs, tech stack, roadmap, and a UI prototype.

Structure

  • 8 sections: Design principles → Architecture → 10 core modules → Tech stack → Roadmap → Directory layout → App detail page prototype → Summary
  • Left fixed sidebar with scrollspy (highlights active section on scroll)
  • Responsive — works on desktop/tablet/mobile

Content highlights

  • Architecture diagram: 4-layer CSS flex layout (Portal → Gateway → Core modules → Infra), no images
  • Module specs: SQL DDL for app_info / app_environment, YAML pipeline config example, RBAC table, deployment flow diagrams (K8s + VM paths)
  • Roadmap: 4-phase color-coded timeline with effort estimates
  • App detail prototype: full wireframe with env cards, release history table, and live-looking metrics

Implementation notes

  • Pure inline CSS — zero external dependencies, works offline
  • Tech-blue theme (#1a73e8) with dark sidebar (#0d1b2e)
  • Syntax highlighting for SQL/YAML via CSS span classes (no JS library)
Original prompt

任务

zeus-docs 仓库中创建一个精美的 HTML 文件 zeus-platform-design.html,将以下运维研发协作平台设计方案整理成一个完整的、可独立打开的 HTML 文件。

要求

  1. 文件位置:在仓库根目录下创建 zeus-platform-design.html
  2. 样式要求
    • 使用内联 CSS,不依赖外部资源,可离线打开
    • 现代化、专业的设计风格,适合企业内部分享
    • 响应式布局,支持不同屏幕尺寸
    • 使用合适的配色方案(可参考深蓝/科技蓝主题)
    • 代码块、表格、流程图等要美观易读
    • 添加目录导航,支持点击跳转
    • 左侧固定目录栏 + 右侧内容区的布局
  3. 内容要求:将以下完整方案内容全部整理进去,不要遗漏任何模块

完整方案内容

一、设计理念

原则 说明
以应用为一等公民 所有功能围绕"应用"展开,一个应用串联 CMDB、CI/CD、监控、工单
研发运维一体化 打破 Dev 与 Ops 的壁垒,研发可自助完成 80% 的运维操作
融合开源不造轮子 集成成熟开源组件(Jenkins/ArgoCD/Prometheus/Grafana 等),做统一入口
开箱即用 + 可扩展 中小企业拿来就能用,同时支持二次开发

二、平台架构总览

展示分层架构图:

  • 统一门户 (Vue3 + VbenAdmin5) / 权限中心 (RBAC + 数据权限) / 通知中心 (飞书/钉钉/企微/邮件)
  • API Gateway (SpringBoot3)
  • 核心模块:应用中心 / CMDB / CI/CD / 监控告警 / 工单协作 / 作业平台 / 配置中心 / 堡垒机 / 文档知识库 / 变更审计
  • 基础设施层:Kubernetes集群 / 虚拟机/ECS / 数据库(MySQL/Redis) / 中间件(MQ/ES/Nacos)

三、核心模块详细设计

模块1:🎯 应用中心(核心枢纽)

  • 应用元信息:应用名称(唯一标识)、应用类型(Web服务/后台任务/定时Job/前端SPA/中间件)、技术栈、Git仓库地址、所属部门/团队、负责人(主备)、应用等级(P0核心/P1重要/P2普通)
  • 应用生命周期:创建 → 开发 → 构建 → 测试 → 部署 → 运行 → 监控 → 下线
  • 关联关系:所属服务器/容器、关联的数据库实例、关联的域名、上下游依赖应用、关联的CI/CD流水线、关联的监控大盘

包含数据库表设计示例:

-- 应用基础表
CREATE TABLE `app_info` (
    `id`              BIGINT PRIMARY KEY AUTO_INCREMENT,
    `app_name`        VARCHAR(128) NOT NULL UNIQUE COMMENT '应用唯一标识',
    `app_name_cn`     VARCHAR(256) COMMENT '中文名称',
    `app_type`        TINYINT NOT NULL COMMENT '应用类型: 1-Web 2-后台 3-Job 4-前端',
    `language`        VARCHAR(32) COMMENT '开发语言',
    `git_repo`        VARCHAR(512) COMMENT 'Git仓库地址',
    `department_id`   BIGINT COMMENT '所属部门',
    `owner_id`        BIGINT NOT NULL COMMENT '负责人',
    `backup_owner_id` BIGINT COMMENT '备份负责人',
    `app_level`       TINYINT DEFAULT 2 COMMENT '应用等级: 0-P0 1-P1 2-P2',
    `description`     TEXT COMMENT '描述',
    `status`          TINYINT DEFAULT 1 COMMENT '1-正常 0-已下线',
    `created_at`      DATETIME DEFAULT CURRENT_TIMESTAMP,
    `updated_at`      DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    INDEX `idx_department` (`department_id`),
    INDEX `idx_owner` (`owner_id`)
) COMMENT '应用信息表';

-- 应用环境关联表
CREATE TABLE `app_environment` (
    `id`              BIGINT PRIMARY KEY AUTO_INCREMENT,
    `app_id`          BIGINT NOT NULL,
    `env_type`        VARCHAR(32) NOT NULL COMMENT 'dev/test/staging/prod',
    `deploy_type`     VARCHAR(32) COMMENT 'k8s/vm/ecs',
    `cluster_id`      BIGINT COMMENT 'K8s集群ID',
    `namespace`       VARCHAR(128) COMMENT 'K8s命名空间',
    `server_ids`      JSON COMMENT '虚拟机部署时的服务器列表',
    `domain`          VARCHAR(256) COMMENT '访问域名',
    `config_ref`      VARCHAR(256) COMMENT '配置引用',
    `created_at`      DATETIME DEFAULT CURRENT_TIMESTAMP,
    UNIQUE KEY `uk_app_env` (`app_id`, `env_type`)
) COMMENT '应用环境表';

模块2:📦 CMDB(配置管理数据库)

资源类型:

  • 物理服务器:主机名/IP/IDC/机架位/配置(CPU/内存/磁盘)/采购日期/过保日期/资产编号
  • 云服务器/ECS:实例ID/云厂商/区域/可用区/规格/镜像/VPC/安全组
  • Kubernetes集群:集群名/版本/节点数/Master/Worker节点信息
  • 数据库实例:类型(MySQL/Redis/MongoDB/ES)/主从关系/连接地址/端口
  • 域名:域名/解析类型/解析值/SSL证书到期时间
  • 网络设备:交换机/路由器/防火墙/负载均衡

核心能力:自动采集(Agent+云API自动同步)、拓扑关系(应用→服务器→机房)、变更历史(所有字段变更可追溯)、标签体系

模块3���🚀 CI/CD 流水线

同时支持容器(K8s)和虚拟机两种部署模式:

  • 容器部署:Git → Docker Build → Push Registry → K8s Rolling Update → Health Check
  • 虚拟机部署:Git → Maven/Gradle → 制品上传 → 分批下发到服务器 → 重启服务 → Health Check

核心功能:可视化流水线编排、多环境发布(dev→test→staging→prod)、灰度发布/金丝雀发布、一键回滚(保留最近10个版本)、发布审批(生产环境需审批)、发布锁(防止同时发布冲突)

包含流水线配置YAML示例:

pipeline:
  app: zeus-api
  trigger:
    - type: manual
    - type: webhook
      branch: main
  stages:
    - name: 代码检查
      steps:
        - plugin: sonarqube
          params:
            quality_gate: true
    - name: 编译构建
      steps:
        - plugin: maven_build
          params:
            jdk_version: "17"
            command: "mvn clean package -DskipTests"
    - name: 镜像构建
      steps:
        - plugin: docker_build
          params:
            dockerfile: "./Dockerfile"
            registry: "harbor.company.com"
            tag: "${GIT_COMMIT_SHORT}"
    - name: 部署
      approval:
        required: true
        approvers: ["ops-team"]
      steps:
        - plugin: k8s_deploy
          params:
            cluster: "prod-cluster"
            namespace: "default"
            strategy: "rolling"
            replicas: 3
    - name: 验证
      steps:
        - plugin: health_check
          params:
            url: "https://zeus-api.company.com/health"
            timeout: 60

模块4:📊 监控告警

集成方案:Prometheus+Grafana(指标)、Loki/ELK(日志)、SkyWalking/Jaeger(链路追踪,可选)、Alertmanager(告警)

平台职责:统一入口(从应用详情页一键跳转Grafana大盘)、告警规则管理(通过平台管理Prometheus告警规则)、告警通知(统一告警收敛/升级/通知)、值班管理(排班表+自动分派)、告警事件(历史记录+处理状态追踪)

默认监控大盘:

  • 应用维度:QPS/响应时间(P50/P90/P99)/错误率/JVM内存/GC/线程数/Goroutine/内存
  • 主机维度:CPU/内存/磁盘/网络
  • 中间件维度:MySQL慢查询/连接数/Redis内存/命中率

模块5:📋 工单协作

工单类型:权限申请、资源申请、变更申请、故障报修、通用工单

审批流程:可视化流程编排(类似钉钉审批)、串行/并行审批/条件分支、审批人(指定人/角色/应用负责人/部门主管)、超时处理(自动提醒/自动升级)

自动化联动:权限工单审批通过→自动配置权限、资源申请通过→自动创建资源、配置变更通过→自动下发配置

模块6:🔧 作业平台

  • 批量命令执行:选择目标机器、...

This pull request was created from Copilot chat.


💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

@wufeiqun wufeiqun marked this pull request as ready for review March 25, 2026 10:15
@wufeiqun wufeiqun merged commit adae658 into master Mar 25, 2026
1 check passed
Copilot AI changed the title [WIP] Add zeus-platform-design.html with complete design plan Add zeus-platform-design.html — self-contained DevOps platform design doc Mar 25, 2026
Copilot AI requested a review from wufeiqun March 25, 2026 10:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants