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

06.5.5.14 部署扩缩容与治理

所属:全栈开发面试题库 / 06 后端框架与工程实践 / 06.5 PHP 后端 / 06.5.5 Hyperf

06.5.5.14-001 生产部署镜像内需要包含什么?

一句话结论

镜像内包含 PHP CLI 运行时、必需扩展、项目代码与 Composer 依赖、入口脚本与配置模板;配置差异通过环境变量注入,不把环境专属地址、密钥烘焙进镜像,保证同一镜像可部署到多环境。

概念解释

常驻服务镜像不需要 Web 服务器(Nginx/FPM),但需要运行 Swoole/OpenSwoole 扩展与项目依赖。依赖在构建阶段安装,代码以版本标签固化;运行期配置、证书与密钥由部署环境挂载或注入。

原理流程

  1. 基础镜像选定 PHP CLI 版本与扩展。
  2. 构建阶段拷贝代码、安装 Composer 依赖与扫描缓存预热。
  3. 入口脚本指向 bin/hyperf.php start。
  4. 运行期通过环境变量与配置中心注入环境差异。

代码或图示

镜像内容:PHP CLI + 扩展 + vendor + 代码 + 入口脚本
运行注入:环境变量、配置中心、证书/密钥挂载、日志目录
不烘焙:数据库地址、账号密码、各环境开关

常见误区

  • 把生产 .env 打进镜像:镜像不可复用到其他环境,且密钥泄露。
  • 镜像内运行时 composer install:启动变慢且依赖不可复现,依赖应在构建层装好。

追问

  • 扩展如何进入镜像?答:通过镜像构建步骤安装对应 PHP 扩展;扩展版本与框架约束对齐,具体扩展清单以项目 composer.json 与 Dockerfile 为准。
  • 扫描缓存要不要进镜像?答:可在构建阶段预热代理与扫描缓存;运行期代码变更以新版本镜像替换,不在容器内手工改缓存。

06.5.5.14-002 启动脚本如何组织?进程由谁拉起?

一句话结论

容器入口执行框架启动命令拉起常驻 Server,进程管理由容器运行时与扩展管理器共同承担;脚本只负责环境检查、配置校验与启动命令,不在脚本中残留本机路径,路径基于项目基础定位。

概念解释

部署形态通常是“容器进程 = 主服务进程”,不要用脚本后台 fork 多份服务。启动前可做配置与扩展检查,启动后前台运行以接收容器信号。自定义 Process、消费者随主服务启动一并拉起。

原理流程

  1. 入口脚本检查 PHP 版本、扩展与关键配置。
  2. 前台执行 php bin/hyperf.php start 启动 Server。
  3. 容器运行时负责进程存活监控与重启策略。
  4. 停止时向主进程发送停止信号,触发优雅退出流程。

代码或图示

// 启动命令示意;实际参数以骨架与部署约定为准
// php bin/hyperf.php start
// 容器入口保持前台运行,信号直接转发给主进程

常见误区

  • 脚本用 nohup ... & 后台启动:容器认为主进程已退出,信号与生命周期管理失效。
  • 启动脚本写死绝对路径:换构建目录或部署机后脚本失效,应基于脚本自身位置定位。

追问

  • 配置检查在脚本还是代码里做?答:启动期配置校验可在框架引导与监听器中完成;脚本只做基础环境检查,避免两套校验逻辑漂移。
  • 多组件(HTTP + 消费者)同容器启动吗?答:可同进程挂载多 Server 与 Process;职责重或需独立扩缩时拆分为独立部署单元。

06.5.5.14-003 Worker 数量如何确定?与 CPU 核数是什么关系?

一句话结论

Worker 数结合 CPU 核数、任务类型与内存评估:CPU 密集型接近核数配置,IO 密集型协程服务可高于核数,但受内存、连接池与下游承载约束;最终数值按压测与线上水位调整,不照搬固定公式。

