罗罗编程学习记录
本页内容 展开查看

06.5.8.12 CI/CD 流水线与发布

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.8 PHP 配套技术栈

06.5.8.12-001 一条 PHP 项目流水线通常划分哪些阶段?

一句话结论

典型阶段为:代码检出 → 依赖安装 → 静态检查与测试门禁 → 构建打包/镜像 → 部署到目标环境 → 发布后验证;阶段顺序保证质量问题在部署前阻断。

概念解释

CI 阶段持续集成:每次提交触发检查、测试与构建;CD 阶段持续交付/部署:通过门禁的产物按环境发布。每个阶段有明确准入与退出条件,失败即阻断后续。PHP 项目无编译二进制,但仍需依赖安装、自动加载优化与产物打包。

原理流程

  1. 检出指定分支/标签代码,固定运行时版本与工具版本。
  2. 安装 Composer 依赖,执行静态检查与单元测试。
  3. 构建产物或镜像并打版本标签,留存制品。
  4. 部署到对应环境,执行健康检查与冒烟验证。

代码或图示

// 文档示例:流水线阶段顺序(YAML 表达在 CI 配置文件中)
// stages: [checkout, install, lint-test, build, deploy, verify]
// 门禁:静态检查失败 / 测试失败 → 中断,不进入 build
// 产物:构建产物与镜像标签绑定 commit sha,便于追溯与回滚

常见误区

  • 测试与部署并行不设门禁:未通过检查的版本被发布出去。
  • 流水线阶段职责混杂:一个步骤里既装依赖又改配置,失败定位困难。

追问

  • CI 与 CD 边界在哪?答:CI 产出可部署制品,CD 负责按策略把制品送到环境;是否自动上生产取决于发布规范。
  • 阶段可以并行吗?答:无依赖的检查任务可并行,部署与验证必须在构建成功之后。

06.5.8.12-002 Composer 依赖安装如何做缓存与复现?

一句话结论

以 composer.lock 锁定版本,缓存 Composer 全局下载目录;安装时按锁文件还原依赖,缓存命中可跳过重新下载;缓存失效策略与锁文件变更挂钩,避免脏缓存进入构建。

概念解释

依赖缓存分下载包缓存与 vendor 目录缓存:前者减少网络下载,后者直接复用安装结果。vendor 缓存依赖运行时与平台扩展一致性,跨环境复用需评估兼容性。锁文件提交入库保证各环境版本一致;缓存目录在流水线中按路径声明并复用。

原理流程

  1. 检出代码后核对 composer.lock 存在且与 composer.json 一致。
  2. 配置 Composer 缓存目录挂载到流水线缓存区。
  3. 按锁文件安装生产依赖,生成优化自动加载。
  4. 锁文件变更或缓存过期时重新解析下载。

代码或图示

// 文档示例:安装命令方向(参数以 Composer 版本为准,待确认)
// composer install --no-dev --no-interaction --prefer-dist --optimize-autoloader
// 缓存:Composer 全局缓存目录在流水线缓存中持久化
// 校验:composer validate 检查清单与锁文件一致性

常见误区

  • 不提交锁文件:构建依赖版本随解析时间漂移,复现性差。
  • 复用 vendor 缓存不校验平台要求:PHP 版本或扩展差异导致自动加载与函数不兼容。

追问

  • 缓存被污染怎么办?答:提供清缓存重建入口,锁文件升级后强制刷新依赖。
  • 私有源凭证在流水线怎么用?答:注入 CI 机密变量,不写入仓库与缓存文件。

06.5.8.12-003 静态检查在流水线中包含哪些工具层?

一句话结论

三层:语法检查(php -l)、代码风格检查(代码规范修复/检查工具)、静态分析(类型与静态缺陷分析);三层依次运行,风格问题可自动修复,静态分析问题按门槛阻断。

概念解释

语法检查保证文件可解析;风格检查统一命名、排版与规范;静态分析在不运行代码的情况下推断类型、空值、未定义调用与潜在缺陷。工具版本与规则集纳入仓库配置,流水线按固定规则执行,避免本地与 CI 标准不一致。

