Python后端部署排障18：从空环境到清理无残留，完成一次能重做的交付
最后一次验收不是展示已经运行很久的容器。那样容易遗漏首次初始化、镜像构建、数据卷权限、迁移顺序和证书生成等问题。毕业流程从本次project尚不存在开始，创建独立资源，完成真实业务与受控故障，再导出证据并清理。下一位读者解压交付物后，应能按照相同顺序重做，而不需要作者在旁边补命令。
我们也不给一次本机实验附加它没有证明的结论。课程没有建立公网认证系统，没有验证大规模并发写入，没有实现跨机高可用；两版本共享SQLite的蓝绿流程用于理解兼容性与发布顺序。能够清楚说出系统边界，并提供与承诺相匹配的证据，才是这个项目的毕业标准。
E17完整答案：清理后再独立查询一次
下面脚本位于lessons/18/answer_previous.py，必须放在实验末尾执行，因为它会删除本次lab的数据卷。它要求已有本次运行环境，先检查业务再清理，不会默默新建一套环境掩盖前面的失败。
"""E17: complete an existing unique lab, remove it, independently check ownership."""importjsonfrompathlibimportPathimportsubprocessimportsys ROOT=Path(__file__).resolve().parents[2]defrun(command):returnsubprocess.run(command,cwd=ROOT,check=True,text=True,capture_output=True)deflab(*args):returnjson.loads(run([sys.executable,str(ROOT/"ops/labctl.py"),*args]).stdout)defowned(kind,project):command=["docker",kind,"ls","-q","--filter","label=com.docker.compose.project="+project]ifkind=="container":command.insert(3,"-a")returnrun(command).stdout.split()defmain():state=lab("status")project=state["compose_project"]assertproject.startswith("quoteops"),"Unexpected ownership scope"baseline={kind:owned(kind,project)forkindin("container","network","volume")}assertbaseline["container"],"E17 expects the current lab to exist"journey=lab("check")assertjourney["status"]=="PASS"down=lab("down")remaining={kind:owned(kind,project)forkindinbaseline}assertnotany(remaining.values()),remaining report=json.loads((ROOT/"reports/remote/cleanup.json").read_text())assertreport["status"]=="PASS",reportassertreport["run_id"]==state["run_id"],"Stale cleanup report"print(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 ROOT=Path(__file__).resolve().parents[2]defmain():path=ROOT/"reports/remote/cleanup.json"report=json.loads(path.read_text(encoding="utf-8"))assertreport["status"]=="PASS","Cleanup did not pass"remaining=report["remaining_owned"]assertisinstance(remaining,dict)andremaining,"Missing live residue evidence"forkind,objectsinremaining.items():assertisinstance(objects,list),"Expected object list for "+kindassertnotobjects,"Owned resources remain: "+kind owned=report["owned"]assertisinstance(owned,dict)andowned,"Missing ownership registry"counts={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）