概念解释

协程模型下单 Worker 内并发挂起大量 IO 请求,Worker 数不等于并发请求数。每个 Worker 常驻一份代码与单例内存,数量翻倍内存近似翻倍;IO 等待多的服务Worker 数不必等于核数,CPU 占用高的服务多开 Worker 收益有限。

原理流程

  1. 评估任务类型:IO 密集还是 CPU 密集。
  2. 估算单 Worker 内存占用与容器内存配额。
  3. 设定初始 Worker 数,压测观测 CPU、内存与响应延迟。
  4. 按下游承载与水位调整,保留余量应对峰值。

代码或图示

// server.php 中 Worker 配置为示意;键名以框架默认配置为准(待确认)
return [
    'settings' => [
        'worker_num' => 4,
    ],
];

常见误区

  • Worker 数设成 CPU 核数的几倍跑 CPU 密集任务:上下文切换开销抵消并发收益。
  • 只按 CPU 调 Worker:内存与下游连接池额度先到上限,表现为 OOM 或池耗尽。

追问

  • Worker 数能动态调整吗?答:进程配置在启动期定型,扩容通常靠滚动重启或调整部署副本数;运行期热调 worker_num 的能力以扩展实现为准(待确认)。
  • 单 Worker 内协程并发上限受什么约束?答:协程栈内存、下游连接数与单协程耗时;协程数并非越多越好,按压测结果控制。

06.5.5.14-004 Task Worker 与自定义进程在部署时如何规划?

一句话结论

Task Worker 承接扩展异步任务,自定义 Process 承载常驻守护与消费职责;部署时按职责规划数量与资源隔离,重任务独立部署单元,避免与请求 Worker 争抢 CPU 与内存。

概念解释

请求 Worker 对延迟敏感,后台任务对吞吐敏感,混部会互相影响。规划时区分:轻量异步投递走 Task Worker,长驻消费与守护走独立 Process 或独立服务;消费者数量与队列深度、下游承载匹配。

原理流程

  1. 梳理后台职责:异步任务、队列消费、守护循环。
  2. 轻量任务挂主服务 Task Worker;长任务独立 Process。
  3. 按任务量配置进程数量与协程开关。
  4. 观测各进程 CPU、内存与任务积压,独立扩缩。

代码或图示

请求 Worker      → 接口延迟优先,资源隔离
Task Worker      → 短时异步任务
独立 Process/服务 → 队列消费、长驻守护、批量处理

常见误区

  • 所有后台逻辑塞进请求 Worker:阻塞协程拖慢接口响应。
  • 消费者与接口同副本数部署:队列积压时无法独立扩容消费者。

追问

  • 自定义进程数量在哪里配?答:进程注解或进程配置的 nums 字段;部署副本与进程数相乘是实际进程总数,需一并核算。
  • 进程崩溃影响请求吗?答:独立进程内存隔离,崩溃不直接影响请求 Worker;共享外部资源(DB、Redis)故障时仍会相互影响。

06.5.5.14-005 优雅重启如何实现?在处理中的请求会被中断吗?

一句话结论

优雅重启先停止接收新连接,等待在处理请求与任务完成后再退出进程;正在执行的协程处理完当前批次后退出,新流量交给新进程;进程内未完成的长任务需要自行保存断点,不能依赖旧进程残留。

概念解释

滚动发布期间新旧进程并存:旧进程进入退出流程,不再接新请求,处理完存量请求后释放资源。框架/扩展提供停止回调与信号处理,具体等待时长、强制退出超时以扩展与部署配置为准;任务类协程要配合退出标记收尾。

原理流程

  1. 部署触发停止信号,旧进程标记不再接收新连接。
  2. 在途请求与消息处理完成,退出回调清理资源。
  3. 超过宽限时间仍未结束的进程被强制回收。
  4. 新进程就绪并通过健康检查后开始接流量。

代码或图示