原理流程

  1. 对全部 PHP 文件执行语法 lint。
  2. 运行风格检查,差异按规范自动修复或上报阻断。
  3. 运行静态分析,按配置级别报告错误并对照门禁阈值。
  4. 检查结果留存为构建记录,便于回溯引入版本。

代码或图示

// 文档示例:检查命令方向(工具以项目实际引入为准,待确认)
// php -l 逐个文件解析
// 代码风格工具:检查规范差异
// 静态分析工具:分析类型推断与潜在缺陷,输出错误清单
// 配置文件随仓库管理:规则级别、排除目录与基线一致

常见误区

  • 只做语法检查:类型错误与空值缺陷在运行时才暴露。
  • 静态分析级别调得过松:门禁形同虚设;过严则大量存量问题阻塞迭代。

追问

  • 存量代码怎么接入分析?答:先建基线记录现有问题数,新增代码按严格门槛,存量逐步收敛。
  • 风格自动修复能否直接提交?答:修复应在本地或单独修复流程完成,CI 以检查阻断为主,不直接回写仓库。

06.5.8.12-004 单元测试门禁如何设置,覆盖率门槛怎么定?

一句话结论

流水线执行测试套件,失败即阻断;覆盖率按模块设定门槛(核心业务高、外围模块低),覆盖率只作为辅助指标,不能替代用例质量;新代码应带测试,测试随代码同流水线运行。

概念解释

测试门禁包括:测试全部通过、关键模块覆盖率不低于阈值、不允许新增失败用例。覆盖率统计行/分支覆盖,高覆盖率不等于无缺陷。PHP 测试框架与覆盖率驱动扩展以项目环境为准;当前 CLI 环境未实测测试运行,具体命令与扩展状态待确认。

原理流程

  1. 安装开发依赖(含测试框架与覆盖率工具)。
  2. 执行测试套件,收集通过/失败与覆盖率数据。
  3. 对照门槛:失败用例或覆盖率低于阈值则中断流水线。
  4. 测试报告留存,失败用例定位到提交与改动。

代码或图示

// 文档示例:测试执行方向(命令以项目框架为准,待确认)
// 测试框架运行全部用例,输出通过/失败统计
// 覆盖率报告:核心模块阈值高于外围模块
// 门禁规则:存在失败用例 → 阻断;覆盖率低于阈值 → 阻断或告警

常见误区

  • 追求高覆盖率写无断言用例:数字好看但不校验行为。
  • 把覆盖率当唯一质量标准:边界、集成与异常路径仍需专门用例。

追问

  • 集成测试放哪一阶段?答:依赖服务可用的环境执行,可作为部署前单独阶段,不与纯单元测试混在同一门禁。
  • 测试变慢怎么办?答:拆分套件、并行执行、隔离慢用例,避免流水线时长失控。

06.5.8.12-005 构建产物如何打包与留存?

一句话结论

构建产出不可变制品(含 vendor、自动加载与发布代码),绑定版本标识留存仓库;部署只取制品,不在目标环境现场安装依赖,保证构建与运行版本一致。

概念解释

PHP 制品通常是打包好的代码目录或容器镜像。制品生成后不再修改,部署环境拉取同一制品发布。制品留存周期覆盖回滚需要的版本范围;构建记录关联 commit、作者与流水线编号。现场 composer install 会引入网络与版本不确定性,生产部署应避免。

原理流程

  1. 检查测试通过后生成制品:优化自动加载、剔除开发文件。
  2. 制品打标签(commit sha、语义版本号)并上传制品仓库/镜像仓库。
  3. 记录制品与源码提交、流水线编号的对应关系。
  4. 部署阶段按标签拉取制品,环境差异通过配置注入。

代码或图示

// 文档示例:制品内容方向
// 发布代码 + vendor + 优化自动加载 + 配置模板
// 排除:tests、docs、本地配置、日志与临时文件
// 标签:commit sha 不可变;语义版本号对应正式发布
// 部署:从制品仓库拉取,不在目标机执行依赖安装

