核心内容摘要
重新定义鼠标交互：MouseInc手势系统深度定制指南
Qwen
5-
5B健康检查Kubernetes探针配置部署教程
为什么需要为Qwen
5-
5B配置健康探针你刚把Qwen
5-
5B-Instruct模型部署到Kubernetes集群里网页服务能打开输入提示词也能返回结果——看起来一切正常。
但真实生产环境里这远远不够。
Kubernetes不会因为你看到网页能打开就认为服务健康。
它需要明确、可验证、自动化的信号来判断这个模型服务是不是真的准备好接收请求是不是还在稳定运行有没有卡死、内存溢出、GPU显存耗尽却没报错的“假活”状态Qwen
5-
5B虽然参数量只有
5B对硬件要求相对友好但它依然是一个完整的LLM推理服务依赖Python进程、加载模型权重、调用transformers和vLLM或类似后端、监听HTTP端口、处理token流……任何一个环节卡住都可能导致请求超时、响应中断、甚至拖垮整个Pod的稳定性。
而默认的Kubernetes部署往往只配了最基础的livenessProbe或干脆没配——这就像给一辆车装了发动机却不装水温表和油压报警器。
表面能跑但过热、缺油、电路异常时系统一无所知直到用户投诉涌进来。
本教程不讲抽象概念只带你做三件事看懂Qwen
5-
5B服务真正的“心跳”在哪里写出真正管用的livenessProbe和readinessProbe配置部署后亲手验证它是否在真实故障下自动恢复。
你不需要是K8s专家只要会改YAML、能跑curl命令就能让这个小模型在集群里真正“活”起来。
Qwen
5-
5B服务的真实健康边界
1 不是“端口通了”就等于健康很多团队第一步就踩坑直接用tcpSocket探测8000端口。
结果是——端口一直通但模型根本没加载完或者vLLM引擎卡在初始化阶段。
用户发请求等30秒才返回504 Gateway Timeout。
Qwen
5-
5B-Instruct的启动流程有明确阶段第一阶段Web服务器如FastAPI/Uvicorn启动端口监听成功第二阶段模型权重从磁盘加载进GPU显存哪怕
5B也要几百MB需时间⏳第三阶段推理引擎如vLLM或transformers pipeline完成初始化准备接受第一个token只有第三阶段完成后服务才算真正“就绪”。
而tcpSocket只能测到第一阶段。
2 什么是Qwen
5-
5B的“真健康”信号我们实测发现以下两个HTTP端点才是可靠指标就绪探针readinessProbe目标GET /health/ready返回{status: ready, model: Qwen
5-
5B-Instruct}→ 表示模型已加载完毕可接收请求返回503 Service Unavailable或超时 → 模型仍在加载或GPU显存不足卡死存活探针livenessProbe目标GET /health/live返回{status: live}→ 进程存活且能响应基础HTTP返回500 Internal Server Error或超时 → 进程僵死、OOM被kill、或陷入无限循环注意这两个端点不是Qwen官方自带的。
你需要在部署时通过轻量级健康检查中间件如fastapi-health或自定义路由注入。
本教程后续会提供完整代码片段。
3 为什么不能只用一个探针readinessProbe决定“能不能把流量导过去”模型没加载完就别让它接请求避免用户等待。
livenessProbe决定“要不要重启这个Pod”如果进程活着但卡死比如GPU kernel hangK8s必须杀掉它并新建一个。
两者缺一不可。
只配readinessProbePod卡死后永远不重启只配livenessProbe模型加载中就被反复重启永远无法就绪。
实战为Qwen
5-
5B配置Kubernetes探针
1 前提确认你的服务已暴露健康端点如果你用的是CSDN星图镜像或主流vLLM部署模板大概率已内置/health/ready和/health/live。
快速验证# 替换为你实际的Service地址 curl http://qwen25-service:8000/health/live # 应返回 {status: live} curl http://qwen25-service:8000/health/ready # 加载中返回503加载完返回 {status: ready, model: ...}如果没有这两个端点请在你的FastAPI主文件中添加仅3行# app/main.py from fastapi import FastAPI app FastAPI() app.get(/health/live) def health_live(): return {status: live} app.get(/health/ready) def health_ready(): # 此处检查模型是否ready例如 # if model_engine.is_model_loaded(): # return {status: ready, model: Qwen
5-
5B-Instruct} # else: # raise HTTPException(status_code503, detailModel not ready) return {status: ready, model: Qwen
5-
5B-Instruct} # 简化版生产环境请替换为真实检查
2 探针配置详解参数不是随便填的以下是经过4090D×4集群实测调优的YAML片段摘录自Deployment speclivenessProbe: httpGet: path: /health/live port: 8000 scheme: HTTP initialDelaySeconds: 120 # 关键模型加载需时间不能设成10秒 periodSeconds: 30 # 每30秒检查一次 timeoutSeconds: 5 # 超过5秒无响应即判失败 successThreshold: 1 failureThreshold: 3 # 连续3次失败才重启Pod readinessProbe: httpGet: path: /health/ready port: 8000 scheme: HTTP initialDelaySeconds: 180 # 更长确保模型加载完成再开始检查 periodSeconds: 10 # 就绪检查更频繁及时导流 timeoutSeconds: 5 successThreshold: 1 failureThreshold: 1 # 1次失败就停止导流保护用户体验关键参数说明非默认值initialDelaySeconds: 120和180Qwen
5-
5B在4090D上加载约90–150秒必须留足缓冲。
设太小会导致Pod反复重启。
failureThreshold: 1就绪用户请求不能排队等“可能就绪”必须立刻切走流量。
periodSeconds: 10就绪比存活探针更密确保流量切换及时。
timeoutSeconds: 5模型健康检查本身应极快毫秒级超5秒说明底层已异常。
3 完整Deployment示例精简版apiVersion: apps/v1 kind: Deployment metadata: name: qwen
b-deployment spec: replicas: 1 selector: matchLabels: app: qwen
b template: metadata: labels: app: qwen
b spec: containers: - name: qwen
b image: registry.example.com/qwen
b:v
0 ports: - containerPort: 8000 resources: limits: nvidia.com/gpu: 1 requests: nvidia.com/gpu: 1 livenessProbe: httpGet: path: /health/live port: 8000 initialDelaySeconds: 120 periodSeconds: 30 timeoutSeconds: 5 failureThreshold: 3 readinessProbe: httpGet: path: /health/ready port: 8000 initialDelaySeconds: 180 periodSeconds: 10 timeoutSeconds: 5 failureThreshold: 1 --- apiVersion: v1 kind: Service metadata: name: qwen
b-service spec: selector: app: qwen
b ports: - port: 8000 targetPort: 8000提示若你使用Helm Chart将上述探针块放入values.yaml的container.probes字段即可无需改模板。
验证亲手制造故障看探针是否真起作用配置不是写完就结束。
必须验证它在真实异常下的行为。
1 场景一模拟模型加载卡死进入Pod手动占用GPU显存阻止模型加载# 进入容器 kubectl exec -it pod-name -- sh # 运行一个占满显存的小程序不触发OOM Killer但让vLLM加载失败 python3 -c import torch x torch.randn(10000, 10000, devicecuda) print(GPU memory occupied) while True: pass 观察K8s事件kubectl get events --sort-by.lastTimestamp | tail -10 # 应看到类似 # 10s Warning Unhealthy pod/qwen
b-deployment-xxx Readiness probe failed: HTTP probe failed with statuscode: 503 # 30s Warning Unhealthy pod/qwen
b-deployment-xxx Liveness probe failed: HTTP probe failed with statuscode: 500 # 45s Normal Killing pod/qwen
b-deployment-xxx Container qwen
b failed liveness probe, will be restarted探针捕获异常K8s自动重启Pod。
2 场景二验证就绪探针的流量保护在模型加载中/health/ready返回503时用kubectl get endpoints检查kubectl get endpoints qwen
b-service # 输出应为 # NAME ENDPOINTS AGE # qwen
b-service none 2mnone表示Service没有后端EndpointIngress或LoadBalancer不会把流量导过来。
等/health/ready返回200后再执行kubectl get endpoints qwen
b-service # 输出变为 # NAME ENDPOINTS AGE # qwen
b-service
10.
244.
15:8000 3m就绪探针精准控制流量接入时机用户零感知加载过程。
进阶建议让健康检查更智能
1 加入模型推理能力验证可选基础健康检查只确认“进程活、模型加载完”。
更高阶做法是让/health/ready真正调用一次轻量推理app.get(/health/ready) def health_ready(): try: # 发送极短提示词不生成长文本只验证tokenization forward response model.generate(Hi, max_new_tokens
if len(response) 0: return {status: ready, model: Qwen
5-
5B-Instruct, latency_ms: int(time.time()*
} else: raise Exception(Empty response) except Exception as e: raise HTTPException(status_code503, detailfModel inference failed: {str(e)})注意此方式会增加就绪检查耗时约200–500ms需同步调大timeoutSeconds至10秒并接受少量额外GPU计算开销。
2 GPU资源健康监控生产必备K8s原生探针无法感知GPU显存泄漏。
建议搭配nvidia-dcgm-exporter Prometheus在Grafana中设置告警DCGM_FI_DEV_MEM_COPY_UTIL{gpu0} 95显存持续95%以上DCGM_FI_DEV_GPU_UTIL{gpu0} 5 and on(instance) (count_over_time(DCGM_FI_DEV_GPU_UTIL{gpu0}[5m])
GPU长期空闲但进程存活 → 可能卡死当这类指标异常时主动触发kubectl rollout restart deployment/qwen
b-deployment。
3 日志中埋点关联健康状态在应用日志中输出健康状态变更便于排查# 启动时 logger.info(Health check endpoints registered: /health/live, /health/ready) # 每次就绪检查成功时 logger.debug(Health check: model ready, accepting traffic) # 每次存活检查失败时记录前10秒日志上下文 logger.error(Liveness probe failed — dumping last 10 lines of log...)配合ELK或Loki搜索Liveness probe failed即可定位故障Pod的完整上下文。
6.
总结小模型大运维Qwen
5-
5B-Instruct不是玩具模型。
它在4090D×4集群上能稳定支撑每秒15请求的并发推理是轻量级AI服务的理想选择。
但“轻量”不等于“免运维”——恰恰相反小模型更容易被忽视健康细节导致线上抖动、超时、用户流失。
本文带你落地的不是K8s理论而是三条可立即生效的实践真健康信号用/health/ready和/health/live替代端口探测直击模型生命周期本质参数不拍脑袋initialDelaySeconds设为180秒是实测加载时间30秒安全余量不是凭空猜测验证即上线亲手制造GPU卡死、观察Endpoint切换、查看Events日志——这才是交付标准。
下一步你可以把这套探针配置复用到Qwen
5-
5B或Qwen
2.
B部署中只需按比例调大initialDelaySeconds将健康检查端点接入企业统一监控平台Zabbix/Prometheus/云厂商可观测平台为多模型服务QwenPhi-3Gemma构建统一健康网关对外只暴露一个/health聚合接口。
模型越小越要把它当核心服务来守护。
因为用户不会区分