收到停止信号
  → 停止接收新连接
  → 等待在途请求/消息处理完成
  → 执行退出回调、释放资源
  → 宽限超时仍未退出 → 强制回收

常见误区

  • 发布直接强杀进程:在途请求中断,消息可能未确认导致重投。
  • 退出回调里启动新的阻塞任务:进程迟迟不退出,超过宽限被强杀。

追问

  • 优雅等待时长在哪里配?答:容器终止宽限时间与扩展退出等待参数;两侧超时需协调,具体键名以部署环境与框架配置为准(待确认)。
  • 长批次任务如何配合重启?答:循环内检查退出标记,保存断点退出;重启后从断点继续,不假设旧进程内存状态保留。

06.5.5.14-006 滚动发布的流程与前置条件是什么?

一句话结论

滚动发布逐副本替换旧版本:新副本启动并通过健康检查后再接流量,旧副本优雅退出;前置条件是服务无状态化、配置可注入、健康检查可用、版本回退路径明确。

概念解释

滚动发布依赖负载均衡摘除与恢复机制:旧副本先摘流量再退出,新副本先就绪再上流量。有状态本地缓存、本地会话会导致摘接流量后数据不一致;任务型服务还要处理重启期间的消息与任务归属。

原理流程

  1. 构建新版本镜像与配置,准备回退版本。
  2. 启动新副本,等待启动完成与健康检查通过。
  3. 负载均衡将流量逐步切到新副本,旧副本摘流优雅退出。
  4. 分批完成全量替换,异常时回退到旧版本。

代码或图示

新版本镜像 → 起新副本 → 健康检查通过 → 接入流量
旧副本摘流 → 在途处理完 → 优雅退出
异常 → 停止滚动 → 回退旧版本副本

常见误区

  • 新副本未通过健康检查就接流量:启动未完成时请求报错率上升。
  • 发布不同时回退配置:代码新版本依赖新配置,旧副本保留旧配置要兼容。

追问

  • 服务有状态怎么改造?答:会话与缓存外置到 Redis,任务状态落库;本地只保留可重建的缓存。
  • 消费者滚动重启会丢消息吗?答:未确认消息重投,配合幂等处理;重启期间队列堆积由其他副本继续消费。

06.5.5.14-007 健康检查与就绪探针有什么区别?如何实现?

一句话结论

存活探针判断进程是否需要重启,就绪探针判断实例能否接流量;Hyperf 侧可提供 HTTP 健康接口检查基础依赖,就绪状态包含启动完成与依赖可用,存活检查关注进程是否僵死。

概念解释

启动未完成、依赖暂时不可达时实例应“未就绪”而非“判死重启”。探针接口要轻量化,不做重查询;就绪失败时摘流量,存活失败时重建实例。探针路径与阈值由部署平台配置,框架侧只提供检查端点。

原理流程

  1. 定义健康检查路由,返回进程状态与关键依赖连通性。
  2. 就绪探针调用该端点,未通过则不接流量。
  3. 存活探针定期检查,失败由平台重启实例。
  4. 启动预热完成前就绪端点返回未就绪。

代码或图示

// 健康接口示意;实现按项目路由与中间件约定编写
#[Controller(prefix: 'health')]
class HealthController
{
    #[GetMapping('check')]
    public function check(): array
    {
        return ['status' => 'ok'];
    }
}

常见误区

  • 就绪探针依赖过重接口:检查本身拖垮实例,或误判不可用。
  • 启动阶段就被存活探针反复重启:启动慢于探针超时阈值,需调大启动宽限或分离启动检查。

追问

  • 探针要检查 DB/Redis 吗?答:就绪检查可包含轻量连通性探测;依赖故障时摘流量比直接重启更合理,按平台能力区分两类探针。
  • 健康接口如何防外部访问?答:只在集群内网暴露,不经过公网网关;必要时加来源限制。