常见误区

  • 生产部署时现场装依赖:网络波动或源差异导致版本不一致。
  • 制品包含本地配置与机密:配置外置,制品保持环境无关。

追问

  • 制品保留多久?答:覆盖回滚窗口内的所有历史版本,过期制品按规范清理。
  • 镜像与代码包制品如何选?答:容器化部署用镜像制品;传统主机部署用代码包制品,两者都要版本可追溯。

06.5.8.12-006 镜像标签与推送策略如何设计?

一句话结论

镜像标签绑定不可变标识(commit sha 或版本号),流水线通过认证推送到镜像仓库;禁止用可变 latest 标签作为部署依据,回滚与追溯靠固定标签定位历史镜像。

概念解释

镜像仓库保存各版本镜像与摘要;标签策略区分临时构建、发布候选与正式版本。推送凭证使用 CI 机密,不在仓库保存。镜像摘要(digest)可作为最精确的版本定位,标签可读但可能被覆盖。仓库地址与命名规范按项目基础设施确定,不在文档中写死。

原理流程

  1. 构建阶段生成镜像,打 commit sha 标签与版本标签。
  2. 使用流水线注入的仓库凭证登录并推送。
  3. 记录镜像标签与 digest 到发布记录。
  4. 部署按固定标签或 digest 拉取,回滚切换到历史标签。

代码或图示

// 文档示例:标签方向(仓库地址以项目基础设施为准)
// 不可变标签:registry/app:<commit-sha>
// 发布标签:registry/app:<semver>
// 部署引用:固定标签或镜像 digest,不使用 latest
// 凭证:CI 机密变量注入,流水线日志不回显

常见误区

  • 部署跟随 latest:镜像内容随推送变化,版本不可追溯。
  • 标签只记版本号不记 commit:补丁覆盖后无法区分构建来源。

追问

  • digest 与标签区别?答:digest 是镜像内容哈希,不可变;标签是可读别名,可被重新指向。
  • 镜像推送失败怎么处理?答:流水线阻断,不进入部署;重试限制次数后转人工排查凭证与仓库状态。

06.5.8.12-007 流水线中的配置与机密如何管理?

一句话结论

非敏感配置按环境走配置文件与变量;机密(密码、密钥、令牌)由 CI/CD 机密管理注入,不入库、不进镜像、不出现在日志;流水线变量按环境与作用域隔离。

概念解释

配置分环境默认值、环境覆盖值与运行时机密三层。仓库保存示例配置与占位符,真实值在部署环境注入。机密在流水线中以遮蔽变量传递,构建脚本读取环境变量而非硬编码。镜像层一旦写入机密无法通过删除彻底清除,必须在构建前避免。

原理流程

  1. 梳理配置项:公开默认值、环境差异项、机密项。
  2. 仓库提交示例配置与模板,真实值不入库。
  3. CI 按环境配置变量与机密,构建/部署阶段注入。
  4. 检查日志、制品与镜像层不泄露机密值。

代码或图示

// 文档示例:机密使用方向
// 应用读取:getenv('DB_PASSWORD') / getenv('API_SECRET')
// 仓库文件:.env.example 只含占位符
// CI 配置:机密变量按环境隔离,日志自动遮蔽
// 禁止:Dockerfile ENV 写入真实密钥、制品包内包含 .env 生产值

常见误区

  • 把 .env 生产文件提交仓库:历史记录永久留存机密。
  • 流水线步骤回显机密变量:日志采集后造成二次泄露。

追问

  • 部署到目标环境的机密怎么落地?答:由部署系统从机密管理下发到环境,应用启动时读取,不写入镜像。
  • 轮换密钥在流水线怎么配合?答:新旧密钥过渡期双读,轮换后更新机密注入值。

06.5.8.12-008 常见发布策略有哪些,各自适用场景是什么?

一句话结论

滚动发布逐步替换旧实例;蓝绿部署两套环境切换流量;灰度(金丝雀)先放小比例流量到新版本观察;策略按回滚速度、容量成本与风险容忍度选择。

概念解释

