文档导航与搜索

应用发布与变更

登记服务、配置构建和部署环境,跟踪发布步骤,并在需要时使用已验证的回退路径。

适合: 发布负责人、运维工程师与审批人内容核对:
本页目录

发布前准备

  • 先进入“发布与变更 → 发布环境”,检查发布编排、受控作业、专用构建池和制品通道。基础环境就绪后,具体服务仍需通过目标、权限和发布前检查;未就绪时由管理员处理提示的条件。
  • 先在 CMDB 的服务资产中登记服务并选择所属应用,再在“发布与变更”绑定它。历史配置显示“待关联资产”时,先由管理员核对关联。
  • 准备专用构建主机池、在线 Agent 与制品存储。构建节点和实际部署节点分别选择,不将生产业务主机当作默认构建机。
  • 确认目标运行时和网络。主机部署不会替您安装 Java 等运行时;Kubernetes 拉取私有镜像需要集群管理员配置 imagePullSecret。

配置服务

  1. 仓库:填写实际 Git 地址和默认分支,私有仓库使用匹配协议的托管凭据。优先使用只授予该仓库必要权限的专用凭据。
  2. 构建:填写构建命令和精确制品路径,选择可用构建环境。容器构建与主机构建不同,环境不可用时应修复条件,不依赖自动降级。
  3. 部署:按环境配置 systemd 主机、单机 Docker 或 Kubernetes。主机模式选择精确节点,Kubernetes 选择集群和 namespace。
  4. 观察:选择健康检查和观察指标。使用 Prometheus 时先测试数据源与查询;只等待固定时长不等于已经检查业务健康。

触发与跟踪发布

  1. 首次使用建议手动新建发布,确认服务、环境和分支或标签,以及本次目标范围。
  2. 按已启用策略处理变更工单、发布窗口、冻结期或审批;未满足条件时查看原因,不通过重复提交绕过。
  3. 依次查看环境检查、检出、构建、制品回传、部署、观察和记录。某步失败时查看该步骤的状态、摘要及输出。
  4. 完成后核对目标服务、制品与观察结果。不要只因构建成功就认定发布完成。

暂停恢复与回滚

暂停阻止后续步骤继续推进,不会强制杀死已经派发的当前步骤。需要恢复时,先检查当前目标和步骤状态。终态任务不能按运行中任务处理。

回滚依赖仍可用的历史制品、对应部署配置和权限。数据库变更不因应用回滚自动撤销;发布前应单独评估数据兼容和恢复方案。

发布失败的排查顺序

阶段优先检查
环境检查Agent、运行时、磁盘、目录权限和端口
仓库检出地址、分支、协议与凭据是否匹配
构建或制品回传失败输出、工具链与精确制品路径
部署与观察目标环境、镜像拉取、健康检查、指标阈值和无数据策略
遇到与文档不一致的情况

请提供部署版本、页面和脱敏后的现象,我们会协助核对并更新文档。

weiwendi@aiops.red