06.5.5.14-008 配置中心在部署中如何接入?本地兜底如何设计?

一句话结论

配置中心托管动态配置与多环境差异,实例启动时拉取并监听推送;本地配置与环境变量作为兜底,中心不可达时仍能启动,可刷新配置项与需重启项分开管理。

概念解释

部署链路中配置来源优先级在配置条目已述;治理上关注变更可追踪、回退可操作。敏感配置在中心受控存储,不下发明文到仓库。配置推送有延迟,各实例短时间配置不一致要被业务容忍。

原理流程

  1. 本地配置提供结构与默认兜底值。
  2. 启动连接配置中心拉取远端覆盖项。
  3. 运行期接收推送,刷新支持动态更新的键。
  4. 中心故障时沿用本地/缓存配置并告警。

代码或图示

本地默认 → 环境变量 → 配置中心远端值
动态刷新:开关、阈值、限流参数
需重启生效:连接参数、组件注册、路由结构

常见误区

  • 中心不可达时实例启动失败:缺少本地兜底配置。
  • 把启动期结构类配置指望动态推送:不重启不生效,发布流程要包含重启。

追问

  • 配置变更如何灰度?答:按实例分组或版本分批推送,观察指标后全量;配置中心是否支持灰度分组以所选产品为准。
  • 配置回退怎么做?答:中心保留历史版本,回退到上一版本;需重启的配置回退配合滚动发布。

06.5.5.14-009 灰度发布如何在应用层配合实现?

一句话结论

灰度靠流量分层(版本标签、用户分组、请求头)在网关或路由层分流,应用层按标识返回对应版本行为;多版本实例并存时配置与依赖兼容,灰度指标通过日志与监控对比观察。

概念解释

应用层配合点:识别灰度标识、按标识选择分支或配置、记录版本与灰度分组到日志。灰度不等于代码内到处写 if;差异能力通过配置/特性开关控制,流量规则放在网关层,应用保持可回退。

原理流程

  1. 网关按规则把灰度流量打到标记新版本的实例。
  2. 应用读取灰度标识与特性开关,执行对应分支。
  3. 日志记录版本、分组与关键指标。
  4. 对比灰度与基准组指标,达标后全量或回退。

代码或图示

网关按标签/用户群/请求头分流
  → 灰度实例读取标识与开关
  → 执行新版本分支
  → 日志记录版本与分组
  → 指标对比 → 全量 / 回退

常见误区

  • 灰度规则写死在应用代码:换流量策略要改代码重新发布。
  • 多版本共用数据库结构不兼容:旧版本读不到新字段、新版本写旧结构需兼容设计。

追问

  • 特性开关与灰度关系?答:开关控制能力可见性,灰度控制流量分布;两者配合,开关可独立于版本快速关闭。
  • 灰度期间消息/任务如何归属?答:异步链路按消息标识路由到对应版本,或保证消息消费者版本兼容,避免灰度消息落到旧版本处理。

06.5.5.14-010 限流在 Hyperf 中如何接入?

一句话结论

限流组件通过注解或配置对接口/方法设置阈值与时间窗口,超出阈值返回限流响应;框架层提供限流器封装,具体注解名、存储后端(Redis 计数等)与算法以安装组件源码为准。

概念解释

限流保护自身不被流量打垮,分级维度包括 IP、用户、接口或全局限流。计数通常借助 Redis 等共享存储在多实例间汇总;单机限流只保护单副本。限流响应要统一报文,便于客户端退避重试。

原理流程

  1. 选定限流维度与阈值,按压测容量设定。
  2. 接入限流组件注解或中间件,配置时间窗口。
  3. 请求到达时计数判定,超限返回限流状态。
  4. 监控限流命中数,结合容量调整阈值。

代码或图示

// 限流注解为示意;注解名、属性与存储后端以组件为准(待确认)
#[RateLimit(limit: 100, period: 60)]
public function submit(): array
{
    // 业务逻辑
}