滚动发布在不保留全量旧环境的情况下逐批替换,资源省但回滚需重新部署旧版本。蓝绿同时运行新旧两套,切流即回滚,资源成本翻倍。灰度按用户/流量比例逐步放量,异常可快速收窄流量。PHP 服务无状态实例替换较直接,有状态数据变更需单独评估。

原理流程

  1. 评估发布风险:核心交易链路优先蓝绿或灰度,外围服务可滚动。
  2. 准备新版本实例与健康检查,确认就绪后接流量。
  3. 按策略分批替换或放量,观察错误率与业务指标。
  4. 异常时按策略切回旧版本或停止放量。

代码或图示

// 文档示例:策略对照
// 滚动:逐批停旧启新,资源占用平稳,回滚=重新部署旧版
// 蓝绿:新环境就绪 → 流量切换;回滚=切回旧环境
// 灰度:5% → 20% → 50% → 100%,每档观察指标
// 前提:实例无状态,数据向后兼容,可双版本短暂并存

常见误区

  • 数据结构不兼容就灰度:新旧版本读写同一库,旧版本读不了新结构会出错。
  • 蓝绿环境共享本地状态:会话、上传文件需外置到共享存储。

追问

  • 灰度按什么维度切流?答:用户 ID、地域、渠道或请求头;规则在网关/负载层配置。
  • 发布期间会话怎么处理?答:会话外置(缓存/数据库),实例替换不影响登录态。

06.5.8.12-009 回滚方案如何设计与触发?

一句话结论

回滚依赖可快速获取的历史制品与明确触发条件;先回退代码/镜像版本,再评估数据库变更是否可逆;回滚流程预先演练,触发后按预案执行并记录。

概念解释

应用回滚是把实例切回上一稳定制品;数据库变更若向前不兼容,应用回滚后可能无法工作,因此迁移要设计向后兼容或配套回滚脚本。触发条件包括错误率、延迟、核心业务指标越阈值与人工判断。回滚后需验证旧版本功能与数据一致性。

原理流程

  1. 留存最近若干稳定版本制品与部署记录。
  2. 定义回滚触发指标与决策人,预案包含回退步骤与预计耗时。
  3. 触发后切回旧制品,观察实例健康与核心指标。
  4. 核对数据库变更兼容性,必要时执行回滚迁移。
  5. 记录回滚原因、过程与后续整改项。

代码或图示

// 文档示例:回滚检查项
// [ ] 历史制品/镜像标签可用
// [ ] 数据库变更向后兼容或有回滚脚本
// [ ] 配置与旧版本兼容
// [ ] 回滚后健康检查与冒烟用例通过
// 触发:错误率/延迟/业务指标越阈值,或发布人判断异常

常见误区

  • 只准备代码回滚不评估数据库:结构变更不可逆,旧版本启动即报错。
  • 回滚预案未演练:真故障时步骤不熟,回滚耗时拉长。

追问

  • 数据已经被新版本写入怎么办?答:回滚前评估数据兼容性;不兼容的变更需配套数据修复,不能简单切版本。
  • 回滚也算一次发布吗?答:是,同样需要变更记录与发布验证。

06.5.8.12-010 发布后验证包含哪些内容?

一句话结论

发布后依次做实例健康检查、核心链路冒烟用例与指标观察;验证覆盖进程存活、关键接口、下游依赖与业务指标,观察期内异常按预案处理。

概念解释

健康检查确认实例启动并通过探活;冒烟用例覆盖登录、下单等核心路径;指标观察错误率、延迟、队列积压与资源水位。验证分自动检查与人工观察,观察期长度按业务重要性设定。发布记录关联验证结果,未通过验证不视为发布完成。

原理流程

  1. 新版本实例就绪后执行健康检查与探活。
  2. 跑核心链路冒烟用例,确认关键接口返回正常。
  3. 观察错误率、响应耗时、下游依赖与积压指标。
  4. 观察期结束无异常则发布完成;异常进入回滚或修复流程。

代码或图示

