Python后端部署排障18：从空环境到清理无残留，完成一次能重做的交付

Python后端部署排障18从空环境到清理无残留完成一次能重做的交付最后一次验收不是展示已经运行很久的容器。那样容易遗漏首次初始化、镜像构建、数据卷权限、迁移顺序和证书生成等问题。毕业流程从本次project尚不存在开始创建独立资源完成真实业务与受控故障再导出证据并清理。下一位读者解压交付物后应能按照相同顺序重做而不需要作者在旁边补命令。我们也不给一次本机实验附加它没有证明的结论。课程没有建立公网认证系统没有验证大规模并发写入没有实现跨机高可用两版本共享SQLite的蓝绿流程用于理解兼容性与发布顺序。能够清楚说出系统边界并提供与承诺相匹配的证据才是这个项目的毕业标准。E17完整答案清理后再独立查询一次下面脚本位于lessons/18/answer_previous.py必须放在实验末尾执行因为它会删除本次lab的数据卷。它要求已有本次运行环境先检查业务再清理不会默默新建一套环境掩盖前面的失败。E17: complete an existing unique lab, remove it, independently check ownership.importjsonfrompathlibimportPathimportsubprocessimportsys ROOTPath(__file__).resolve().parents[2]defrun(command):returnsubprocess.run(command,cwdROOT,checkTrue,textTrue,capture_outputTrue)deflab(*args):returnjson.loads(run([sys.executable,str(ROOT/ops/labctl.py),*args]).stdout)defowned(kind,project):command[docker,kind,ls,-q,--filter,labelcom.docker.compose.projectproject]ifkindcontainer:command.insert(3,-a)returnrun(command).stdout.split()defmain():statelab(status)projectstate[compose_project]assertproject.startswith(quoteops),Unexpected ownership scopebaseline{kind:owned(kind,project)forkindin(container,network,volume)}assertbaseline[container],E17 expects the current lab to existjourneylab(check)assertjourney[status]PASSdownlab(down)remaining{kind:owned(kind,project)forkindinbaseline}assertnotany(remaining.values()),remaining reportjson.loads((ROOT/reports/remote/cleanup.json).read_text())assertreport[status]PASS,reportassertreport[run_id]state[run_id],Stale cleanup reportprint(json.dumps({status:PASS,exercise:E17,compose_project:project,journey:journey,owned_before:baseline,remaining:remaining,cleanup:down}))if__name____main__:main()owned()使用com.docker.compose.project标签限定作用域容器查询包含已停止容器。只查正在运行的容器会漏掉停止后的残留因而不能作为清理完成的证据。镜像清理和已有基础镜像保留由labctl的资源登记报告负责本题同时要求报告状态PASS。标签查询与报告检查互相补充前者直接观察当前Docker状态后者覆盖本次创建过的其他对象。毕业目录不是文件越多越好而是角色清楚project/保存可独立安装的业务包与应用测试deploy/保存Dockerfile、Compose、Nginx配置和操作手册ops/labctl.py提供实验控制接口labs/保存有限资源的小实验。lessons/的每个答案承接上一课articles/用于阅读assets/保存PNG图reports/保存真实验证结果tools/保存交付检查工具。业务包中QuoteLedger负责报价合同QuoteOps只增加release探针。镜像的Python版本固定在3.11主线上构建前解析并记录基础镜像digest不把可变latest标签当作可重现证据。宿主实验控制脚本使用Linux可用的Python3标准库版本可能与容器解释器不同报告需要分别记录不能因为容器是3.11就推断宿主也是3.11。开始前确认终端位于课程根目录Docker服务与Compose插件可用当前用户具备执行本次实验的权限必要的基础镜像可以获取。不要在个人Windows工作区直接启动这套Linux故障实验。权限不足、依赖缺失或平台不匹配都应明确报错跳过一个关键步骤之后仍输出全套PASS会破坏毕业证据的含义。按一条明确的顺序完成验收完整验收先检查源码和文章结构再执行业务应用测试随后到已授权Linux环境进行部署与故障实验。部署部分从up开始记录本次run_id与资源清单完成check后依次验证TLS、发布失败保护、成功发布、回滚、备份恢复、日志、受限资源与停止上游恢复。最后执行E17再检查清理报告。下面命令展示核心操作顺序。详细的一键验收入口和实际运行结果以交付根目录README及reports为准手工重做时每一步都要检查退出码前一步失败不能继续把后面的输出拼成成功报告。python3 ops/labctl.py up python3 ops/labctl.py status python3 ops/labctl.py check python3 lessons/13/answer_previous.py python3 lessons/14/answer_previous.py python3 lessons/15/answer_previous.py python3 lessons/16/answer_previous.py python3 lessons/17/answer_previous.py python3 lessons/18/answer_previous.py这段顺序覆盖本专题后半段的答案E12发布、E13回滚与备份、E14日志、E15受限磁盘、E16事故恢复、E17最终清理。前半段的Linux、DNS、HTTP、镜像、TLS及健康检查由完整验收入口按依赖顺序执行不能因为这里没有重复罗列就认为可以省略。systemd user实验还需要真实用户会话及可用的用户服务管理器若环境不满足应如实报告缺失不用普通后台进程冒充systemd托管。用业务合同约束“部署成功”业务验收至少覆盖创建、读取、确认、旧version冲突以及取消路径。金额使用整数分并通过响应断言创建后读取应该与写入一致合法转换使version递增使用旧version再次提交应得到409且不覆盖赢家。若数据库连接错误ready应该失败health可独立返回轻量存活结果。这些行为来自应用合同部署改变了运行方式不应改变它们。持久化验收不能只看卷名称。先创建报价重建应用容器再读取同一id仍能读回才说明应用使用了预期持久卷。发布验收也不能只看容器有两个坏候选ready失败时入口仍须保持v1候选恢复后才能切v2并继续读取旧数据。回滚后仍读回相同数据证明该同schema版本组合支持应用回退。TLS验收同时检查正例与反例。正确主机名加正确CA应成功不信任CA或使用错误主机名应失败。只有正例可能说明客户端绕过了校验只有反例则可能只是入口根本不通两者一起才有区分力。课程所有成功结论都基于真实校验不把curl -k的连通性输出当成TLS认证通过。故障验收必须包括恢复后的业务对象停止上游演练保留实际502或504与活动容器停止状态恢复后读原报价。504演练保留代理等待超时证据并解释后端可能仍执行不能盲目重发写请求。未迁移库演练区分health200与ready503完成准备后ready恢复200。有限FD和tmpfs实验既记录目标errno也记录释放资源后操作成功。缺少恢复段的故障实验只证明你会把系统弄坏。日志验收使用唯一request_id贯穿edge与应用并把查询、正文和token的虚构标记作为不得出现的内容。备份验收从在线库导出到新文件再恢复到独立文件比较快照前后标记与业务行并执行integrity_check。仅生成备份文件或仅看到日志输出都不足以满足这一课的标准。资源退出证据单独记录ExitCode与OOMKilled。若受控强杀得到137而OOMKilled为false就把它写成强杀证据不写成“成功模拟内存溢出”。实际报告应该保留发生了什么而不是为了凑齐课程关键词给现象改名字。这种克制同样适用于性能少量探测耗时可以验证预算与超时行为不能推导生产容量承诺。报告怎样让别人相信而不暴露秘密报告应包含验证环境与版本、执行入口、命令退出码、关键断言结果和资源身份。时间、容器ID、镜像digest属于可追溯材料登录口令、私钥、真实Authorization和业务敏感正文不属于公开交付。需要保留证书验证证据时记录证书身份与校验结果不把私钥放进文章。阅读交付报告时区分三类信息已经执行且通过的检查、明确未执行的检查、系统本来就不提供的能力。源码存在不代表检查已经执行注释中的预期输出不代表观测结果某项限制不是失败只要交付从未承诺具备它。这个分类让报告比一句“全部正常”更有用也方便下一位操作者补做环境相关检查。清理报告必须在资源删除后生成列出本次拥有的资源、仍有残留的对象和之前存在镜像是否保留。若有残留报告应失败并给出具体对象不把异常捕获后当成零残留。随后将报告复制到交付目录并验证内容再移除远端本次工作目录。删除顺序不能让“尚未下载的证据”与“临时垃圾”一起消失。最后的自测G01本篇给出答案毕业自测不是再加一个新服务而是审核最终清理证据。题目要求读取本次cleanup报告验证status为PASS所有remaining_owned列表为空输出本次登记资源数量错误报告必须以非零状态退出。以下标准库脚本可直接保存为lessons/18/graduation_answer.py完整文件也随项目提供。G01: audit the cleanup report; this does not replace live Docker verification.importjsonfrompathlibimportPath ROOTPath(__file__).resolve().parents[2]defmain():pathROOT/reports/remote/cleanup.jsonreportjson.loads(path.read_text(encodingutf-8))assertreport[status]PASS,Cleanup did not passremainingreport[remaining_owned]assertisinstance(remaining,dict)andremaining,Missing live residue evidenceforkind,objectsinremaining.items():assertisinstance(objects,list),Expected object list for kindassertnotobjects,Owned resources remain: kind ownedreport[owned]assertisinstance(owned,dict)andowned,Missing ownership registrycounts{kind:len(objects)forkind,objectsinowned.items()}print(json.dumps({status:PASS,exercise:G01,registered_counts:counts,remaining_owned:remaining}))if__name____main__:main()这份审计不会重新操作Docker也不会把一份静态JSON等同于当前机器状态。它回答“报告是否满足约定”E17的独立标签查询回答“删除当时是否仍有本次容器、网络或卷”。二者职责清楚。若想隔日确认机器没有新产生同名资源应再次执行只读查询不能把旧报告当作永不过期的事实。把项目讲成一段可追问的经历可以这样叙述我把报价服务部署在单机Compose中用两个同schema版本和Nginx演示发布先验证候选准备好再测试并重载代理配置失败保持旧流量。我实际注入过502、504、未准备好和受限资源失败使用请求id与运行状态取证恢复后读回原报价。我用SQLite backup恢复到独立文件验证快照最后按资源归属精准清理。每一句后面都能指向一个源码文件、一条断言或一份实际报告。若被问到扩展方向可以讨论独立数据库、创建幂等键、认证授权、集中日志、容量测试与多机故障域但应清楚说明这些是后续设计。到这里你交付的不是一张“运行成功”截图而是一套读者能够重新执行、发现失败、恢复业务并安全结束的实验。课程目录《Linux、网络与后端部署排障从“接口能跑”走到“服务能维护”》 · 上一篇第17篇 · 交付README课程文件README.md