常见误区

  • 单机限流用于多实例部署:各副本独立计数,总阈值是副本数倍。
  • 阈值按峰值拍脑袋:没有压测与容量依据,要么误限要么被打垮。

追问

  • 限流算法有哪些?答:计数器、滑动窗口、令牌桶、漏桶;组件实现哪种算法以源码为准,选型按突发流量特征决定。
  • 被限流后客户端怎么办?答:响应携带重试提示,客户端按退避策略重试;不要在服务端无限排队等待。

06.5.5.14-011 熔断与降级如何保护下游故障?

一句话结论

当下游错误率或超时达到阈值,熔断暂时停止调用快速失败,避免故障扩散;降级返回兜底数据或延后处理,恢复后半开探测逐步放开;框架是否提供内置熔断器取决于安装组件,自研实现要明确状态机与统计窗口。

概念解释

限流保护入口流量,熔断保护依赖调用:下游变慢时同步等待会占满协程与连接池。熔断状态(关闭、打开、半开)按错误统计切换;降级策略包括缓存兜底、默认值、异步补偿,不能对核心数据伪造结果。

原理流程

  1. 统计下游调用成功率与延迟。
  2. 阈值触发熔断:一段时间内直接快速失败。
  3. 降级返回兜底或投递异步补偿任务。
  4. 半开状态放行少量探测,成功则恢复关闭。

代码或图示

正常调用 → 错误/超时累积 → 熔断打开(快速失败 + 降级)
  → 等待恢复时间 → 半开探测 → 成功关闭 / 失败继续打开

常见误区

  • 下游故障时盲目重试:重试叠加放大故障,熔断与退避要配合。
  • 降级直接返回伪造成功数据:核心交易场景会造成业务错误,降级需明确可接受范围。