// 文档示例:发布后验证清单
// 健康:实例状态、探活接口、进程数
// 冒烟:核心接口 200、关键业务动作成功
// 指标:错误率 / P95 延迟 / 队列 lag / 资源水位
// 记录:验证时间、执行人、结果与遗留问题

常见误区

  • 实例启动成功就算发布完成:未验证业务链路,隐藏的接口错误被用户发现。
  • 只看 HTTP 200:业务失败可能返回 200 但结果错误,需断言关键数据。

追问

  • 冒烟用例放哪里维护?答:随仓库维护可自动化执行的核心路径用例,部署后流水线调用。
  • 观察期多长合适?答:核心链路覆盖高峰时段与一个业务周期,外围服务可缩短。

06.5.8.12-011 变更记录应该包含哪些信息?

一句话结论

变更记录包含版本标识、改动清单、影响范围、发布人/审批人、时间、验证结果、回滚方案与遗留问题;记录可追溯到提交、制品与流水线编号。

概念解释

发布记录是事后排查与审计的依据:出问题时能快速定位「哪个版本、改了什么、谁发布、如何回退」。改动清单关联需求与缺陷编号;影响范围说明涉及的服务、接口与数据。记录格式按团队规范统一,流水线自动填充可追溯字段。

原理流程

  1. 发布前汇总提交清单、需求编号与配置变更。
  2. 记录版本制品、环境、发布人与审批人。
  3. 发布后填写验证结果、观察指标与遗留问题。
  4. 归档记录,关联流水线编号与镜像/制品标签。

代码或图示

// 文档示例:变更记录字段
// 版本 / commit sha / 流水线编号
// 改动清单(需求、缺陷、配置项)
// 影响范围(服务、接口、数据)
// 发布人 / 审批人 / 时间
// 验证结果 / 回滚版本 / 遗留问题

常见误区

  • 只记「已发布」:无改动清单与回滚版本,故障时无法追溯。
  • 配置变更不记录:环境漂移无法与代码变更区分。

追问

  • 自动生成哪些字段?答:commit 列表、制品标签、流水线编号可由流水线填充;业务影响与审批人工确认。
  • 历史记录保留多久?答:按审计与合规要求留存,覆盖追溯与回滚窗口。

06.5.8.12-012 分支策略与流水线触发如何配合?

一句话结论

按分支模型定义触发规则:开发分支跑检查与测试,发布分支/标签触发构建与部署;生产发布可加人工审批,标签对应正式版本。

概念解释

常见模型为功能分支合入主干、主干出发布分支、标签标记版本。流水线触发事件包括推送、合并、标签创建与手动执行。不同环境对应不同分支或标签:测试环境跟主干,预发跟发布分支,生产由标签或审批触发。规则在 CI 配置中显式声明。

原理流程

  1. 确定分支模型:主干、发布分支、功能分支与标签约定。
  2. 为每类事件配置流水线阶段与目标环境。
  3. 生产发布设置审批节点,通过后才部署。
  4. 标签创建触发正式制品构建与归档。

代码或图示

// 文档示例:触发规则方向
// 功能分支推送:lint + 测试,不部署
// 主干合并:构建制品,部署测试环境
// 发布分支:部署预发,人工确认
// 标签:构建正式版本,审批后部署生产

常见误区

  • 所有推送直接上生产:缺少门禁与审批,风险不可控。
  • 标签与制品不对应:版本号与代码提交关系混乱。

追问

  • 热修复怎么走?答:从稳定版本拉出修复分支,测试后打补丁标签发布,再回填主干。
  • 手动执行流水线要记录吗?答:要,记录执行人、参数与结果,纳入变更追溯。

06.5.8.12-013 多环境配置如何分离与校验?

一句话结论

环境按开发、测试、预发、生产分层,配置基线相同、环境值分别覆盖;部署前校验配置完整性与必填项,禁止跨环境复用机密。

概念解释

环境差异包括依赖地址、开关、日志级别、资源规格与机密。配置模板在仓库维护,环境值由部署系统注入。上线前检查必填配置存在、格式合法、指向正确环境;测试环境配置不得连接生产数据。各环境独立部署与回滚。

原理流程

  1. 定义配置项清单与默认值,区分环境覆盖项。
  2. 各环境在部署系统维护对应变量与机密。
  3. 部署前执行配置校验:必填项、格式、连接目标。
  4. 发布后核对运行配置与预期一致。

代码或图示

// 文档示例:配置分层
// 仓库:配置模板 + .env.example
// 环境变量:DB_HOST / CACHE_HOST / 功能开关 / 日志级别
// 校验:启动前检查必填项,缺失则退出并提示
// 隔离:测试环境不得使用生产库与生产密钥

常见误区

  • 一套配置改地址直接复用:开关、日志级别与机密串环境。
  • 配置错误到运行时才暴露:应在部署前校验阶段拦截。

追问

  • 配置变更需要走流水线吗?答:影响运行行为的配置变更纳入发布记录,按环境受控下发。
  • 环境间数据怎么隔离?答:各环境独立数据库与缓存,连接配置分别指向。

06.5.8.12-014 数据库变更在发布流程中处于什么位置?

一句话结论

迁移脚本随版本管理,在应用部署前或兼容窗口内执行;变更保持向后兼容,可回滚或有数据修复方案,迁移与应用发布分开可独立验证。

概念解释

数据库变更包括 DDL、数据修正与初始化脚本。先做兼容变更(加列、加表),应用双写或兼容读取,再清理旧结构;避免直接删列改类型导致旧版本不可用。迁移脚本按版本顺序执行,记录执行状态。大表 DDL 需评估锁与耗时,安排在低峰窗口。

原理流程

  1. 迁移脚本随代码入库,按版本编号排序。
  2. 部署前在对应环境执行迁移并验证结果。
  3. 应用版本与数据库结构兼容,支持双版本短暂并存。
  4. 不兼容变更准备回滚脚本或数据修复方案。

代码或图示

// 文档示例:兼容变更顺序
// 1. 加新列/新表(旧版本不受影响)
// 2. 应用双写或兼容读取
// 3. 数据回填与校验
// 4. 后续版本清理旧列
// 迁移执行:独立任务运行,记录成功/失败与脚本版本

常见误区

  • 应用与迁移同时上线且结构不兼容:回滚应用后数据库结构无法配合。
  • 迁移脚本手工在生产执行不记录:变更不可追溯,重复执行风险高。

追问

  • 迁移失败怎么办?答:停止发布,按脚本事务与错误信息修复;已执行部分评估回滚,不强行继续部署。
  • 大表变更怎么安排?答:评估锁与复制延迟,使用在线 DDL 方案并在低峰窗口执行。

06.5.8.12-015 如何控制流水线时长与并行度?

一句话结论

无依赖阶段并行执行,依赖缓存减少重复下载,测试套件拆分与按需执行;流水线时长纳入监控,避免排队等待成为发布瓶颈。

概念解释

耗时来源包括依赖安装、测试执行、构建打包与部署等待。并行可缩短墙钟时间,但受执行资源限制。缓存命中、增量检查与慢用例隔离是主要优化点。流水线过长会降低反馈速度,也容易出现超时与环境残留问题。

原理流程

  1. 梳理阶段依赖关系,无依赖任务并行。
  2. 复用依赖缓存与构建产物,减少重复安装。
  3. 拆分测试套件,慢用例单独调度。
  4. 统计各阶段耗时,定位瓶颈阶段持续优化。

代码或图示

// 文档示例:时长优化方向
// 并行:lint / 静态分析 / 测试 无依赖时同时跑
// 缓存:Composer 下载目录、构建产物
// 拆分:单元测试快反馈,集成测试单独阶段
// 监控:各阶段耗时趋势,超时阈值告警

常见误区

  • 所有任务串行:简单改动也要等待完整长流程。
  • 盲目并行挤占资源:执行器不足时排队反而更慢。

追问

  • 慢测试怎么处理?答:先区分是用例本身慢还是依赖慢;隔离慢用例并优化,不拖垮主门禁。
  • 流水线缓存失效频繁怎么办?答:检查缓存键与变更触发条件,避免无关变更击穿缓存。