追问

  • Hyperf 内置熔断器吗?答:需核对项目安装的 hyperf/* 组件;未内置时可在调用层封装状态机,不假设框架默认提供(待确认)。
  • 熔断阈值怎么定?答:基于下游正常错误率、超时分布与自身容量,结合压测与线上观测调整,避免轻微波动即熔断。

06.5.5.14-012 集群部署下如何做到无状态?

一句话结论

实例不保存会话、本地缓存与待处理状态,可变状态外置到 Redis、数据库或对象存储;多副本可任意摘除与扩缩,请求可落到任意实例,任务状态由外部存储记录归属。

概念解释

有状态实例绑定后无法自由扩缩与滚动重启。本地可重建的缓存允许保留,但失效后要能从外部源恢复;登录态、购物车、分布式锁、任务游标都应外置。实例身份只用于日志与分区,不作为状态依赖。

原理流程

  1. 梳理实例内可变状态:会话、缓存、队列、标记位。
  2. 可外置的迁移到 Redis/DB/存储服务。
  3. 本地缓存设计为可重建,设置 TTL 与容量上限。
  4. 任务归属与游标落外部存储,支持副本变化后继续。

代码或图示

外置:会话、令牌、分布式锁、任务进度、共享缓存
本地:可重建的只读缓存、不可变配置
禁止:本地数组累积请求/任务状态

常见误区

  • 用本地文件上传临时存储:副本切换后文件不可见,应走对象存储。
  • 本地锁做集群互斥:多副本各自加锁,互斥失效。

追问

  • 多副本共享本地缓存怎么办?答:缓存统一到 Redis 或接受各副本缓存短暂不一致并设计失效策略。
  • 定时任务集群互斥?答:借助外部锁选主,保证同一时刻单实例执行(见定时任务章节)。

06.5.5.14-013 队列消费者如何水平扩容?

一句话结论

消费者按副本水平增加实例提升消费能力,队列与分区支持多实例竞争消费;扩容受下游承载、连接数与消息分区限制,扩缩容时观察队列深度与消费速率,避免分区倾斜。

概念解释

多实例竞争同一队列时消息自动分发,增加副本提高并发;按键分区的队列要保证分区可被多实例接管。消费者扩容前先确认下游 DB/接口能承受增长的并发,否则扩容只会把瓶颈转移到下游。

原理流程

  1. 监控队列深度、消费速率与积压趋势。
  2. 评估下游承载与连接池额度,确定可扩上限。
  3. 增加消费者副本或进程数,观察消费速率。
  4. 分区场景检查各分区消费均衡,热点分区单独处理。

代码或图示

队列积压上升
  → 下游容量确认有余量
  → 增加消费者副本/进程
  → 观察深度下降与错误率
  → 倾斜分区 → 调整分区键或单独扩容

常见误区

  • 消费者无限扩容:连接数与下游被打满,失败率上升。
  • 顺序消费场景盲目加并发:同键消息被多实例抢占,顺序被打破。

追问

  • 消费者副本数与进程数关系?答:副本数 × 每副本进程/协程数 = 总消费并发,核算时两个维度都要看。
  • 扩容后消息重复吗?答:至少一次投递语义不变,消费端幂等保证重复执行无副作用。

06.5.5.14-014 上线后需要采集哪些监控指标?

一句话结论

核心指标包括请求量、延迟分布、错误率、协程/进程数、内存与 CPU、连接池水位、队列深度与消费速率、下游调用耗时与错误;指标按接口与服务聚合,异常阈值触发告警。

概念解释

监控分三层:业务指标(QPS、成功率)、运行指标(进程、协程、内存、连接池)、依赖指标(DB、Redis、MQ、下游接口)。缺少运行指标时,内存增长或池耗尽只能靠用户反馈发现;指标采集方式按项目可观测组件接入。

原理流程

  1. 请求层采集 QPS、状态码、延迟 P50/P99。
  2. 运行层采集进程存活、协程数、内存、CPU、连接池等待。
  3. 依赖层采集下游耗时、错误率、队列深度与积压。
  4. 配置阈值与告警,按业务重要性分级。

代码或图示

业务:QPS、成功率、P99 延迟
运行:进程/协程数、内存、CPU、池水位
依赖:DB/Redis/MQ/下游 耗时与错误率、队列积压

常见误区

  • 只监控接口成功率:内存泄漏、池耗尽在报错前已有运行指标征兆。
  • 告警没有分级:全部临界告警导致告警疲劳,关键故障被淹没。

追问

  • 指标从哪里暴露?答:框架/组件提供的采集钩子或自定义中间件埋点;输出到监控系统的方式按项目部署环境接入。
  • 协程数怎么看?答:运行时计数或扩展提供的状态信息;具体可获取的指标以扩展与组件为准(待确认)。

06.5.5.14-015 日志与追踪在部署环境如何归集?

一句话结论

容器内日志输出到标准输出或约定目录,由采集代理收集到日志检索系统;trace_id 贯穿应用、队列与下游调用,部署环境保证各副本日志带上实例标识,便于跨实例串联排查。

概念解释

容器实例易销毁,本地文件不持久;日志归集依赖平台采集。链路追踪通过标识透传:HTTP 头、消息头、任务参数携带 trace_id,各阶段日志与指标按标识关联。实例版本、副本编号写入日志公共字段。

原理流程

  1. 应用日志输出到 stdout 或挂载日志目录。
  2. 采集代理按节点收集,结构化解析入库。
  3. trace_id 在请求入口生成,跨异步与下游透传。
  4. 日志字段包含版本、实例、通道与业务标识。

代码或图示

应用日志 → stdout/目录 → 采集代理 → 日志检索系统
trace_id:HTTP 头 → 应用上下文 → MQ 消息头 → 消费者日志

常见误区

  • 依赖容器内本地文件排障:实例销毁后文件丢失。
  • 异步链路不带 trace_id:后台日志无法关联原始请求。

追问

  • 日志目录挂载怎么处理?答:需要持久化的本地日志挂载卷;多数场景走 stdout 由代理采集更简单。
  • 追踪跨度如何对接?答:应用层透传标识即可接入平台追踪系统;完整跨度埋点按所选追踪组件规范接入。

06.5.5.14-016 资源配额如何估算:内存、协程数、连接数?

一句话结论

内存按单 Worker 常驻对象 + 单协程栈 + 在途请求数据量估算,连接数按下游池上限与副本数乘积控制;配额留出峰值余量,不把平均水位当上限,容量按压测结果校正。

概念解释

每个 Worker 常驻一份框架与单例内存;每个在途协程占用栈与请求数据;下游连接池额度乘副本数不能超过数据库/中间件上限。估算要区分常驻基线与峰值增量,峰值场景还要考虑大结果集与缓冲。

原理流程

  1. 测量单 Worker 基线内存与单协程平均占用。
  2. 估算峰值在途协程数与数据体积,得出峰值内存。
  3. 核算各下游连接池配置 × 副本数的总连接数。
  4. 对照容器配额与下游上限,调整 Worker、协程与池参数。

代码或图示

内存 = Worker 基线 × Worker 数 + 协程栈 × 峰值协程数 + 请求数据峰值
连接 = 单实例池配置 × 副本数 ≤ 下游最大连接数
配额余量按峰值 + 缓冲预留

常见误区

  • 按平均请求大小估算内存:突发大报文或批量任务会突破配额。
  • 池配置只看单实例:多副本总连接数压垮数据库。

追问

  • 协程栈默认大小可调吗?答:扩展提供协程栈配置;框架层默认值与可调参数以扩展文档为准(待确认)。
  • 连接池等待超时怎么设?答:小于下游可接受等待与请求超时,避免请求长时间挂在池获取阶段。

06.5.5.14-017 发布回滚与配置变更回退如何准备?

一句话结论

代码版本可回退到上一镜像,配置保留历史版本可一键回退;数据库变更遵循向后兼容,回滚不依赖不可逆结构改动;发布前准备回退步骤、观测指标与停止条件。

概念解释

回滚能力覆盖三层:应用镜像、配置项、数据库结构。回滚代码时旧版本要能读新数据库结构,因此 schema 变更采用扩展-迁移-清理两步法。配置回退与代码回滚版本要匹配,避免新代码配旧配置。

原理流程

  1. 发布前确认上一版本镜像与配置版本可用。
  2. 数据库变更设计兼容旧版本的过渡结构。
  3. 发布分批观察指标,异常按预案回退镜像/配置。
  4. 回退后核对数据与任务状态,必要时补偿。

代码或图示

镜像回退:保留上一版本制品
配置回退:历史版本可恢复
数据库:先加字段/表,双写迁移,确认后再删旧结构

常见误区

  • 回滚代码但数据库已删旧字段:旧版本启动即报错。
  • 配置变更无历史记录:回退时凭手改,容易错配。

追问

  • 消息格式不兼容怎么回滚?答:消费者与生产者版本兼容期内保留旧格式解析;不兼容变更通过灰度与双格式过渡。
  • 回滚后积压任务怎么办?答:核对队列与补偿表,确认旧版本能继续处理剩余消息。

06.5.5.14-018 多环境配置如何分层管理?

一句话结论

代码仓库保留结构与默认值,环境差异由环境变量与配置中心按 dev/test/prod 注入;各环境使用独立资源(库、Redis、MQ),配置清单随发布核对,禁止跨环境复用密钥与数据。

概念解释

分层目标是同一套代码在不同环境只换配置不换分支。环境差异包括连接地址、开关阈值、日志级别、下游地址;测试与生产资源隔离,避免测试流量污染生产数据。配置变更走受控发布,不手工登录实例改配置。

原理流程

  1. 配置文件定义结构、键路径与安全默认值。
  2. 环境变量按环境注入连接与开关。
  3. 配置中心承载共享动态配置并按环境分组。
  4. 发布前核对目标环境配置清单与版本。

代码或图示

代码仓库:配置结构、默认值、通道名
环境变量:各环境连接地址、账号、开关
配置中心:动态参数、阈值、特性开关
独立资源:dev/test/prod 各自库、缓存、队列

常见误区

  • 为不同环境复制配置文件改值:配置漂移,升级漏合并。
  • 测试环境直连生产下游:压测与脏数据影响生产。

追问

  • 环境标识在哪里读取?答:通过环境变量传入应用,日志与监控按环境区分;不硬编码环境名在业务代码里。
  • 新增配置项如何同步各环境?答:发布清单列出新增变量与默认值,部署前在各环境补齐,避免启动缺省。

06.5.5.14-019 容器化部署有哪些注意事项?

一句话结论

关注时区与字符集、日志输出、信号转发、临时目录与文件权限、健康检查端口;容器内以前台主进程运行,不依赖 systemd 等宿主进程管理,本地路径改为基于项目基础路径。

概念解释

容器环境与传统虚拟机不同:进程生命周期由容器运行时接管,时区可能默认 UTC,日志不落本地持久盘,临时目录可清空。框架内路径拼接基于基础目录,不写宿主绝对路径;文件上传等本地存储外置到对象存储。

原理流程

  1. 基础镜像设置时区、字符集与所需扩展。
  2. 主进程前台运行,信号正常转发到应用。
  3. 日志走 stdout 或挂载目录,临时文件使用约定目录。
  4. 健康检查端口与端口映射在平台配置。

代码或图示

容器注意:时区、字符集、扩展版本
进程:前台主进程、信号转发
日志:stdout/挂载卷
文件:外置对象存储,不依赖容器本地磁盘

常见误区

  • 容器内依赖本地持久文件:重建实例后文件丢失。
  • 时区用默认 UTC:定时任务按错误时间触发,日志时间难以对齐。

追问

  • 容器内如何查看进程状态?答:通过健康接口与监控指标;不进入容器手工排查作为常规手段,日志与指标优先。
  • 端口冲突怎么处理?答:各 Server 端口在配置中区分,平台映射规则不重复;多副本不共享宿主端口。

06.5.5.14-020 上线前治理检查清单是什么?

一句话结论

上线前核对:配置与密钥注入正确、健康检查可用、优雅退出与回退预案齐备、监控告警已接入、限流熔断阈值明确、资源配额有余量、日志与追踪可归集、依赖容量评估完成。

概念解释

治理检查覆盖发布、运行、故障三个阶段:发布能回退,运行有观测与保护,故障能定位与恢复。清单按环境逐项确认,避免功能开发完成但运维配套缺失;组件能力不确定项先核对源码与文档再上线。

原理流程

  1. 配置核对:环境变量、配置中心、密钥、资源连接。
  2. 发布准备:镜像、回退版本、滚动策略、探针配置。
  3. 运行保护:监控指标、告警阈值、限流熔断、配额余量。
  4. 排障准备:日志归集、trace 透传、值班与补偿流程。

代码或图示

配置/密钥 → 健康检查 → 优雅退出 → 回退预案
监控告警 → 限流熔断 → 资源配额
日志归集 → 链路追踪 → 补偿流程

常见误区

  • 功能联调通过就上线:监控、告警与回退未准备,出问题只能人工救火。
  • 阈值按开发环境经验设置:生产流量与下游承载力不同,需按压测调整。

追问

  • 上线后第一个观察周期看什么?答:错误率、P99 延迟、内存曲线、队列积压与下游错误;对比灰度/基准指标。
  • 组件能力不确定怎么办?答:标注「待确认」,核对 vendor/hyperf/* 相关组件源码、官方文档版本章节与部署环境实际配置,验证后再固化到上线清单。