06.5.8.12-016 如何保证构建产物与部署版本一致?

一句话结论

制品在通过门禁后一次性构建并固定标签,部署只拉取制品不在现场改动;版本记录关联 commit、制品与部署实例,保证线上运行的就是测试通过的版本。

概念解释

版本漂移来自现场安装依赖、手工改文件、制品被覆盖等环节。不可变制品消除这些变量:构建一次,各环境重复部署同一制品。配置差异在部署时注入,不改变制品内容。实例上运行代码与制品清单可比对校验。

原理流程

  1. 测试通过后构建制品并绑定 commit 标识。
  2. 制品上传仓库,后续环境只拉取不重新打包。
  3. 部署记录实例运行的制品标签与 digest。
  4. 必要时比对实例文件清单与制品一致性。

代码或图示

// 文档示例:一致性保障
// 构建:门禁通过 → 生成制品 → 固定标签
// 部署:拉取同一制品,注入环境配置
// 校验:实例代码版本标识与制品标签一致
// 禁止:目标机现场 composer install、手工改代码

常见误区

  • 各环境分别构建:同一 commit 产物可能因依赖解析差异不同。
  • 部署后在服务器上热修代码:与制品记录脱节,下次部署被覆盖。

追问

  • 发现线上文件被改动怎么排查?答:比对制品清单与实例文件,核对部署记录与登录操作日志。
  • 配置文件算制品一部分吗?答:模板随制品,真实值部署注入;避免把环境配置打进不可变制品。

06.5.8.12-017 灰度观察期看哪些指标,达到什么条件继续放量?

一句话结论

观察错误率、响应延迟、核心业务指标与下游依赖健康;指标在阈值内且无新增异常,按档位继续放量,越阈值则暂停或回滚。

概念解释

灰度指标分技术指标与业务指标:技术侧错误率、P95/P99 延迟、超时率、资源水位;业务侧下单成功率、支付成功率等核心转化。小流量样本可能波动大,需结合样本量判断。每档放量后等待一个观察周期,指标稳定再进入下一档。

原理流程

  1. 定义各指标阈值与告警线,区分技术与业务指标。
  2. 小流量接入后采集指标,对比旧版本基线。
  3. 指标正常则提升流量比例;异常则暂停放量或回滚。
  4. 全量后继续观察至发布观察期结束。

代码或图示

// 文档示例:观察指标方向
// 技术:错误率 / 5xx 比例 / P95 延迟 / 超时 / 队列 lag
// 业务:核心动作成功率 / 转化指标
// 放量档位:5% → 20% → 50% → 100%
// 决策:阈值内继续;越阈值暂停;严重异常回滚

常见误区

  • 只看错误率不看延迟:慢请求积压在后续阶段才爆发。
  • 样本过小就下结论:小流量波动不代表全量表现,需达到最低样本量。

追问

  • 指标基线从哪来?答:同服务历史版本与同期对比,避免用绝对单一阈值判断。
  • 灰度发现问题怎么止损?答:先收窄流量到旧版本,再定位版本与配置变更。

06.5.8.12-018 流水线失败如何处理与追溯?

一句话结论

失败阶段阻断后续,按日志定位是代码、依赖、环境还是凭证问题;有限次重试区分瞬时故障与真实缺陷,失败记录关联提交与责任人,整改后重跑。

概念解释

失败类型:语法/测试缺陷、依赖下载失败、执行器环境异常、凭证过期、资源不足。瞬时故障(网络抖动)可有限重试,真实代码问题必须修复后重跑。重试不清除失败记录,避免掩盖问题。流水线历史保留各次失败原因与修复关联。

原理流程

  1. 失败时中断流水线,输出阶段日志与失败摘要。
  2. 分类根因:代码缺陷、依赖、环境、凭证、资源。
  3. 瞬时故障有限次重试;代码问题提交修复后重跑。
  4. 记录失败原因与整改措施,纳入质量复盘。

代码或图示

// 文档示例:失败处理流程
// 阻断:失败阶段不进入部署
// 分类:代码 / 依赖 / 环境 / 凭证 / 资源
// 重试:瞬时故障限次;不掩盖失败记录
// 追溯:失败记录关联 commit、提交人与修复提交

常见误区

  • 失败就反复重试:真实缺陷被重试偶发通过,问题流入后续环境。
  • 不保留失败日志:下次同类问题无法对比定位。

追问

  • 执行器环境问题怎么避免?答:固定工具与运行时版本,失败环境可重建;缓存定期清理。
  • 测试偶发失败怎么处理?答:先隔离 flaky 用例,修复稳定性后再纳入门禁。

06.5.8.12-019 如何检查发布后的配置漂移?

一句话结论

部署后核对实例运行配置、环境变量与版本标识是否符合预期;配置漂移通过配置基线对比与定期扫描发现,变更必须走受控流程并记录。

概念解释

配置漂移指线上实际配置与发布基线不一致,来源包括手工修改、残留旧环境变量、部署漏注入。检查方式:启动时输出配置版本与关键项(不泄露机密)、配置中心对账、定期扫描实例环境与配置文件。漂移发现后评估影响并回收到受控值。

原理流程

  1. 维护各环境配置基线清单与默认值。
  2. 部署后读取实例运行配置,与基线对比。
  3. 定期扫描环境变量、配置文件与功能开关。
  4. 发现漂移记录来源,回收至基线并补充流程缺口。

代码或图示

// 文档示例:漂移检查方向
// 启动上报:配置版本号、非敏感配置项、运行环境标识
// 对账:实例配置 vs 环境基线
// 扫描:环境变量残留、配置文件修改时间与属主
// 原则:配置变更走部署流程,禁止线上手工改

常见误区

  • 只在部署时检查:运行期间手工改动无法发现。
  • 上报配置时打印机密:核对只输出非敏感项与指纹。

追问

  • 漂移与正常配置变更怎么区分?答:正常变更有发布记录与基线更新;无记录的实例差异视为漂移。
  • 配置中心与本地文件冲突怎么办?答:明确加载优先级,运行配置以受控来源为准。

06.5.8.12-020 PHP 项目在流水线中有哪些特有的注意点?

一句话结论

关注运行时与扩展版本一致、自动加载优化、OPcache 配置、开发依赖剥离与代码静态资源构建;确保构建环境与运行环境扩展、PHP 版本对齐,避免本地通过、线上缺扩展。

概念解释

PHP 无编译期类型强约束,扩展缺失与函数不兼容常在运行时暴露;流水线执行环境要与生产运行时版本、扩展清单对齐。自动加载在生产优化为类映射;OPcache 按生产配置固化。前端资源、静态文件需在构建阶段生成并随制品发布。当前环境 PHP 8.5.9 CLI,已装 redis、pdo_mysql、Zend OPcache;容器/生产扩展清单以镜像实测 php -m 为准,待确认项标注。

原理流程

  1. 固定 PHP 版本与扩展清单,CI 与运行镜像一致。
  2. 生产安装剔除 dev 依赖,生成优化自动加载。
  3. 固化 OPcache 等运行时配置到镜像。
  4. 构建前端静态产物并纳入制品,核对发布目录完整。

代码或图示

// 文档示例:PHP 流水线核对项
// [ ] PHP 版本与生产镜像一致
// [ ] 扩展清单 php -m 对照基线(redis/pdo_mysql/opcache 等)
// [ ] composer install --no-dev --optimize-autoloader
// [ ] OPcache 配置固化,不开开发调试开关
// [ ] 静态资源产物已生成并进入制品
// 待确认:生产镜像实际扩展与版本以构建实测为准

常见误区

  • CI 用不同 PHP 版本跑测试:语法与函数兼容性问题带到线上才暴露。
  • 制品保留 dev 依赖与调试配置:体积与安全风险同时上升。

追问

  • 扩展缺失怎么在流水线提前发现?答:测试环境装齐生产扩展,启动冒烟与用例覆盖关键函数调用。
  • OPcache 在流水线要验证吗?答:生产配置固化进镜像;可在预发环境观察缓存命中与重启生效情况。