来源书籍

微服务实战

Skill 版本:v23 389 张卡片

摩根·布鲁斯(Morgan Bruce)、保罗·A.佩雷拉(Paulo A. Pereira) · 李哲 译 · 人民邮电出版社 · ISBN 9787115529879

全书导读

本书把微服务理解为让软件和团队持续演进的一种交付方式:一个服务围绕明确能力拥有其数据,经契约与他方协作,并能在适当范围独立修改和部署。服务小、用了容器或改成HTTP都不是充分条件,真正要减少的是不必要的变更依赖,同时明确故障、状态和长期所有权。

SimpleBank是贯穿全书的虚构案例。出售股票涉及网关、订单、持仓预留、收费及交易市场;后面又加入投资策略、支付和用户设置等需求。它的价值是让领域边界与运行后果具体可见,而不是提供经过生产验收的金融系统。第2、5、7及11章的收费与订单事件顺序有不同方案,本笔记分别说明,不把示例拼成一份未定义的业务流程。

设计部分先区分客户端、边界、服务和平台的责任,再用限界上下文决定谁理解哪种模型、谁拥有数据及暴露什么接口。把本地事务拆成网络协作,会出现超时结果未知、部分提交和补偿失败。2PC、Saga、API组合、CQRS及事件溯源分别移动协调、可见性与存储责任,没有一种仅凭名称就能保证业务正确。原书有具体扣费、撤销和持仓问题时,本笔记分开问题与方案,并保留原文未展开的幂等、隔离和恢复边界。

可靠性部分从超时、重试、熔断、发现、健康及限流解释如何限制故障传播。框架和底座把共性接进每个服务,仍须核对异常类型、确认点和业务副作用。消息入队与消费完成不同,prefetch是未确认窗口,HTTP受理成功不等于后台已经追平;这些差异贯穿测试、指标和实际恢复。

部署部分将源代码、构建输入、镜像工件、配置、集群期望状态和功能开放分开。不可变工件减少漂移,控制器负责调和运行资源,Service负责入口,流水线负责验证与反馈,金丝雀和开关则限制变化影响。API受理、Pod启动、服务就绪、业务完成属于不同层次。旧Kubernetes API、Helm 2、Jenkins脚本及追踪依赖按历史范围保存,已知印刷与机制错误就地说明,未把示意脚本写成现行可部署教程。

最后,指标显示需求、结果和资源压力,日志保存可检索事件,追踪关联操作因果及时间,告警把异常转成有人负责的行动。长期负责服务的团队、共享平台、内部贡献与动态文档使反馈能回到下一次设计。这里的独立性因此是一种需要契约、平台和协作持续维护的能力;在团队与运行成本不足时,保留模块化单体或渐进拆分也可能更合理。

全书主线

全书沿“为什么拆分→怎么划界→如何承受分布式后果→如何交付运行→谁持续负责”推进,各章作用如下。

正文项 核心问题与论述主线
序前 将设计、测试、部署和运行作为完整生命周期,工具示例服务于原则理解。
第1章 从内聚与耦合解释自治,比较业务扩展收益与分布式、团队和运维代价。
第2章 用SimpleBank串起领域需求、服务协作及最小完整产品,建立后续共同语境。
第3章 通过客户端、边界、服务和平台分层安排责任,结合演进原则处理架构约束。
第4章 从新投资策略功能识别限界上下文和模型,再明确契约与依赖方向。
第5章 先处理跨服务写入和补偿,再处理跨服务查询,分清一致性可见性和故障责任。
第6章 从失败模型到超时重试熔断及发现健康检查,让请求在不确定网络中有边界地恢复。
第7章 将通信、指标、日志等共性放进底座,通过消费者与压测观察证明框架并不代替业务可靠性。
第8章 从运行基础设施走到工件、配置与发布策略,说明部署可重复和状态兼容的重要性。
第9章 由镜像构建分发进入Pod、控制器、Service、探针和修订更新,分开期望与实际状态。
第10章 将构建、验证、推广、反馈串成可复用流水线,再把部署与功能开放分开决策。
第11章 定义指标口径与采集链,建立层级面板和可行动告警,再关联业务跨服务完成情况。
第12章 先统一事件格式和集中查询,再传播trace context形成可解释的操作关系与时间线。
第13章 长期所有权、自治和端到端责任为运行反馈提供归属,平台社区评审及文档支持协作。
附录A 给出历史本地Jenkins环境的对象、参数和最小测试,区分旧工具流程与长期可复用责任。
flowchart TD
 A[业务变化与团队压力] --> B[内聚边界和明确契约]
 B --> C[数据所有权与协作协议]
 C --> D[故障限制与恢复]
 D --> E[可重复工件和分阶段交付]
 E --> F[指标日志追踪与可行动告警]
 F --> G[长期负责团队理解实际结果]
 G --> B
 P[共用平台与工程约定] --> D
 P --> E
 P --> F

图是已读全文的论述关系,不表示每个请求都按此顺序执行。团队反馈可能要求重新合并服务、修改契约或改变基础设施,因而不是一次完成的拆分流程。

译者序

微服务通过划分业务或技术能力降低维护难度,但不是适用于所有系统的银弹。独立部署和维护并不禁止以后因业务变化重新合并服务。译者强调设计、测试、部署、运维应作为一个生命周期理解;有关中台和未来技术的判断是本书出版语境中的观点,不能作为当前技术现状的证明。

前 言

全书来自 Onfido 的微服务开发经验,并从运行经验扩展为设计、部署、运维的完整指南。核心诉求是让产品和团队扩大后仍能持续演进,而不是只展示如何拆小代码库。书中 Kubernetes、Docker 等工具承担教学载体的作用,原则是否适用应与具体工具版本分开判断。

微服务交付覆盖全生命周期进一步说明此处的机制与边界。

原书依据 · 1 处

关于本书

目标读者是已具备面向服务开发基础的开发者和架构师。教学路径由设计原则走向可靠发布和集群维护;Python 用来让示例清楚,Kubernetes、Docker、Google Container Engine 用来演示部署。掌握示例语法不等于获得生产就绪能力,后文还将补上交付与诊断。

路线图

四部分组成一条由功能到运行的路径:第1—2章解释架构与 SimpleBank 案例;第3—7章讲整体结构、服务边界、事务查询、可靠性及框架;第8—10章讲发布、容器调度与交付流水线;第11—13章把指标、日志追踪和团队所有权接回生产运行。附录补充本书 Jenkins 演示环境。这里只安排阅读,不把后文章节内容算作已读。

代码

代码采用等宽字体,粗体可能标示新增代码或区分命令输入输出;为排版会换行、调整缩进,有些注释已移入正文。示例通常借助 Docker 和 docker-compose 运行,附录服务于第10章的本地 Kubernetes/Jenkins 配置。阅读时需保留这种排版约定,不能把印刷换行直接当成可执行代码边界。

第一部分 概述

第一部分先介绍微服务的特性、收益和挑战,再用虚构的 SimpleBank 将设计与投入生产连起来。它的作用是给后续设计、部署、观测各部分建立共同业务背景,不额外提出新的机制。

第1章 微服务的设计与运行

本章把微服务视为一套覆盖设计、上线和运行的交付方式。服务变小可以减轻开发摩擦,但产品大部分生命发生在生产环境,因而还需部署、监控和诊断能力。后面先解释服务边界,再讨论拆分带来的设计与运维代价,最后把文化与技术接在一起。

1.1 什么是微服务应用

微服务应用是一组自治服务通过接口或消息协作完成业务。内聚表达内部元素为何属于整体,耦合表达对他方内部实现的依赖;单一职责据变更原因划界。在线投资例子把订单记录、持仓预留、计费和市场提交分给不同服务。预留旨在防止同一份股票多次出售,但本节没有给出原子预留、释放、幂等或跨服务事务的算法。服务拥有其数据并对外提供契约,应可独立部署和替换,业务编排不应隐藏在消息总线中。

微服务以独立功能协作进一步说明此处的机制与边界。

用变更原因判断内聚进一步说明此处的机制与边界。

服务拥有自己的数据进一步说明此处的机制与边界。

出售中的持仓可能重复占用进一步说明此处的机制与边界。

预留持仓防止重复出售进一步说明此处的机制与边界。

出售订单跨服务协作进一步说明此处的机制与边界。

编排逻辑留在服务中进一步说明此处的机制与边界。

原书依据 · 8 处
1.1.1 通过分解来实现扩展

扩展立方体区分复制相同实例的X轴、按功能拆分的Y轴和数据分片的Z轴。微服务主要体现Y轴,仍可结合其他两轴。预测、账户和交易不同负载使独立选型与扩容有价值,但隔离收益受依赖设计约束,不是拆开进程便能保证。

扩展立方体区分三个维度进一步说明此处的机制与边界。

按功能选择技术和资源进一步说明此处的机制与边界。

原书依据 · 2 处
1.1.2 核心原则

本章以自治性、可恢复性、透明性、自动化和一致性统领决策。它们分别约束依赖与所有权、故障应对、运行可解释性、重复操作成本、业务与组织对齐。下列小节逐项展开,避免只留下五个口号。

1.自治性

自治首先依赖隐藏内部实现的接口或事件,其次需要可独立发布,避免多个团队强制同步上线。团队还应承担开发到生产的端到端责任。图1.3以契约隔开订单和账户交易服务;这种接口关系是教学抽象,而非具体代码语言类型定义。

自治依赖契约和独立部署进一步说明此处的机制与边界。

原书依据 · 1 处
2.可恢复性

组件隔离可以缩小故障和发布影响,但服务依赖仍可能传递故障。市场不可用时订单可暂存后续处理,是本例允许的延迟方式;真实业务须明确可保留的能力和恢复条件。异步、超时、熔断、可靠交付与监控共同支撑恢复。

故障隔离需要恢复设计进一步说明此处的机制与边界。

原书依据 · 1 处
3.透明性

透明性要求能发现并解释系统行为。日志、业务/运维数据和请求记录分别提供局部证据,需要结合其含义诊断跨团队协作问题。

透明性让协作行为可诊断进一步说明此处的机制与边界。

原书依据 · 1 处
4.自动化

微服务增加运行组件数量,必须以自动化部署运维和标准化基础设施降低管理成本。基础设施即代码与可编程云接口解释了小团队运行细粒度服务为何变得可行;这不是对某个当前云产品能力的核验。

自动化抵消服务管理成本进一步说明此处的机制与边界。

原书依据 · 1 处
5.一致性

本节的一致性指业务能力、服务与团队对齐。按技术层横向分拆会使一个功能跨多次发布;纵向服务应封装其所需的各技术层。共用第三方集成可作为技术服务例外。公开契约还需向后兼容或并行版本,保护消费方的独立节奏。

沿业务纵向划分服务进一步说明此处的机制与边界。

向后兼容保护消费方节奏进一步说明此处的机制与边界。

原书依据 · 2 处
1.1.3 谁在使用微服务

采用微服务的压力包括负载、新功能、团队规模、技术债和国际化的数据延迟约束。列举公司是历史迁移背景,不能替本系统证明选型;既有单体与新服务长期共存也很常见。

迁移压力决定拆分动机进一步说明此处的机制与边界。

原书依据 · 1 处
1.1.4 为什么微服务是一个明智的选择

单体已有大量成功实践,选择微服务必须说明其针对的具体压力。后文从技术差异、交付摩擦和发布风险三方面解释,而非以潮流代替理由。

1.技术差异性为微服务开路

当机器学习产品与现有Ruby技术栈不匹配时,独立服务可以为新能力引入合适技术。这是技术异构的一个具体动机,已纳入按功能选技术的讨论,不推出每种语言都应独立建服务。

2.开发冲突随着系统发展而增加

业务固有复杂性无法用架构消除;可减少的是实现和协作制造的额外负担。单体中的变更周期耦合、边界含混,以及构建启动变慢,会拖慢持续交付。这里是有条件的压力描述,不是单体必有缺陷的判断。章末脚注进一步区分本质和偶然复杂性。

区分本质与偶然复杂性进一步说明此处的机制与边界。

变更周期耦合拖慢交付进一步说明此处的机制与边界。

原书依据 · 3 处
3.微服务降低冲突和风险

内聚的小服务通过减少开发依赖、缩小理解范围、交付小变更来减轻冲突。是否值得采用仍取决于团队、领域及运行代价。五个月停止交付、在繁忙期整体切换后回滚的迁移案例说明集中风险的后果;渐进迁移能不断平衡业务与架构约束。

小变更降低单次发布风险进一步说明此处的机制与边界。

整体重写迁移风险集中进一步说明此处的机制与边界。

原书依据 · 2 处

1.2 微服务的挑战

代价集中在领域认知不足、边界与契约演化困难、分布式状态和网络假设、多点故障以及整体行为难以验证。接下来的设计和运维小节分别展开这些问题,不能用收益一节抵消它们。

1.2.1 设计挑战

服务内高内聚、服务间低耦合需要随领域认知演进。功能范围可能调整乃至服务下线,早期划分失误会使整体变化更难,因而自治不是一次拆分的永久成果。

1.划定微服务范围需要业务领域知识

错分职责往往需要跨库搬迁数据、跨代码库移动功能、修改消费者并协调部署。图1.5展示把功能从A移至B不仅是移动代码,因此领域知识不足时,远程边界比本地模块更昂贵。

服务边界错误迁移代价高进一步说明此处的机制与边界。

原书依据 · 1 处
2.服务契约的维护

契约定义接受和返回的消息,完整、简洁、可预测分别约束信息齐全、内容最小和行为真实。它在独立实现之间提供稳定连接,演化时又要兼顾向后兼容,因此不是只有请求字段即可。

契约需完整简洁可预测进一步说明此处的机制与边界。

原书依据 · 1 处
3.微服务应用是多个团队设计的

多团队各有周期与目标,仍需共同确定跨服务优先级和实践,否则局部独立会转化为全局等待。它与自治并不矛盾,而是共同业务交付的条件。

团队自治仍需共同优先级进一步说明此处的机制与边界。

原书依据 · 1 处
4.微服务应用是分布式系统

远程调用有延迟、容量和失效,数据也分散到多个服务,本地调用及单库ACID的假设不能直接沿用。设计要解释操作顺序不确定、状态暂不一致和失败时的业务行为;此处只提出问题,后续事务章才给方案。

网络调用改变失败假设进一步说明此处的机制与边界。

原书依据 · 1 处
1.2.2 运维挑战

故障可出现在服务进程、网络、数据库和第三方。图1.6将它们放回订单链。拆分把部分开发协调成本移到部署、验证与诊断;需要知道实际发生与预期发生的流程,才能处理多点失败。

拆分把部分成本移向运维进一步说明此处的机制与边界。

原书依据 · 1 处
1.难以实现的可观测性

日志是局部视图,跨服务诊断需关联多个数据片段形成全局流程。主机CPU、内存仍有用,但其与应用的直接对应关系会随部署方式变化,无法单独解释业务成功与否。

关联局部数据才能看见全局进一步说明此处的机制与边界。

原书依据 · 1 处
2.不断增加的服务使得故障点增多

将组件视为可能失效,可以提前设计错误检查、切换和恢复,并确定哪些业务能力在局部故障时仍可运行。系统可靠性不能寄托于每个组件永不失败。

按组件必然失效设计系统进一步说明此处的机制与边界。

原书依据 · 1 处

1.3 微服务开发生命周期

设计、部署和监控构成反复迭代的生命周期:边界与通信决定运行行为,发布送入生产,运行证据反过来修正设计。图1.7明确画出了监控返回设计的环路。

设计部署监控形成反馈环进一步说明此处的机制与边界。

原书依据 · 1 处
1.3.1 微服务设计

设计决策覆盖从单体还是微服务起步、整体结构与外部接口、边界识别、通信方式和恢复性。这里组织问题清单,后续小节和后文章节再回答具体取舍。

1.单体应用是否先行

单体先行的理由是早期不知道边界,局部调整成本低;直接微服务则可能较早获得独立交付,但起步成本高。两条路均有适用条件,也不要求未来服务照搬单体模块。

单体先行取决于边界认知进一步说明此处的机制与边界。

原书依据 · 1 处
2.服务的范围划定

特殊订单需求可扩展已有接口字段、增加已有服务的操作,或新增服务。图1.8展示各自改变的是契约、操作面或服务部署边界,选择需评价内聚与耦合,而非以新需求自动触发新服务。

新功能不必立即新建服务进一步说明此处的机制与边界。

原书依据 · 1 处
3.通信

同步协作较易沿调用排查,异步协作降低直接依赖并有助恢复,却增加协调复杂性。两者应围绕业务和运维目标平衡,不存在一律异步的结论。

同步异步权衡恢复与诊断进一步说明此处的机制与边界。

原书依据 · 1 处
4.可恢复性

防御性服务不假设网络和协作方可靠:出错时回退、限制不友好流量、动态寻找健康实例,目的都是减少局部异常的传播。这里的措施只列用途,具体算法仍待后文。

1.3.2 微服务部署

开发与运行需要闭环。标准化部署操作和持续交付流水线,让新增服务不再重复投入底层部署劳动;生产经验也反馈到设计,开发者不能在写完功能后就不承担运行责任。

1.微服务部署的人为操作标准化

服务的依赖包括类库、系统包、二进制和辅助进程。容器把打包与启动接口标准化,在共享内核条件下隔离运行空间。图1.9提醒依赖与运维接口都要纳入交付;书中的Docker成熟度和启动时间比较保留为历史语境,不能当当前选型或无条件性能承诺。

容器标准化服务运行界面进一步说明此处的机制与边界。

原书依据 · 1 处
2.实现持续交付流水线

持续交付把验证条件与自动推进组合成可重复过程。图1.10从提交、构建、单测、打包到集成与验收,逐步增加可信反馈;小服务有利于独立发布,但不替代验证。可随时可靠发布并不意味着每次提交必须自动投产。

持续交付需要验证与自动化进一步说明此处的机制与边界。

原书依据 · 1 处
1.3.3 服务监控

监控既用于发现薄弱环节、调整设计,也用于理解实际运行。多个服务的数据格式与规模差异使端到端观测比单进程更复杂,下一小节分别处理恢复与全局解释。

1.发现潜在的薄弱环节并进行重构

故障可能来自代码、环境、网络、硬件。告警帮助诊断并可触发恢复动作,依赖设计则应支持局部降级;扩容只是可能措施,不能代替判断故障原因。

监控结果反哺局部降级进一步说明此处的机制与边界。

原书依据 · 1 处
2.了解数以百计的服务的行为

观测围绕业务核心建立多层数据:业务指标、日志、运维指标、基础设施指标,最后进入共同分析与告警入口。图1.11的洋葱模型强调请求穿过各层,每一层的正常都不能单独证明完整业务正常。

围绕业务功能建立观测层进一步说明此处的机制与边界。

原书依据 · 1 处

1.4 有责任感和运维意识的工程师文化

团队沟通结构与服务设计相互约束。希望端到端自治就要相应分配责任和协作方式,单改技术架构而保留原有的跨部门等待,难以获得预期收益。第13章将更具体地处理所有权和协作。

沟通结构约束服务边界进一步说明此处的机制与边界。

原书依据 · 1 处

1.5 小结

全章收束五项原则、边界与契约、交付风险、自动化与运行透明性,并重申团队须关注全生命周期。参考文献是历史公司迁移与单体先行讨论;脚注定义本质复杂性和偶然复杂性,为前面的架构取舍补足概念边界。

区分本质与偶然复杂性在本节脚注获得定义补充。

原书依据 · 2 处

第2章 SimpleBank公司的微服务

本章用虚构SimpleBank把第1章原则走成一条功能路径:理解投资业务、划定能力、选择协作方式、开放接口,再检查能否上线运行。所有公司情境和订单流程均是教学例子,不能被当作某家真实银行系统的调查结果。

2.1 SimpleBank公司的业务范围

投资领域不只包括面向客户的开户和投资组合,还包括托管、转移及金融产品设计。图2.1先建立业务能力总览,为职责划分提供依据。一个领域可以包含多个服务,不能把表的CRUD接口直接当作高内聚服务,也不能将全部责任放到一个大服务。

领域总览先于服务划分进一步说明此处的机制与边界。

原书依据 · 1 处

2.2 微服务是否是正确的选择

税务规则因国家、税种或账户而独立变化,说明为什么变化驱动力可能形成自治边界。选择架构还需同时评估领域复杂度、技术需求、组织成长和团队知识;不熟悉分布式系统时先做概念验证,不能把看似合理的业务动机当成团队已具备运行能力。

独立税务规则减少发布牵连进一步说明此处的机制与边界。

架构选择还要看团队知识进一步说明此处的机制与边界。

原书依据 · 2 处
2.2.1 金融软件的风险和惰性

本节以金融组织的风险厌恶和遗留系统依赖解释变化阻力,强调限制变更次数并不能证明系统不会故障。有关银行年代、罚款和客户数量的叙述是书中历史案例,正文与所列新闻标题的数量口径也不一致;本次不将其转写成已核验的金融事实。没有展开并发、幂等或隔离的具体根因,不新增资金正确性案例卡。

2.2.2 减少阻力和持续交付价值

解耦变更周期、规范组件交互和持续交付小改动,可降低复杂系统的交付摩擦。此处是第1章结论在银行生命周期中的应用,不重复造卡;长期收益仍依赖真实的服务边界和可靠运行。

2.3 开发新功能

最小可行产品选择一条能交付用户价值的路径,检验服务识别、协作和外部开放。图2.3在初始流程中校验持仓并行预留与收费,再等待市场开市;这只是当前设计草图,后面2.3.3会改变收费触发点,不能把两个版本拼成同一个时序承诺。

最小产品验证完整交付路径进一步说明此处的机制与边界。

原书依据 · 1 处
2.3.1 通过领域建模识别微服务

从订单状态、收费、账簿记录、市场提交及持仓价值等具体工作映射到业务能力。图2.4说明一项工作可跨能力;图2.5又用订单类型与市场范围两种变化驱动力分离订单管理和市场操作。不是每个功能都独立成服务;领域认知不足时可先保留较大而内聚的职责,再渐进拆分。

功能组合成业务能力进一步说明此处的机制与边界。

按变化驱动力分离市场操作进一步说明此处的机制与边界。

先保留内聚再逐步细拆进一步说明此处的机制与边界。

原书依据 · 3 处
2.3.2 服务协作

服务协作可直接点到点,也可事件驱动。同步较易排查,但远程HTTP不具备本地函数的速度与可靠性,HTTP也并非只能承载同步业务。图2.6先以订单服务控制账户、费用和市场说明初始方案,为后续分析协调者负担建立基线。

1.服务契约

请求与响应形成契约,维持兼容使服务可作为黑盒使用。服务增多后,机器可读接口规范、一致性测试和标准发布有助跨团队理解依赖。Swagger/OpenAPI这里只作为REST契约显式化工具介绍,不能替代业务正确性验证。

机器可读契约支持跨团队协作进一步说明此处的机制与边界。

接口规范显式描述服务契约进一步说明此处的机制与边界。

原书依据 · 2 处
2.服务职责

订单服务直接控制所有动作时,新加大额通知也要修改订单服务,下游则逐渐贫血。这暴露了协调者扩张的代价:需要区分必须同步确认的职责和能够独立订阅事实的工作,而非否定一切协调。

协调者膨胀会增加变更耦合进一步说明此处的机制与边界。

原书依据 · 1 处
2.3.3 服务编排

本书用编排指choreography,用编配指orchestration。调整后,订单创建并发布OrderCreated,市场服务订阅,在成功提交市场后发OrderPlaced;费用服务据它收费,订单服务据它更新状态,两个订阅者可并行。创建、提交和最终成交不同,TradeExecuted/OrderExpired是后续扩展事件。队列重发可帮助恢复的前提是持久化,但仍要承担队列运维与全局追踪代价;图和文字没有证明持仓、发布和收费在重复投递下是原子或幂等的。

命令协调与事件协作有取舍进一步说明此处的机制与边界。

用订单事件分散协作职责进一步说明此处的机制与边界。

创建提交成交是不同状态进一步说明此处的机制与边界。

事件恢复依赖持久化与追踪进一步说明此处的机制与边界。

消息队列承接事件分发进一步说明此处的机制与边界。

原书依据 · 6 处

2.4 向外界开放服务

网关作为后端门面,让网页/移动端取得持仓、市场数据并提交订单,代理与转换、合并响应隐藏后端拓扑。图2.8展示这一边界。统一入口也可能因客户端相反的数据需求和业务逻辑侵入而膨胀,后文还要比较其他设计。

网关为外部应用提供门面进一步说明此处的机制与边界。

统一网关易积累冲突需求进一步说明此处的机制与边界。

原书依据 · 2 处

2.5 将功能发布到生产环境中

图2.9用虚拟机实例、负载均衡器和事件队列搭起基础部署。手工上传后能请求成功,并不证明服务生产就绪;只有一人懂发布的巴士系数1还暴露知识集中风险。可靠性、扩展容量、透明性与容错需要具体证据,后续以自动化部署、恢复性和透明性补齐。

知识集中降低巴士系数进一步说明此处的机制与边界。

生产就绪需要运行证据进一步说明此处的机制与边界。

原书依据 · 3 处
2.5.1 高质量的自动化部署

开发标准包括代码评审、测试与版本控制,部署标准包括充分验证和自动化流水线。两者一起建立可重复的信任:只做审批或只追求开发速度都不能替代发布质量。本节不据历史比例宣称当前所有不可用都由发布导致。

标准化研发与发布获得信任进一步说明此处的机制与边界。

原书依据 · 1 处
2.5.2 可恢复性

表2.2按硬件、服务间通信和依赖分类风险,覆盖主机机房、物理网络、防火墙DNS、数据库及外部超时。即使应用代码没有缺陷,这些路径仍可能失效,服务设计须解释如何降低影响。

按故障领域检查服务依赖进一步说明此处的机制与边界。

原书依据 · 1 处
2.5.3 透明性

订单创建超时而日志不足的例子说明,网络、数据库和下游都可能造成同一症状。图2.11将实例代理采集到的日志集中索引,使工程师可追踪位置。心跳发现完全无响应,服务级延迟与可用性目标发现不满足期望的运行;书中100毫秒、95%和99.99%只是示例,实际需补统计口径。观测随后还应包含业务指标、链路与基础设施数据。

集中日志缩短跨服务定位进一步说明此处的机制与边界。

健康检测和服务目标互补进一步说明此处的机制与边界。

原书依据 · 2 处

2.6 大规模微服务开发

服务与团队增多后,技术选择自由会带来分歧,专业化又可能带来孤立。下列两节分别说明它们如何影响整体交付,不能把自治等同各自为政。

2.6.1 技术分歧

本节用结构化日志与一句纯文本输出比较:请求ID、耗时、版本和响应信息让多个服务可用共同方式诊断。不同内部技术可以保留,但公共运行界面和基本实践需有一致标准,以免支持成本随服务增长失控。

统一诊断字段降低技术分歧进一步说明此处的机制与边界。

原书依据 · 1 处
2.6.2 孤立

专业化团队可能只了解狭窄领域,并只优化本地指标。由于业务价值来自多个服务协作,这种局部目标会影响全局可靠性和部署速度;需要把自治与跨团队共同目标连接。

局部专业化可能形成团队孤岛进一步说明此处的机制与边界。

原书依据 · 1 处

2.7 接下来的内容

从设计到生产的路径再次强调透明、容错、可靠、可扩展,并把后续重点转向领域边界及服务交互。该小节是过渡总结,不增加新的机制。

2.8 小结

全章收束业务建模、协作方式、网关和生产就绪,以及团队分歧与孤立。脚注补充持久化队列假设、巴士系数定义和历史来源。事实例证与机制解释分开:新闻数字不当成当前核验结果,日志聚合工具只登记名称,后续正文展开时再取材。

知识集中降低巴士系数的边界也由本节脚注补充。

事件恢复依赖持久化与追踪的边界也由本节脚注补充。

原书依据 · 4 处

第二部分 设计

第二部分由整体四层架构走向服务边界、事务与查询、可靠性及可复用框架。它安排的是从全局到局部的设计路径,本段自身没有独立机制,后续章节须逐一阅读。

第3章 微服务应用的架构

本章把第2章单条功能扩展成全局架构视角,以平台、服务、边界、客户端四层检查职责,并单独讨论贯穿层次的通信。最后从统一网关走向BFF与消费者查询,再回到前端独立交付。模型提供观察角度,不是每层必须一对一部署的产品清单。

3.1 整体架构

外部需求、缺陷、市场和团队变化不断推动软件演进。架构应减少替换组件与团队协作时的摩擦,规划的是让系统持续可变的技术基础,而非一次性消除所有不确定性。

3.1.1 从单体应用到微服务

单体可按展示、逻辑、数据三层组织,单个微服务也可能具有相同内部结构。区别在全局:应用像社区,需要规划基础设施、服务位置、连接和并行演进,而非只建一栋楼。图3.1⁄3.2是职责结构,不对应原文未定义的具体代码类。

架构还要规划服务环境进一步说明此处的机制与边界。

原书依据 · 1 处
3.1.2 架构师的角色

架构师用战略一致性、共同技术准则及跨团队运行能力指导应用演化。准则连接目标与实践,概念模型帮助全局推理,二者都不要求冻结每个服务的未来实现。

架构师保障系统持续演进进一步说明此处的机制与边界。

原书依据 · 1 处
3.1.3 架构准则

准则从产品目标出发,指导具体选择。例如隐私敏感产品需要考虑数据保留和追踪。图3.3把目标、技术准则、实践决策连起来;准则需随阶段调整,ISO 27001在此仅为示例名称,不据此给出认证或法律结论。

准则把目标连接到实践进一步说明此处的机制与边界。

原书依据 · 1 处
3.1.4 微服务应用的4层架构

四层模型中,平台支撑运行发布通信,服务承载业务与技术能力,边界向外适配功能,客户端使用功能。它与单服务内部三层模型观察尺度不同,应用实现也不必严格分成四个进程。

四层模型分配架构职责进一步说明此处的机制与边界。

原书依据 · 1 处

3.2 微服务平台

平台能力包括部署目标、日志指标、重复发布、安全及通信发现。图3.5表示这些能力对服务的支撑关系。减少每个团队重复底层工作,是平台价值的来源;仍要围绕服务团队实际需求建设。

平台封装共同运行能力进一步说明此处的机制与边界。

原书依据 · 1 处
映射运行时平台

图3.6把实例、主机、共享资源、配置和机密联系到运行时目标,再叠加部署升级回滚与观测。云平台或PaaS只是基础目标,不能把主机可用等同完整微服务平台就绪。

运行时目标只是平台基础进一步说明此处的机制与边界。

原书依据 · 1 处

3.3 服务层

服务层包含业务或技术服务及其数据存储;它借平台运行,并通过边界向客户端提供价值。后文依次区分功能类型、聚合/协调结构和关键路径,以免把所有服务当作同一种角色。

3.3.1 功能

订单表达业务目标,市场网关封装第三方通信技术能力。图3.7还显示技术网关可支持结算和市场数据服务。划分看责任而非名字,技术服务也不等于平台设施。

技术能力支撑业务能力进一步说明此处的机制与边界。

原书依据 · 1 处
3.3.2 聚合与多元服务

聚合器查询关联多个输出,协调器则向多个下游发命令。图3.8以持仓查询和下单控制比较两者。新增层级满足组合需求,但增加服务也可能加深耦合,继续往旧服务塞功能又可能损害内聚,需要明确变化原因。

聚合器查询协调器发命令进一步说明此处的机制与边界。

原书依据 · 1 处
3.3.3 关键路径和非关键路径

关键路径取决于用户要完成的业务,订单、持仓与资料有不同依赖,交易服务可同时参与多路。依赖越多通常暴露更多失效机会,恢复和扩展投入宜围绕重要路径。原书将可靠性直接相乘是简化模型,实际需处理共同故障、替代路径与依赖关系,不能无条件套用。

沿业务路径评估关键依赖进一步说明此处的机制与边界。

原书依据 · 1 处

3.4 通信

通信贯穿平台与服务:代理和发现属于平台,消息语义和业务响应属于服务。智能端点、简单管道意味着不把业务流程再次埋入中间件,而不是服务无需协调。成熟系统可同时包含同步与异步。

智能端点保持管道简单进一步说明此处的机制与边界。

原书依据 · 1 处
3.4.1 何时使用同步消息

下一步必须取得前一步结果时,请求—响应方式直接。图3.10展示组装、传输、处理和响应链,仍需要承担远程等待和故障,不能继承本地调用的假设。

同步用于后续必需的结果进一步说明此处的机制与边界。

原书依据 · 1 处
1.选择传输方式

选择传输要比较延迟、语言支持和契约工具。gRPC/Protobuf示范生成两端契约的能力,业务逻辑则应与状态码、流等传输细节隔开。统一机制可降低工具成本,但不推出任意机制都是最优。

传输机制与业务逻辑分离进一步说明此处的机制与边界。

生成契约连接两端实现进一步说明此处的机制与边界。

原书依据 · 2 处
2.缺点

同步需知道协作方,广播与发布订阅并非其自然优势;等待在某些执行模型中占用线程或进程,深依赖可能传播阻塞和故障。它们是条件性代价,不是同步必定失败的判断。

同步等待可能耗尽执行资源进一步说明此处的机制与边界。

原书依据 · 1 处
3.4.2 何时使用异步消息

事件是已经发生的变化,新消费者可订阅已有事实而不要求生产方知道它。行为分散后需要更多观测。事件中枢接收并分发,Kafka的事件存储重放与RabbitMQ消息中间件侧重不同。事件溯源和CQRS在此只是预告,并不是微服务前提。

事件描述已经发生的变化进一步说明此处的机制与边界。

事件中枢负责接收和分发进一步说明此处的机制与边界。

事件存储与消息代理侧重不同进一步说明此处的机制与边界。

原书依据 · 3 处
3.4.3 异步通信模式

本节引入两种不同消息分配方式:竞争工作者分担一个任务,与多个用途分别消费同一事实。下面逐项展开,不把二者都笼统称作“异步”而忽略消费责任。

1.作业队列

作业队列把较复杂工作从触发时机中分离,多个market网关实例竞争处理订单事件。图3.12的一次消费是分配意图,不是发生故障后业务恰好一次的证明;确认、重发和幂等仍需具体协议。Redis或SQL等可作队列实现基础,此处未展开一致性保证。

作业队列让消费者分担任务进一步说明此处的机制与边界。

原书依据 · 1 处
2.发布-订阅

发布订阅把同一事实交给通知、统计、推荐等多个独立用途,生产方不必逐一调用。它与工作者竞争不同:每个订阅责任都要响应,而一个订阅内部可以另有多个实例分担。

发布订阅让各用途响应同一事实进一步说明此处的机制与边界。

原书依据 · 1 处
3.4.4 服务定位

发现把稳定名称或注册信息映射到实例。图3.14示范DNS/负载均衡,图3.15示范注册查询后调用。多版本、跨机房等需求提高拓扑复杂度,注册中心不是无条件最优,实例健康和失效注册仍需管理。

服务发现把名称解析为可用实例进一步说明此处的机制与边界。

注册中心集中提供实例位置进一步说明此处的机制与边界。

原书依据 · 2 处

3.5 服务边界

边界隐藏内部协作并适配消费者传输和数据,例如外部HTTP对接内部gRPC。图3.18说明业务领域内部也可以设边界。认证授权、限流、缓存、日志和指标可在边缘统一,但领域正确性责任不能简单移除或全塞进网关。

边界隐藏内部变化并适配客户端进一步说明此处的机制与边界。

边缘能力集中不替代领域规则进一步说明此处的机制与边界。

原书依据 · 2 处
3.5.1 API网关

网关提供统一入口,执行认证、路由和响应转换,并可配合受限网络缩小后端暴露面。聚合多个结果时需控制业务逻辑渗入;API组合与服务层聚合的边界若失守,会使网关难以独立变化。

网关入口配合限制后端暴露进一步说明此处的机制与边界。

原书依据 · 1 处
3.5.2 服务于前端的后端

BFF为不同客户端提供专门入口。图3.20分别画出管理、投资网站、iOS和Android网关,使数据体量与功能差异不再挤在单一接口上。专门化也要维护多个入口及共同安全运行约定,不重复搬运核心业务。

按客户端分设后端门面进一步说明此处的机制与边界。

原书依据 · 1 处
3.5.3 消费者驱动网关

消费者驱动网关允许客户端指定公开类型内所需字段,并由后台组合订单、持仓等资源。代码清单3.1的Account关联Order和Holding,二者引用Asset;这是响应结构而非共享数据库。清单3.2只写对象列表字段而没有子字段,不应照抄;2026-10-27对照GraphQL官方校验说明,对象字段须继续选到标量/枚举叶字段。原SDL的schema: {也不是可照搬的规范定义,本次不把原代码当已执行服务器。

查询语言让消费者选择响应字段进一步说明此处的机制与边界。

对象查询须选到叶字段进一步说明此处的机制与边界。

账户查询结构组合订单持仓进一步说明此处的机制与边界。

原书依据 · 3 处

3.6 客户端

客户端层为不同设备与受众提供界面,可独立于后端演化。用户工作常横跨订单、账户、税务等多种服务,故不要求每个服务都自带唯一界面;认证审计等横向需求也要有合适边界。

3.6.1 前端单体

图3.21显示后端已拆分而前端仍统一打包部署,可能让前端团队成为业务交付共同等待点。端到端所有权应检查界面与后台的整条路径。

前端单体仍会限制端到端交付进一步说明此处的机制与边界。

原书依据 · 1 处
3.6.2 微前端

微前端通过独立打包部署的界面片段组合页面,配合共享导航与组件,有利于业务团队端到端交付。视觉交互一致性、多源脚本体积、加载与重绘都是成本。Web组件、客户端包含、iframe与ESI只是不同组合途径,不能据出版语境中的“新趋势”断言当前采用程度。

微前端组合独立界面片段进一步说明此处的机制与边界。

原书依据 · 1 处

3.7 小结

本章收束四层职责、指导演化的架构准则、同步异步及消费分配、边界三种模式和客户端拆分。重点是全局可演进,而不是强制所有应用选择某一种网关或消息工具。短链接仅作原书阅读线索,未访问则不据其添加结论。

第4章 新功能设计

本章把服务划界视为持续决策:何时新建、何时扩展、如何协作。过细导致紧耦合,过大导致低内聚,初期合适也可能后来失效。目标是单一职责、独立部署、可替换,同时考虑多团队依赖而非假定一个团队掌控全部服务。

4.1 SimpleBank的新功能

新需求是由预设策略代替客户自行选资产。设计依次理解问题与用例、识别实体能力、划服务,再据需求验证。图4.1区分制定策略、开户选策略和按策略投资。这里只分析软件职责,不对投资风险或收益给现实建议;市场调研、访谈、影响地图和BDD为方法线索。

从问题到用例再验证服务边界进一步说明此处的机制与边界。

原书依据 · 1 处

4.2 按业务能力划分

service scoping确定服务范围,可按业务能力与上下文、用例、易变性三个方向综合观察。它们不是互斥标签:能力给内聚责任,用例给跨域动作,易变性检查未来影响。

服务划界组合三种观察角度进一步说明此处的机制与边界。

原书依据 · 1 处
4.2.1 能力和领域建模

业务能力直接表达组织创造价值的工作。DDD将业务理解建成共享、不断演进的模型;限界上下文让内部模型语义一致、外部边界明确。初期一个上下文可对应一个服务,后来内部可拆多服务,仍以稳定外观对外。这是分析边界,不是强制一上下文一进程。

限界上下文统一局部模型含义进一步说明此处的机制与边界。

领域驱动设计维护共享业务模型进一步说明此处的机制与边界。

原书依据 · 2 处
4.2.2 创建投资策略

创建策略页面依赖用户管理和资产信息,但策略本身具有独立责任。资产在策略、订单、基础信息上下文中有不同角色。代码清单4.1⁄4.2用OpenAPI 3.0.0描述创建与读取,NewInvestmentStrategy包含名称和分配,InvestmentStrategy再组合ID、创建人和时间。allOf是约束组合,不能直接画成继承;required和float也不证明比例总和、授权或精度正确。创建成功发StrategyCreated,可让通知自行订阅。两段覆盖还结合图4.7把用户界面、资产搜索、用户信息与策略边界逐项对应。

相同实体在上下文中角色不同进一步说明此处的机制与边界。

投资策略能力不属于账户订单进一步说明此处的机制与边界。

策略接口分开创建输入与结果进一步说明此处的机制与边界。

用接口和事件界定服务契约进一步说明此处的机制与边界。

原书依据 · 4 处
4.2.3 内嵌型上下文和服务

资产上下文对外公开获取与查询,内部包含报价、评级和分析等子责任。先区别公开和私有,后续再拆内部独立变化部分,为演化留接缝而不预先建所有服务。

内部边界为未来拆分留接缝进一步说明此处的机制与边界。

原书依据 · 1 处
4.2.4 挑战和不足

能力划分直接映射业务运营,通常有助于稳定边界,但并非完美。下一节说明领域知识不足和职责持续增长两类缺陷,不把业务名称本身当边界正确的证据。

1.需要大量的业务知识

业务知识需要调查与迭代,初始假设错误会使数据和功能迁移代价增大。此处进一步支撑第1章边界错误昂贵的判断,不再重复建卡。

2.粗粒度服务不断发展

粗粒度服务会随业务深度增加而出现新的变化原因。不能总以省事为由把功能塞进旧服务,应持续观察内聚与替换成本,在证据明确时拆分以控制技术债。

持续增长会改变最初服务职责进一步说明此处的机制与边界。

原书依据 · 1 处

4.3 按用例划分

按用例建立动词服务,适合不自然归属某一实体、跨多个领域或本身很复杂的动作。它与粗粒度业务能力互补,不是把所有命令拆成一层远程包装。

用例服务封装复杂跨域动作进一步说明此处的机制与边界。

原书依据 · 1 处
4.3.1 按投资策略下单

PlaceStrategyOrder以账户、策略和金额生成多笔订单。外部支付异步完成,因而请求需关联paymentId,支付能力独立收款并发PaymentCompleted,用例再查询策略、生成订单并调用统一订单能力。图4.11⁄4.13明确先等支付;未给事件去重、到账权威校验和资金冻结算法,所以只保留有证据的等待方案,不补造并发问题。用例保存请求及订单ID,订单服务拥有生命周期并发完成事件更新整体投资状态。接口中number/decimal只是草图,不能据此证明金额精度。

支付完成后才生成策略订单进一步说明此处的机制与边界。

策略下单与收款分别拥有职责进一步说明此处的机制与边界。

用例记录关联并追踪整体结果进一步说明此处的机制与边界。

原书依据 · 3 处
4.3.2 动作和存储

更新、取消等动作共享订单状态,仍需订单能力作为权威所有者。简洁架构的实体、用例、适配器区分业务与实现,但不能照同心圆拆成一批远程贫血服务。应先建立内聚能力,再封装动作,避免额外调用链和共同部署。六角架构这里只为相关线索,原文明示并不完全相同。

动作共用实体仍需权威所有者进一步说明此处的机制与边界。

实体用例适配器隔离实现细节进一步说明此处的机制与边界。

原书依据 · 2 处
4.3.3 编配与编排

用例服务可在职责链中同时发命令和响应事件:策略下单响应支付完成,主动创建订单,再接收订单完成。要以责任判断混合协作,不为追求纯事件而模糊流程,也不让协调者吞下全部下游责任。

用例可同时命令和响应事件进一步说明此处的机制与边界。

原书依据 · 1 处

4.4 按易变性划分

按易变性隔离未来变化:市场适配可随不同交易接口分化,策略优化可与策略定义分开。稳定依赖指导把不确定性包在清楚契约后。预测所有需求会过度设计,YAGNI要求延迟缺少依据的承诺;要在可塑性与当前成本间平衡。

隔离独立变化限制影响范围进一步说明此处的机制与边界。

稳定依赖约束变化传播进一步说明此处的机制与边界。

未来可塑性与不过度设计平衡进一步说明此处的机制与边界。

原书依据 · 3 处

4.5 按技术能力划分

技术能力间接支持业务,例如第三方集成和通知。它不是按技术层随意远程拆分,下一节通过支付通知解释其是否独立变化及可共享。

4.5.1 发送通知

支付不该额外拥有客户偏好、联系方式和所有通知渠道。独立通知订阅支付、订单等事件,可按邮件短信推送分别投递;如果内容生成继续增长,可再分离内容与发送。当前数据存放可在客户能力或通知方,原书并未给唯一方案。

通知能力独立于支付处理进一步说明此处的机制与边界。

原书依据 · 1 处
4.5.2 何时使用技术能力

技术服务值得拆分的条件是复用、独立变化或降低业务服务复杂度。反例是按展示、逻辑、数据访问等层横拆,使一次业务变更协调多个发布单元,形成分布式单体。图4.19⁄4.20对照不同部署路径。

技术服务拆分须保留自治进一步说明此处的机制与边界。

原书依据 · 1 处

4.6 处理不确定性

领域知识不完整与未来使用方式不确定,使划界无法一次正确。迭代与精益流程帮助保留灵活性,不意味着可以跳过实际业务调查。后续通过较粗边界、内部模块与有序迁移降低错误承诺成本。

4.6.1 从粗粒度服务开始

边界不明时可先较粗,减少跨服务依赖和公共接口改动,给领域认知更多时间。服务大也有代价,需观察复杂度并及时拆分;它是尽可能晚做昂贵决策,不是为永久单体找理由。该段补充既有“先保留内聚再逐步细拆”卡的适用边界。

4.6.2 准备进一步分解

类、命名空间和库可体现潜在内部领域边界,清楚API减少未来重构成本。远程化还要重新考虑失败和粒度,本地接口不能原样升为服务契约。

模块接口先为本地调整服务进一步说明此处的机制与边界。

原书依据 · 1 处
4.6.3 下线和迁移

扩展—迁移—收缩依次增加新能力,迁移消费者及数据,再移除过时实现。图4.22明确网关路由、其他服务调用和已有数据都需考虑。其他团队有自身优先级,迁移要有收益或协助,不能以通知替代完成;示意步骤不证明真实迁移完全无风险。

扩展迁移收缩有序替换服务进一步说明此处的机制与边界。

迁移消费者需要处理团队激励进一步说明此处的机制与边界。

原书依据 · 2 处

4.7 组织中的服务所有权

按上下文分团队有助所有权清晰,也降低消费方对依赖接口性能与节奏的直接控制。开放代码知识、明确契约和运行期望、适度放宽DRY能缓解等待;开放不等于无权限边界,受控重复也不等于复制权威业务状态。

所有权拆分降低直接控制能力进一步说明此处的机制与边界。

共享代码知识减少团队阻碍进一步说明此处的机制与边界。

避免复用绑死团队发布节奏进一步说明此处的机制与边界。

原书依据 · 3 处

4.8 小结

全章以业务问题→实体用例→职责为主线,综合能力、用例、变化与技术能力划分。边界不确定时先模块化再逐步拆,迁移需处理消费者和团队。脚注将DDD分析技术与面向对象实现区分,Clean Architecture与六角架构也不完全相同。

第5章 微服务的事务与查询

单体可能在一个数据库事务中改订单、持仓和手续费;微服务数据分属不同所有者,使业务写一致性与跨域读关联同时变难。本章先处理失败后的部分成功与Saga,再处理API组合、事件副本和CQRS,最后连接分析报表。

5.1 分布式应用的事务一致性

出售股票时,订单创建和持仓预留可能已提交,收费却失败,局部事务不会把其他服务状态自动撤回。原文要求订单流程指示取消预留,后文把这类修正归为业务补偿。原文“同一份股票连续买两次”在上下文实际指重复出售,不沿用该笔误。

收费失败留下订单和持仓占用进一步说明此处的机制与边界。

撤销预留修复收费失败进一步说明此处的机制与边界。

原书依据 · 2 处
为什么不要使用分布式事务

2PC先收集准备结果,再做提交或撤销决定。它增加参与方可用要求和准备态资源占用,但准备后失联不能一概自动回滚;隔离也不由提交协议名称单独提供。2026-10-27已对照PostgreSQL官方两阶段事务说明核对准备态可持续的边界。原书可靠性乘积仍是有条件简化模型,不作为通用公式。

两阶段提交协调共同决定进一步说明此处的机制与边界。

长事务持锁增加资源等待进一步说明此处的机制与边界。

原书依据 · 2 处

5.2 基于事件的通信

多个本地事务形成复合业务结果,需为资源明确暂时状态和失败去向。同步订单流程由订单服务掌握调用顺序与修正责任,较容易顺着代码解释,却增加中心职责与依赖。最终一致性不能省去收敛与恢复协议。

最终一致性需要明确中间态进一步说明此处的机制与边界。

原书依据 · 1 处
事件和编排

本章事件方案为OrderRequested→OrderCreated,再由账户和费用分别处理。市场需等StockReserved与FeeCharged两个前提才提交,并发OrderPlaced。这里收费发生在市场提交前,与第2章提交后收费的方案不同,须作为不同教学设计看待。ChargeFailed可触发取消。单体发事件、新服务消费亦可支持渐进扩展,但可靠发布与业务去重仍未在此解决。

市场提交等待两个业务前提进一步说明此处的机制与边界。

单体发事件支持渐进扩展进一步说明此处的机制与边界。

原书依据 · 2 处

5.3 Saga

Saga由各自原子的本地事务组成,整体不是ACID原子事务,失败靠业务补偿达到允许状态。咖啡重做或退款说明不同失败有不同修正,补偿并不抹除历史。Saga原论文、分布式事务之外的业务语义及咖啡补偿来源另登记。

Saga组合本地事务与补偿进一步说明此处的机制与边界。

补偿恢复业务含义而非原状态进一步说明此处的机制与边界。

原书依据 · 3 处
5.3.1 编排型Saga

编排式Saga把创建、预留、收费、市场提交、状态更新分给参与方。市场失败发OrderFailed,订单取消、释放持仓和退费作为补偿;邮件已发无法撤回,只能更正通知。动作编号及“购买”用词在原图/正文有不一致,笔记按服务职责说明,不把编号当协议。补偿不等于各方同时回到从未发生的状态。

市场提交失败留下已收费状态进一步说明此处的机制与边界。

失败事件触发退费与释放进一步说明此处的机制与边界。

原书依据 · 2 处
优势和不足

完整过程分散到多个服务,需要记录中间状态并关联事件,验证和测试也分散。双向消费可能形成契约与发布依赖,并非不存在耦合。长流程的范围、阶段和补偿顺序更需可追踪历史,观测相当于事后调查的飞行记录仪。

无中心流程增加状态追踪成本进一步说明此处的机制与边界。

原书依据 · 1 处
5.3.2 编配型Saga

编配型Saga由协调器跟踪每一步与补偿结果,Saga日志使其表现为可解释的状态机。交互可请求响应也可异步。补偿本身或协调器也会失败,需安全重试、异常监控并允许人工介入;退款未必即时,书中一周不作当前到账承诺。

协调型Saga记录每步执行状态进一步说明此处的机制与边界。

补偿进度不等于即时到账进一步说明此处的机制与边界。

补偿重试可能重复退费进一步说明此处的机制与边界。

让补偿具备安全重试语义进一步说明此处的机制与边界。

原书依据 · 4 处
优势和不足

集中顺序便于理解进度和修改流程,也可能让协调器吞下领域规则、把参与方架空。协调器应专注工作流,各能力仍保留业务行为。WS-BPEL、Conductor和原文Step Workflows只是历史工具线索,不据其断定现行命名与流行程度。

协调器集中顺序但可能架空服务进一步说明此处的机制与边界。

原书依据 · 1 处
5.3.3 交织型Saga

Saga缺少整体隔离,已提交局部结果会影响其他流程。下单未提交市场时又取消,可使两条Saga交织,需要明确拒绝新流程、实体锁或中断策略,不能只验证每条流程单独运行的路径。

取消与下单流程可能交织进一步说明此处的机制与边界。

原书依据 · 1 处
1.短路

短路在已有Saga期间拒绝冲突操作,例如等待提交后再取消。实现简单,但限制用户操作时机,须是公开的业务选择。

拒绝交织可简化Saga语义进一步说明此处的机制与边界。

原书依据 · 1 处
2.加锁

实体锁或股票预留可限制并行修改,但多个Saga相互等待资源会死锁。需要监控和超时处置,并在决定中断时处理资源与业务状态;超时不自行证明死锁,也不自行完成补偿。

预留持仓防止重复出售在此补充适用条件。

预留和锁限制并行实体修改进一步说明此处的机制与边界。

并行Saga争锁可能死锁进一步说明此处的机制与边界。

监控和超时处置Saga等待进一步说明此处的机制与边界。

原书依据 · 5 处
3.中断

中断方式先把订单标失败,市场处理提交消息时重新核验最新状态。它避免单靠锁等待,却增加业务状态判断。原文没有把复查到外部提交做成原子协议,因此仍需指出检查后状态变化的窗口。

提交前复查订单取消状态进一步说明此处的机制与边界。

原书依据 · 1 处
5.3.4 一致性模式

一致性策略包括补偿、重试、忽略、重启和先临时操作后确认取消。选择依据业务含义与允许风险;大量数据中的可容忍失败不能直接搬到资金业务。持仓预留为临时操作示例,沿用已有卡而不再复制同一方案。

按业务含义选择一致性策略进一步说明此处的机制与边界。

原书依据 · 1 处
5.3.5 事件溯源

事件溯源以历史变化重建实体状态,解释“怎样来到当前”,区别于存最新状态再另发消息。按字段跨实体查询常需投影,但微服务不必须使用事件溯源,事件溯源也不必被解释为强制独立部署CQRS。原图Order字样及事件时间仅作教学,不当真实订单记录。

事件历史重建实体状态进一步说明此处的机制与边界。

事件溯源与查询投影可以分工进一步说明此处的机制与边界。

原书依据 · 2 处

5.4 分布式世界中的查询操作

API组合用关联ID把客户和订单服务数据在应用层连接。逐客户查询形成N次调用,分页客户加批量订单可减少往返,但大子集仍需限制。报表和跨域复杂聚合往往不适合临时API join。原文99%^3的精确值为97.0299%,且乘法需失效独立等模型条件,不能直接当生产可用率。

API组合适合有限数据关联进一步说明此处的机制与边界。

分页批量减少逐项远程调用进一步说明此处的机制与边界。

原书依据 · 2 处
5.4.1 保存数据副本

事件携带必要数据,消费方保存副本可少回查,但需处理延迟、失败、重复、格式耦合与陈旧。是否可用旧状态取决于操作含义,CAP只在分区条件下约束某些保证,不是永远二选一。原书离线ATM历史例子展示无法获知全局余额时用限额限制风险,未转写为当前所有ATM支持或银行收费政策;Brewer2012论文作为生成时核验依据。

事件副本减少查询依赖进一步说明此处的机制与边界。

分区取舍应细到具体操作进一步说明此处的机制与边界。

离线提款可能超出账户余额进一步说明此处的机制与边界。

离线限额控制透支风险进一步说明此处的机制与边界。

原书依据 · 4 处
5.4.2 查询和命令分离

CQRS明确分开命令与查询职责,写模型服务规则,读模型服务访问形态,可采用不同结构或数据库。框架列表只登记,不能凭框架名替代投影设计。

CQRS分开更新与查询模型进一步说明此处的机制与边界。

原书依据 · 1 处
CQRS架构

图5.17由命令更新并发事件,处理器维护读模型;可在单服务内或应用全局实施。图5.18的CustomerOrder聚合订单、费用与客户事件,支持任何单源无法独立完成的分类查询。专门读服务拥有查询副本,不取代源数据的写权威;不是所有场景都必须CQRS。

事件处理器维护专门读模型进一步说明此处的机制与边界。

复合查询服务汇合多个领域进一步说明此处的机制与边界。

原书依据 · 2 处
5.4.3 CQRS挑战

命令已确认而投影尚未更新,立刻查询会读到旧数据,甚至查不到新订单。这个复制延迟窗口需要界面与协议明确,不能把旧读直接当成写入失败。三种策略分别是预期展示、等待版本和订阅读更新。

写入确认可能早于查询可见进一步说明此处的机制与边界。

原书依据 · 1 处
1.乐观更新

乐观界面在能推导结果时先展示,服务失败再撤回,适合点赞等简单操作。它不能替代服务器校验,复杂计算或未知结果不宜假装成功。

乐观界面先展示预期结果进一步说明此处的机制与边界。

原书依据 · 1 处
2.轮询

轮询用可比较的进度或版本等待读模型追到本次变更。版本需与实际处理顺序相关,任意客户端时间戳不足以证明这一点;还应有等待预算和异常呈现。

按进度版本等待读模型追平进一步说明此处的机制与边界。

原书依据 · 1 处
3.发布-订阅

发布订阅策略监听读模型更新,收到相应完成通知后刷新,可减少反复查询。通知必须来自实际投影完成而非仅命令受理;断线漏消息的恢复仍需补充设计。

由读模型更新通知驱动界面进一步说明此处的机制与边界。

原书依据 · 1 处
5.4.4 分析和报表

把微服务事件映射并合并入仓库支持分析报表,原始事件也可先归档再重处理。Redshift、BigQuery、S3、Spark和Presto在此说明目标种类,未经本轮核验不比较当前产品功能与价格。

事件流为分析构建独立数据集进一步说明此处的机制与边界。

原书依据 · 1 处

5.5 延伸阅读

推荐三本围绕响应式应用、微服务模式和事件流的延伸书,未实质介绍各书论证,不额外生知识卡,登记便于检索。

5.6 小结

全章把事务跨服务后的部分成功、Saga补偿与隔离挑战连接到查询分工。原书偏向可用性是其设计取向,不是任何资金操作的强制结论。脚注原论文及资源分别登记,事件溯源“必须CQRS”的绝对句已按正文可在服务内应用的范围限定。

Saga组合本地事务与补偿在此补充适用条件。

原书依据 · 2 处

第6章 设计高可靠服务

本章将不可避免的故障转化为设计目标:尽量减少故障、限制扩散并快速恢复。硬件、部署、负载、网络与人为变更都可能出错,不能只关注代码正确。之后从指标与风险进入重试后备超时熔断,再讨论健康、限流、验证和统一通信。原书S3事故为历史背景,不当本周新闻。

6.1 可靠性定义

可用性必须附时间或请求口径,几个九不是普适门槛。六个独立且必要组件各0.999成功时,乘积0.999^6约99.4015%,不是失败率;实际共同故障、冗余和降级会改变模型,不能称通用最大可用性。目标是防故障、限扩散、快恢复,并据指标约束设计。

可用性必须固定测量口径进一步说明此处的机制与边界。

依赖乘积模型需要独立假设进一步说明此处的机制与边界。

原书依据 · 2 处

6.2 哪些会出错

按频率、影响、客户需求和成本排序恢复投入。跨区跨云可应对一些失效,也带来维护复杂性。原书罕见与频繁评价不是本环境统计,不能照搬为容量或经济决策结论。

按风险影响排序恢复投入进一步说明此处的机制与边界。

原书依据 · 1 处
6.2.1 故障源

市场数据服务连接主机、数据库、外部信息源、上游和下游。每个交互点都可能失效,用硬件、通信、依赖、内部四类检查盲区,但它们可能互相叠加。

沿四类交互识别故障源进一步说明此处的机制与边界。

原书依据 · 1 处
1.硬件故障

主机机房、配置、网络、OS或隔离设施可能共同影响多个实例。冗余需跨实际故障域,成本则包括通信、配置与运维。书中云区域定义只保留案例用途,实际部署需核对拓扑。

冗余应跨实际故障范围进一步说明此处的机制与边界。

原书依据 · 1 处
2.通信故障

DNS、防火墙和传输故障可能使健康进程无法被访问,配置变更也是触发路径。验证并能回滚配置有助减少影响,不把所有网络错误都归因人为。

配置变更也要验证与回滚进一步说明此处的机制与边界。

原书依据 · 1 处
3.依赖故障

依赖故障包括超时、数据库容量或故障、第三方不符预期,以及不兼容接口修改和未经迁移下线。它们说明可用进程并不等于可用契约。

接口下线也是依赖故障进一步说明此处的机制与边界。

原书依据 · 1 处
4.服务实践

设计差、测试不足、不可靠部署、监控缺口和资源饱和都可能让服务失效。此处补充研发与运行闭环,不重复建卡;每个服务质量都会影响完整功能。

6.2.2 连锁故障

图6.5—6.9从1000QPS分给两实例,各500QPS,演示故障后全部压到一实例,再被重试放大。排队变慢引发更多重试,等待又耗尽上游,正反馈最终扩散。图中数值只是教学模型,未进行压测。

重试正反馈放大局部过载进一步说明此处的机制与边界。

原书依据 · 1 处

6.3 设计可靠的通信方案

holding的GET /holdings调用market-data价格接口,用两个容器演示重试、后备、超时和断路器。docker-compose up为历史配套运行入口,本次未运行容器或声称示例已通过;先讲机制再看代码边界。

6.3.1 重试

重试要辨认暂时/持续错误、操作重复安全性、次数与总预算。指数退避给下游恢复时间,抖动减少客户端同步波峰。Tenacity装饰器示例缺导入名,_make_request未检查HTTP失败状态,JSON解析不能证明调用成功;attempt含首次尝试,stop_after_delay也不保证打断永久阻塞调用。幂等并非无副作用,幂等键亦非无条件恰好一次。2026-10-27已对照Tenacity和Requests官方资料核对这些API边界,未运行原程序。

重试先判断操作是否重复安全进一步说明此处的机制与边界。

重试需要次数与时间预算进一步说明此处的机制与边界。

指数退避加抖动分散重试进一步说明此处的机制与边界。

重试库组合停止等待与日志进一步说明此处的机制与边界。

客户端集中远程访问适配进一步说明此处的机制与边界。

原书依据 · 5 处
6.3.2 后备方案

四种后备策略是优雅降级、缓存、功能冗余和桩数据,它们适用的业务语义不同。下列各节分别展开,不能仅为了接口返回成功而随意替换真实数据。

1.优雅降级

价格不可得时可保留股份数量并明确估值缺失,不让整个页面失效。该降级是展示层允许的业务取舍,不能拿缺失或默认估值支持交易。

降级保留可独立提供的功能进一步说明此处的机制与边界。

原书依据 · 1 处
2.缓存

缓存减少回源并在有效期内缓解临时故障,五分钟只是本例允许陈旧的假设。cachetools TTLCache装饰读取方法,代码是进程内缓存,不自动多实例共享也未提供并发同步;外部缓存可共享,却增加新依赖。到期与故障下能否读旧值仍需明确。

缓存以陈旧窗口换读取依赖进一步说明此处的机制与边界。

TTL缓存装饰重复读取方法进一步说明此处的机制与边界。

原书依据 · 2 处
3.功能冗余

功能冗余让价格源A失败时改用B,但数据覆盖、成本和业务含义要等价,网络共同故障可能让备用同样失效。它不是任意第二个地址都能接替的机制。

后备服务需避开共同故障进一步说明此处的机制与边界。

原书依据 · 1 处
4.桩数据

推荐失败时返回非个性化默认内容可以保留用途,价格展示则不适合虚构桩值。后备结果必须保持可解释的业务含义。

默认桩数据只适合允许替代的用途进一步说明此处的机制与边界。

原书依据 · 1 处
6.3.3 超时

单次读取超时限制无字节等待,不是整个请求总时间;2026-10-27对照Requests官方说明核对。端到端期限还应覆盖连接、处理、重试和返回,把剩余预算传下游避免上游放弃后仍做无用功。X-Deadline示例未定单位或时间基准,不能直接当互通规范。

读取超时不是整次请求期限进一步说明此处的机制与边界。

传播剩余期限减少无用等待进一步说明此处的机制与边界。

原书依据 · 2 处
6.3.4 断路器

断路器正常闭合;失败在窗口达到阈值则断开,快速失败或走后备;等待后有限探测进入半开,成功恢复,失败回断开。窗口和最小样本影响统计可靠性,低流量不宜凭少量失败率决策;还应监控反复断开。它与超时、退避分别承担不同责任,不能替代容量治理。

断路器用快速失败隔离坏依赖进一步说明此处的机制与边界。

半开探测决定是否恢复调用进一步说明此处的机制与边界。

熔断统计需要样本与窗口进一步说明此处的机制与边界。

原书依据 · 3 处
6.3.5 异步通信

不要求即时结果时,代理队列可减少直接同步依赖并缓冲处理,但增加状态与设施运维责任。队列也可能故障,异步不等于不需要可靠发布、去重或追踪。机制已并入此前事件中枢与Saga卡。

6.4 最大限度地提高服务可靠性

从依赖防御转向单服务自身:健康检查帮助路由、限流保护容量,压力和混沌实验检验恢复假设。它是下列机制的导入,不单独生卡。

6.4.1 负载均衡与服务健康

健康检查区分进程仍活与业务准备好接请求,Flask /ping只示范最简单存活。检查结果的重启或摘流量动作取决于平台约定;二值OK也不能表现慢响应或负载变化,需要延迟和资源指标辅助路由。

存活与就绪回答不同问题进一步说明此处的机制与边界。

二值健康无法描述全部负载进一步说明此处的机制与边界。

原书依据 · 2 处
6.4.2 限流

限流可按容量、客户端或端点优先级拒绝请求,背压再把剩余额度反馈给上游以调整速率。窗口速率与同时在途并发要分清,原表把“限制并行”解释成一段时间请求量的措辞不能直接照搬。报头反馈也需约定且被遵守。

限流按容量和优先级分配请求进一步说明此处的机制与边界。

背压把下游余量反馈给上游进一步说明此处的机制与边界。

原书依据 · 2 处
6.4.3 验证可靠性和容错性

恢复设计不等于实际有效,压力测试检验负载边界,混沌实验检验故障响应,二者与单元验收测试观察对象不同。后续计划只能描述预期与方法,本轮并未执行。

1.压力测试

表6.5用总用户、活跃率和0.5请求/秒估算400平均与1400峰值QPS,并按40%月增长推算。估算不是容量实测,应经单服务和联合链路压力验证,再据业务指标修正。不同端点、数据和配置的负载边界不能通用。

容量估算随业务流量修正进一步说明此处的机制与边界。

单服务与链路压力测试互补进一步说明此处的机制与边界。

原书依据 · 2 处
2.混沌测试

定义稳态、提出故障下仍稳定的假设、注入现实失效并尝试推翻。图6.19给实例下线、容量缩减、网络异常等变量。原文也建议从小受限和定期实验开始,并评估预发布与生产等价性;不是未经授权直接动生产的行动指令。

混沌实验尝试推翻恢复假设进一步说明此处的机制与边界。

原书依据 · 1 处

6.5 默认安全

新增下游依赖或上游消费者会改变失败面与容量压力,不宜写成任何拓扑改变必然变坏。框架/代理把防御性通信变为默认路径,使跨团队实践更一致,但具体业务仍决定哪些请求能重试和降级。

让正确通信成为默认路径进一步说明此处的机制与边界。

原书依据 · 1 处
6.5.1 框架

统一通信库可复用重试熔断、指标并使远程调用可见,少数语言时较易实施;各运行服务仍需兼容升级,不能把类库修复等同全体实例已生效。

共享通信库统一调用策略进一步说明此处的机制与边界。

原书依据 · 1 处
6.5.2 服务网格

服务网格把实际通信放在配套代理中,按策略管理重试超时和路由,多语言可共享机制。图6.21区分逻辑直接调用与真实代理路径,减少重复实现也可能隐藏行为,因此配置、观测和业务幂等边界仍需清楚。Linkerd/Envoy为原书项目例子,不据本段断定当前完整产品能力。

服务网格把通信策略放到代理进一步说明此处的机制与边界。

原书依据 · 1 处

6.6 小结

全章收束风险模型、正反馈、重试后备期限熔断、健康限流、验证及统一默认。脚注对幂等的“无状态影响”说法过窄,已按重复效果说明;Hystrix停止维护为原书译注,未把它推广成当前推荐清单。引用资料分别登记,实践未执行。

第7章 构建可复用的微服务框架

团队可选择不同语言和工具,同时遵循日志、指标和通信等共同约定。服务底座把已解决的底层问题做成可访问工具,减少重复准备工作,不以强制单一语言换形式统一。

7.1 微服务底座

类库选择多会增加启动和试错成本,经过组织验证的框架与工具组合可复用经验。图7.1—7.3只是历史包搜索结果,不用其中数量或排名作当前推荐。底座应预置部署、日志、指标、通信和错误处理,但不代替业务生产验证。

底座复用组织已验证的经验进一步说明此处的机制与边界。

原书依据 · 1 处

7.2 微服务底座的目的

可预测结构降低新人和跨团队评审门槛,日志、配置、数据存储、健康和发现等约定可以跨语言一致。相同结构帮助理解,核心业务仍需专门设计。

统一运行约定不必统一语言进一步说明此处的机制与边界。

原书依据 · 1 处
7.2.1 降低风险

不断把团队验证过的经验和公共依赖知识放回底座,减少以后重复试错。模板更新和现有实例升级是两件事,不能因公共库已修复就宣称所有服务已生效。

把新发现反馈到底座降低重复风险进一步说明此处的机制与边界。

原书依据 · 1 处
7.2.2 快速启动

快速生成可部署原型降低试验成本,可以更早决定推进还是放弃;它不是承诺所有原型长期运行。熟悉每种语言的共同结构也方便成员跨项目贡献。

快速启动让原型更便于取舍进一步说明此处的机制与边界。

原书依据 · 1 处

7.3 设计服务底座

本章采用第2章下单原型:网关受理后,市场提交与手续费继续异步推进,收费又在提交后,与第5章等待收费前提的示例不同。图7.4先发OrderCreated再请求预留,未展示对市场消费的门槛,因此不能据原型证明预留必定先完成。Nameko提供通信HTTP测试机制,组织底座补指标、错误、功能标记和熔断,并用容器配置方便启动。

框架提供机制底座补齐组织约定进一步说明此处的机制与边界。

受理响应不能代表后台完成进一步说明此处的机制与边界。

原书依据 · 2 处
7.3.1 服务发现

Nameko用RabbitMQ的exchange、服务队列和reply队列承载请求响应,队列不意味着调用方不阻塞。RpcProxy按name定位响应服务,@rpc注册真实方法;事件则用来源服务名和事件名绑定处理器。图7.7实际显示四条事件队列加一条publisher RPC队列,正文“四队列”和注释错指另一个类不能照搬。框架简化路由,不自动解决超时或业务幂等。

消息代理也可承载请求响应进一步说明此处的机制与边界。

代理对象隐藏RPC传输细节进一步说明此处的机制与边界。

事件订阅按来源与事件名绑定进一步说明此处的机制与边界。

原书依据 · 3 处
7.3.2 可观测性

底座从一开始就接入指标、错误报告和日志,七项依赖中三项用于观测。setup.py的>=仅是版本下界,不能把它当固定可复现环境或现行推荐。

可观测性应进入服务初始结构进一步说明此处的机制与边界。

原书依据 · 1 处
1.度量指标

StatsD客户端采集并发送度量,代理聚合后交监控系统。书中Ruby8125脚本实际只收UDP并打印,图7.9仪表盘不能视为该脚本已实现完整后端。FeesService用StatsClient.timer包住charge_fee记录耗时,前缀提供服务范围;方法耗时与实际收费成功不同。图7.8输出是原书样例,本轮未发送指标。

指标计时连接方法与运行行为进一步说明此处的机制与边界。

指标代理与演示打印器有区别进一步说明此处的机制与边界。

原书依据 · 2 处
2.错误报告

错误报告器发送异常及堆栈等上下文,补充聚合指标。HttpDemoService的/broken故意抛异常,另外两个books处理器返回教学JSON,不是完整持久化API。图7.10为原书界面,本轮未触发错误、创建Sentry记录或配置外部服务。

异常报告保留错误上下文进一步说明此处的机制与边界。

HTTP处理器与错误报告协作进一步说明此处的机制与边界。

原书依据 · 2 处
3.日志

统一结构化日志有助跨服务查询,但共同host时间等字段仍不代替请求关联ID。Logger→StreamHandler→LogstashFormatterV1体现记录、输出、格式职责分离。清单7.7用=>是Ruby对象显示,不是合法JSON;代码也未给完整级别或集中后端配置。

日志格式化集中补齐通用字段进一步说明此处的机制与边界。

处理器和格式器分工输出日志进一步说明此处的机制与边界。

原书依据 · 2 处
7.3.3 平衡和限流

增加市场服务实例可分担慢外部工作,但需看真正瓶颈与积压。prefetch10是未确认窗口,不是十条固定批次;2026-10-27对照RabbitMQ官方资料更正。断路器统计异常类型须匹配Requests,原清单缺超时、HTTP失败检查且使用占位GET。30秒是其库示例默认而非所有熔断器常量。断路器不决定消息是否重入队,实际确认/错误处理与幂等协议仍需明确。

增加消费者扩容仍需检查瓶颈进一步说明此处的机制与边界。

预取限制未确认消息窗口进一步说明此处的机制与边界。

断路器异常分类须匹配客户端进一步说明此处的机制与边界。

队列积压不自动等于安全重试进一步说明此处的机制与边界。

原书依据 · 4 处

7.4 探索使用底座实现的特性

Compose把五个服务及RabbitMQ、Redis和示例StatsD代理连起,方便原型启动,印刷up–build不可当已核验命令照抄。本地siege演示HTTP成功率100%、42.24入口请求/秒,却还积压约3000条,说明受理不等于业务完成。本轮未运行容器或压测,原书数值不是本机结果。

入口压测成功不代表后台追平进一步说明此处的机制与边界。

原书依据 · 1 处

7.5 差异性是否是微服务的承诺

频繁使用的语言值得维护底座,选择自由仍以可管理运行能力为前提。底座的目标是帮助新服务启动,不是要求所有服务因一个功能集体升级;受控重复可换发布解耦,但不免除维护依赖安全修复。

底座应降低选择成本而非锁定团队进一步说明此处的机制与边界。

原书依据 · 1 处

7.6 小结

全章以经验复用和默认实践降低新服务成本,结合发现、事件/RPC、指标、错误、日志和消费扩展。功能原型的运行闭环比单纯生成代码更重要,尚不能以入口基准测试或框架存在当生产就绪证明。

第三部分 部署

第三部分把已设计的功能变成可重复发布的服务:先看生产平台与不可变打包,再看容器调度,最后把验证和发布串成流水线。云产品和命令是出版时的教学载体,本轮仅阅读,未登录云账号或创建资源。

第8章 微服务部署

本章把设计好的服务送入生产:先看平台与发布风险,再演示手工云部署的局限,转向工件打包、主机放置和渐进发布。云产品是出版时的例子,本次只读取,不操作账号、建资源或执行部署。

8.1 部署的重要性

发布需处理稳定性、构建发布耦合、接口兼容与下线。图8.1把多条代码发布线和运行服务连接,说明单服务独立不代表所有交付环节已经解耦;历史事故比例不当当前统计。

发布独立还要避免构建耦合进一步说明此处的机制与边界。

原书依据 · 1 处
稳定性和可用性

理想部署可预测且少事故。组件增加与发布变快使团队更需可靠流程,而不是简单减少所有变更。本段组织后续手工代价、小版本和自动化三点。

1.手工变更的管理代价昂贵

正式人工检验和审批旨在控制风险,但跨多个服务时容易使发布成本过高。本节是自动化动机,已并入研发发布标准化,不推断任何具体审核必应移除。

2.小版本发布降低风险和提高可预测性

小版本减少一次暴露范围并利于观察与修正,服务小不代表变更自动无缺陷。该理由补充既有小变更卡,不重复生成。

3.自动化推动部署节奏和一致性

自动化验证和上线使多个服务能重复采用同一质量流程,测试、集成和静态检查仍应有明确验证目标。本节进一步支撑持续交付卡。

8.2 微服务生产环境

部署包含交付流程与运行时架构。现有设施、能力和约束影响选择,不能只画服务器结构或只写上线脚本。下一节列共同运行责任。

8.2.1 微服务生产环境的特点

生产平台至少包含运行目标、运行时管理、日志监控、安全、路由、流水线。图8.2将控制、运行、观测及交付联系在一起,显示这是一套能力而非单一云产品。

生产平台组合六类运行责任进一步说明此处的机制与边界。

原书依据 · 1 处
8.2.2 自动化和速度

自动化与获取资源速度影响新服务成本。六周申请主机的例子说明交付迟滞;原书偏好公有IaaS只是其语境,不能代替具体组织评估。

资源交付速度影响服务拆分成本进一步说明此处的机制与边界。

原书依据 · 1 处

8.3 部署服务的快捷方式

GCE演示按项目组织资源,gcloud作为API客户端,原书提示创建与最终清理项目。命令存在印刷断词及旧选项,试用积分和免费政策也未当前核验,本次不当操作指南或现行报价。

项目边界集中管理演示资源进一步说明此处的机制与边界。

原书依据 · 1 处
8.3.1 服务启动

原书描述启动脚本安装系统、拉代码、装Python依赖并用supervisor/Gunicorn启动。本次只读书内说明,未取得并逐行核对配套脚本;后文用它说明每次启动构建的不可预测性。

启动脚本混合构建与运行工作进一步说明此处的机制与边界。

原书依据 · 1 处
8.3.2 配置虚拟机

单VM配置指定基础镜像、规格、脚本、区和标签,串口日志看启动,再设置防火墙测试/ping。RUNNING不等于应用可达,公开8080只为演示,不能原样称健壮生产方案。Debian9、g1-small等是历史参数,未执行。

实例运行和网络可达分开验证进一步说明此处的机制与边界。

原书依据 · 1 处
8.3.3 运行多个服务实例

先定义实例模板,再建立期望数量的托管组,配负载均衡形成逻辑服务。图8.5是无状态复制的典型结构,状态本身仍需处理。模板若每次拉最新代码,不保证副本同版。

模板实例组维护同类服务副本进一步说明此处的机制与边界。

以模板创建和调整服务组进一步说明此处的机制与边界。

原书依据 · 2 处
1.故障分区

三域放置可降低共同故障,但原文33%只对应理想实例比例;剩余容量不足会使业务影响扩散,不能以跨域数量证明可用性。

跨区实例仍需预留故障容量进一步说明此处的机制与边界。

原书依据 · 1 处
2.自愈

图8.7⁄8.8删除后触发重建,健康策略又将应用不响应纳入替换。创建健康对象还需绑定实例组。替换有启动窗口,探针可能误判,自愈不保证瞬时容量不变。

自愈恢复目标数仍有恢复窗口进一步说明此处的机制与边界。

健康检查策略绑定到实例组进一步说明此处的机制与边界。

原书依据 · 2 处
3.容量增加

resize手动改变目标副本数,指标规则可自动扩容。新实例就绪和下游瓶颈影响实际收益,扩容并不天然等同吞吐线性增长。

副本扩容还需指标与路由支撑进一步说明此处的机制与边界。

原书依据 · 1 处
8.3.4 添加负载均衡器

图8.9中外部地址→转发规则→HTTP代理→URL映射→后端→健康实例。原文命令缺显式实例组add-backend,不能把对象已建当路由全通;2026-10-27对照Google官方绑定说明核对。公网路径仅演示,未创建、访问或暴露服务。

负载均衡路由链需要后端绑定进一步说明此处的机制与边界。

先完整关联资源再验证入口进一步说明此处的机制与边界。

原书依据 · 2 处
8.3.5 开发者学到了什么

手动部署虽展示组、健康和路由,但启动时拉代码、装依赖使版本漂移、启动变慢,命令又未自动化。图8.10说明扩容时新实例可能取得另一提交,引出工件化。

启动时拉最新代码造成版本漂移进一步说明此处的机制与边界。

原书依据 · 1 处

8.4 构建服务工件

工件把某个版本构建成确定内容,存仓库再部署。它把构建移出每次开机;同提交必同包还需固定依赖和构建输入,不由名字自动保证。语言包、容器库或普通文件仓库是实现选择。

构建一次工件再部署多处进一步说明此处的机制与边界。

原书依据 · 1 处
8.4.1 工件的组成

打包需识别应用、类库、系统二进制、辅助进程与外部设施。图8.12区分内部执行环境和外部数据库服务,提醒语言依赖文件可能遗漏隐式系统要求。

工件边界需要覆盖隐式依赖进一步说明此处的机制与边界。

原书依据 · 1 处
8.4.2 不可变性

不可变工件让测试与生产复用相同内容,模板重建则减少服务器手改漂移。不可变、可重现构建和持久状态恢复是不同责任;替换实例不允许丢弃业务状态,补丁仍需及时进入新版本替换。

不可变工件减少隐含变更进一步说明此处的机制与边界。

替换主机减少配置漂移进一步说明此处的机制与边界。

原书依据 · 2 处
8.4.3 服务工件的类型

语言自带包往往只覆盖代码,未统一运行环境或隔离。下面比较OS软件包、虚拟机镜像和容器的封装边界,不以抽象更厚就断言无条件更好。

1.操作系统软件包

OS软件包借标准工具安装和声明依赖,却绑定目标系统并依赖宿主运行,还需仓库。apt/yum是包工具不是格式,图8.13比较三种封装范围,py2deb仅登记阅读线索。

系统软件包统一安装仍依赖宿主进一步说明此处的机制与边界。

原书依据 · 1 处
2.服务器镜像

VM镜像构建选基础、启动、配置并保存状态,Packer可自动化。示例commit用于镜像名和描述,未展示启动脚本实际checkout同提交,不能据标签证明可追溯。实例模板配置与磁盘镜像不是同一对象;云绑定、启动和快照成本是其取舍。未运行Packer。

虚拟机镜像固定更大执行环境进一步说明此处的机制与边界。

镜像标签需对应真实构建输入进一步说明此处的机制与边界。

原书依据 · 2 处
3.容器

Docker镜像共享内核、封装用户态依赖,运行兼容性仍受架构和内核约束。FROM/ADD/WORKDIR/RUN/CMD用于构建和启动;原书Gunicorn与-p用8080,EXPOSE及后文curl写8000,已明确按实际监听纠正。EXPOSE不自动发布端口,2026-10-27已对照Docker官方文档。Python3.6、旧GCR与gcloud docker仅作为历史示例,不声称支持或已推送。

容器镜像封装用户态运行依赖进一步说明此处的机制与边界。

镜像构建指令分离安装和启动进一步说明此处的机制与边界。

声明端口不等于发布端口进一步说明此处的机制与边界。

工件仓库存放可部署镜像进一步说明此处的机制与边界。

原书依据 · 4 处
8.4.4 配置

非敏感配置版本化,凭据受限存储,运行流程按环境注入。外部配置提高灵活性也带来可变输入,应可追踪版本,环境变量不自动保证秘密隐藏。原书“尽量包含配置”只适用于合适非敏感项,不能覆盖前面的凭据隔离要求。

运行配置与敏感凭据分开管理进一步说明此处的机制与边界。

环境无关工件仍需绑定配置版本进一步说明此处的机制与边界。

原书依据 · 2 处

8.5 服务与主机关系模型

放置模型比较一服务一主机、一主机多静态服务和调度化容器。观察对象是资源与发布责任的归属,而不是把服务数量当质量排名。

8.5.1 单服务主机

单服务主机边界直接,规格与启停好理解,但资源尺寸、主机获取和创建成本需维护。它不排除共同机房或依赖失效。

一服务一主机简化运行归属进一步说明此处的机制与边界。

原书依据 · 1 处
8.5.2 单主机多静态服务

静态共址可用有限机器,代价是依赖冲突、配置归属和资源争用;独立监控与扩容困难。共址并非逻辑上绝对不能独立发布,应看隔离和实际共享运行责任。

静态共用宿主增加运行耦合进一步说明此处的机制与边界。

原书依据 · 1 处
8.5.3 单主机多调度化服务

调度器接收副本与资源需求,在共享工作池放置容器并从工件库拉取内容,免除团队静态选主机。PaaS也提供主机抽象,但自动化与定制控制存在取舍。

调度器按资源需求放置容器进一步说明此处的机制与边界。

原书依据 · 1 处
1.调度模型的优点

动态调度按CPU内存等需求分配资源,服务团队与平台团队可分别关注应用和底层。调度的优化目标不等于任何负载都最佳;隔离也需正确配置。

2.复杂的容器调度器

复杂调度器需要维护或托管能力。若缺条件,一服务一主机配容器仍是可解释备用方案。原书对平台新旧的评价只保留历史背景。

调度平台收益取决于运维能力进一步说明此处的机制与边界。

原书依据 · 1 处

8.6 不停机部署服务

滚动发布逐步替换并保容量,金丝雀先有限曝光收反馈,蓝绿并行服务组后切流。三者都依赖就绪、路由、兼容与验证,不是用了命令即保证不停机,也不能称蓝绿永远优于金丝雀。

滚动发布在新旧共存中保容量进一步说明此处的机制与边界。

金丝雀先用有限流量获得反馈进一步说明此处的机制与边界。

蓝绿切换仍需处理状态兼容进一步说明此处的机制与边界。

原书依据 · 3 处
在GCE上进行金丝雀和滚动部署

历史GCE用新模板引入金丝雀、推广滚动、指定旧模板回退。图8.20展示先加后替换以保容量,但版本回退不撤销已写数据或外部效果,真实业务可能需额外补偿。beta命令未当前核验,未执行上线。

发布回退还要修复业务状态进一步说明此处的机制与边界。

模板版本驱动试点推广与回退进一步说明此处的机制与边界。

原书依据 · 2 处

8.7 小结

全章从生产平台职责走向工件可追溯,再比较放置与发布模型。底层添加删除实例可组合成高级发布,但安全依赖版本、流量和状态协议;金丝雀需代表性反馈,非单实例不报错就全量推广。

第9章 基于容器和调度器的部署

本章从镜像构建分发到Kubernetes部署。容器不是微服务必要条件,但可帮助速度与自动化。市场份额、Docker流行和rkt描述保留为出版背景,不当当前推荐;下文会标注过时API与示例错误,未运行集群。

9.1 服务容器化

代码先形成镜像并放仓库,部署清单再指示集群运行,工件可重复部署为多实例。图9.1将构建分发与期望状态分开,不能以本地镜像存在替代发布闭环。

9.1.1 镜像使用

镜像包含文件系统与启动元数据,可复用基础内容层;不是面向对象继承,也非每条指令都生成新文件层。pull/run/inspect/history分别获取执行与观察,python3.6和Jessie只作历史例子;inspect表达式.Config.Cmd不应含印刷空格。

镜像层复用共同构建内容进一步说明此处的机制与边界。

拉取运行与检查镜像分工进一步说明此处的机制与边界。

原书依据 · 2 处
9.1.2 构建镜像

三指令Dockerfile先加文件,还需安装依赖和CMD才能尝试运行。原例”-c “尾空格应改为独立参数”-c”,EXPOSE不发布端口。多阶段可分开构建与运行依赖;公共镜像需维护扫描,自建则增加成本,不把旧版本维护评价当当前安全保证。

先复制依赖启动才构成运行工件进一步说明此处的机制与边界。

构建环境可与运行镜像分开进一步说明此处的机制与边界。

基础镜像也需维护和核验进一步说明此处的机制与边界。

原书依据 · 3 处
9.1.3 运行容器

同一Docker网络的后端可按容器名访问,仅NGINX发布宿主80;upstream配置用8000,图9.4却写5000,应统一实际监听。卷挂载使nginx.conf在工件外可变,需追踪版本;命令长横线断词需核对。本次未运行容器。

容器内网络与宿主发布分开进一步说明此处的机制与边界。

网络代理配置与镜像分离进一步说明此处的机制与边界。

原书依据 · 2 处
9.1.4 镜像存储

仓库tag/login/push/pull组成跨环境分发,save归档为另一种搬运。latest可变,图9.6私有仓库记录只是原书截图,不是本轮推送。未登录外部服务或上传文件。

镜像分发先明确仓库与内容身份进一步说明此处的机制与边界。

原书依据 · 1 处

9.2 集群部署

调度接收声明、安排节点并让节点拉镜像运行,还需发现、凭据等平台能力。Minikube只为本地演示,控制面与工作负载可在同机,不据此推出真实生产拓扑。原书插件命令未当前验证。

9.2.1 pod的设计与运行

Pod是共同调度的一或多个关联容器,ReplicaSet观察比较并补足期望数量。更改RS模板不自动升级已有Pod;原extensions/v1beta1缺显式selector的清单不可按现行apps/v1直接执行。集群多Pod也不等于跨机房冗余。图9.8⁄9.9仅为原书输出,本轮未apply或delete。

Pod是共同调度的部署单元进一步说明此处的机制与边界。

控制器持续调和期望副本数进一步说明此处的机制与边界。

声明资源前核对API与选择器进一步说明此处的机制与边界。

原书依据 · 3 处
9.2.2 负载均衡

Service用标签选Pod并提供稳定访问入口,区分其选择流量与控制器管理归属。ClusterIP、NodePort、LoadBalancer对应不同入口;port与targetPort、nodePort分属不同层,图9.10标5000与清单8000不符,按实际后端统一。

服务按标签提供稳定访问进一步说明此处的机制与边界。

服务端口与节点入口层次不同进一步说明此处的机制与边界。

原书依据 · 2 处
9.2.3 快速揭秘

以下把看似单条kubectl指令拆成控制面、节点和状态通知的协作。图9.11是教学结构,不是具体代码类型图,也不要求一个主节点。

1.主节点的组件

API服务器开放资源接口,etcd持久集群状态,控制器调和,调度器选节点。职责分离意味着API受理后仍有多个阶段,不是直接运行应用。

控制面组件分别管理状态与决策进一步说明此处的机制与边界。

原书依据 · 1 处
2.工作节点组件

Kubelet观察本节点工作并驱动容器运行时,网络代理或相应实现处理服务流量。原书Docker只是当时示例,不能把现代Kubernetes运行时等同Docker;网络实现也可能替代kube-proxy。

节点代理落实容器运行状态进一步说明此处的机制与边界。

原书依据 · 1 处
3.监控状态变化

组件分别监听感兴趣的API资源,调度器观察未分配Pod,Kubelet观察已分配给自己节点的Pod,再各自更新状态。异步通知与调和形成整体,不靠API服务器同步指挥所有动作。

组件监听资源变化各自推进进一步说明此处的机制与边界。

原书依据 · 1 处
4.了解pod的运行

创建ReplicaSet先存资源,再由控制器建Pod,调度器分配,Kubelet拉镜像启动。前几步只更新期望与分配,真正程序最后才运行,排错应分阶段。此单元首次输出中间截断7个token后已单独完整补读。

资源创建与容器启动相隔多步进一步说明此处的机制与边界。

原书依据 · 1 处
9.2.4 健康检查

Kubelet执行探针并写就绪状态,Service根据共享状态筛选可接流量后端。存活失败触发容器重启,就绪失败主要影响流量资格;原书“五分钟未活就删Pod”把退避与删除混淆。readiness清单缺httpGet,更新RS模板也不自动更改现有Pod。2026-10-27已对照官方Pod/探针/RS文档核对,未在集群试跑。

探针失败动作由职责决定进一步说明此处的机制与边界。

重启退避不代表删除Pod进一步说明此处的机制与边界。

探针模板变更不自动更新旧实例进一步说明此处的机制与边界。

原书依据 · 3 处
9.2.5 部署新版本服务

本节从Pod、RS和Service转入Deployment,以更高层资源管理新旧版本。金丝雀仍需实际观测,不因添加一个版本就默认健康。

1.部署

Deployment管理模板修订与多个ReplicaSet,模板变动才驱动新组滚动。旧清单需apps/v1及明确匹配selector,资源requests是调度需求不是已证明的运行容量。直接删RS是书中演示步骤,本轮未操作。

部署对象管理版本替换进一步说明此处的机制与边界。

原书依据 · 1 处
2.金丝雀部署

金丝雀独立管理组用track:canary,稳定组用stable,Service故意只选app/tier来纳入两组;控制器选择器应各自包含track。图9.15金丝雀却写stable是误标。3+1不严格等于25%流量,需真实反馈。滚动50%预算按3副本取整为1不可用与2额外,原书数字标签不是禁用惯例,提交标签也须对应真实内容。更新清单删探针会使新模板缺探针,不应把删省字段误当继承旧配置。

金丝雀入口可跨两个管理组进一步说明此处的机制与边界。

滚动预算约束可用与额外副本进一步说明此处的机制与边界。

原书依据 · 2 处
9.2.6 回滚

rollout history与undo回退Pod模板修订,不自动恢复持久数据和外部效果。回退可重走控制器调和,但能否满足业务仍需兼容、容量和观察。

修订回退不回滚持久业务数据进一步说明此处的机制与边界。

原书依据 · 1 处
9.2.7 连接多个服务

服务DNS逻辑名降低IP耦合,正确片段是svc而非正文svg,集群域也可不同。DNS组件并非必须只在主节点,普通Service解析入口与Pod可达、业务成功分开。nslookup与get services给诊断方向,本轮未创建诊断容器。

服务DNS隔开逻辑与位置进一步说明此处的机制与边界。

用临时诊断环境检查服务解析进一步说明此处的机制与边界。

原书依据 · 2 处

9.3 小结

本章闭环为构建分发→声明期望→控制器和节点落实→Service接入→探针和版本更新。容器、Pod与业务完成并非同一层保证,过时API和原文误述已在对应位置注明。

第10章 构建微服务交付流水线

第8—9章已把代码做成镜像并交给集群,本章把这些动作接成可验证和可追踪的交付链。目标是安全节奏与流程一致性,并在末尾把技术部署与业务功能开放拆开。本章示例为历史Jenkins/Minikube环境,未在本机执行。

10.1 让部署变得平淡

微服务团队独立发布使人为操作差异扩大,需要在速度、安全检查和一致流程间取得平衡。繁重审批并非唯一保证,快速无验证也不能叫安全交付。共同部署抽象应支持业务和语言差异。

交付一致性降低操作差异进一步说明此处的机制与边界。

原书依据 · 1 处
部署流水线

流水线从提交、构建、单元测试、工件存储走到预发布协作验证,再按决策进入生产,每步给明确反馈。小批次减少积压和定位范围,仍需覆盖跨服务契约和状态变化。持续交付保持能够上线,持续部署自动完成最后上线决定;二者不要混称。图10.1给各阶段失败回路。

小批次交付缩短反馈回路进一步说明此处的机制与边界。

持续交付保留上线决策进一步说明此处的机制与边界。

流水线按阶段保留失败反馈进一步说明此处的机制与边界。

原书依据 · 3 处

10.2 使用Jenkins构建流水线

Jenkins编排已有构建、测试、仓库和kubectl工具,各工具仍承担自己的责任;不存在选择一个产品就获得完整交付的捷径。图10.2按PyPI/Pytest/Docker/Kubernetes分工,历史工具版本不是当前推荐。附录提供本地环境准备,本轮尚未执行。

编排工具连接现有交付能力进一步说明此处的机制与边界。

原书依据 · 1 处
10.2.1 构建流水线配置

控制节点管理job,代理在workspace执行。仓库Jenkinsfile可版本化stage/node/checkout/sh等步骤,多分支任务扫描分支并配置不同流水线。Job DSL生成任务与Scripted Pipeline是不同层次;所谓XML格式不能当流水线语法定义。图10.4⁄10.5为历史配置和运行界面,原commit输出不代表本轮构建,未push代码。

控制节点与执行工作区分工进一步说明此处的机制与边界。

流水线脚本随服务代码演进进一步说明此处的机制与边界。

多分支任务按仓库分支建流水线进一步说明此处的机制与边界。

原书依据 · 3 处
10.2.2 构建镜像

podTemplate把Docker和kubectl封装成构建工具容器,node取代理、container选工具,checkout后build镜像。原方案挂宿主Docker socket,依赖该守护进程存在且有强权限,不能当现代任意K8s的通用方案。分支名加编号还需合法tag编码及提交、依赖与镜像内容的关联。

构建代理封装所需工具进一步说明此处的机制与边界。

宿主套接字不是独立构建器进一步说明此处的机制与边界。

构建标签还需关联真实内容进一步说明此处的机制与边界。

原书依据 · 3 处
10.2.3 运行测试

构建后运行测试,失败必须阻断;编译、依赖、静态分析和风格检查各有用途。卷挂载让测试结果能离开容器保留,finally只保证尝试归档,不产生XML。原${service}python缺空格,测试还须配置/workspace/results.xml路径,旧setup.py test也不能作为当前通用命令。图10.6是原构建历史,本轮未运行或发送通知。

测试门禁先保证失败停止进一步说明此处的机制与边界。

测试报告必须真正写出再归档进一步说明此处的机制与边界。

原书依据 · 2 处
10.2.4 发布工件

待交付镜像tag到目标仓库再push,凭据通过配置ID引用。公开仓库可公开拉取不等于任何人可push,原文免认证说法已按Docker官方权限说明限定。工件应从验证到多环境推广保持身份,不以不同环境重建冒充同一产物;本轮未登录或上传。

发布工件要具备写仓库权限进一步说明此处的机制与边界。

原书依据 · 1 处
10.2.5 部署至预发布环境

预发布补足真实协作方、验收及安全容量等验证。命名空间隔开资源名称但不自动建立网络、资源和故障隔离,PCI描述仅作出版背景不作当前合规判断。BUILD_TAG替换绑定镜像,旧API及selector须沿第9章校正;apply只是提交期望,应等待rollout及就绪并处理超时。首次整章输出截断的本节已单独全文补读,图10.6—10.7前后说明均已读。

预发布验证补足服务协作进一步说明此处的机制与边界。

命名空间隔离仍需其他边界进一步说明此处的机制与边界。

提交部署后仍需等待就绪进一步说明此处的机制与边界。

原书依据 · 3 处
10.2.6 预发布环境

生产相似环境需保留所测行为的代表性,不必同规模。共享全环境覆盖协作更多却易被其他团队变更扰动,短期局部环境状态易控却不能缺必要依赖。图10.7展示不同子集与全环境,部署者需做邻居并便于恢复上版。

预发布保留代表性而非等规模进一步说明此处的机制与边界。

共享与临时测试环境互补进一步说明此处的机制与边界。

原书依据 · 2 处
10.2.7 部署生产环境

生产链应为批准→金丝雀→观察→推广或停止恢复。input本身不是部署;deploy.groovy两参数kubectl被一参数调用、回滚漏命名空间及部署名未用均不能照搬。catch中仅回滚而不终止会有继续生产的风险。canary单独命名空间也不自动被production的Service选择,须补明确真实流量路由。图10.8只表意整条链,不能当这些代码缺口已经验证解决。本轮无生产操作。

生产门禁需串联观测和处置进一步说明此处的机制与边界。

中止被捕获后须阻止继续上线进一步说明此处的机制与边界。

封装部署要贯通命名空间进一步说明此处的机制与边界。

金丝雀必须接入真实目标流量进一步说明此处的机制与边界。

原书依据 · 4 处

10.3 构建可复用的流水线步骤

技术自由带来跨团队理解和重复平台工作的成本。图10.9将底座、容器工件、调度和流水线共性集中,业务服务仍可不同,平台抽象应围绕共同责任而非所有业务实现统一。

平台共性减少重复交付实现进一步说明此处的机制与边界。

原书依据 · 1 处
过程式构建流水线和声明式构建流水线

过程脚本绑定仓库并要求开发者懂执行细节,声明式意图把build/test/publish/deploy留给公共框架实现。清单service{…}是自定义DSL示意,不是Jenkins内置Declarative Pipeline;共享库需真实实现及版本配置,本书正文未展开实现。Travis/Drone仅作为其他声明配置载体登记。

流水线声明意图复用执行细节进一步说明此处的机制与边界。

原书依据 · 1 处

10.4 降低部署影响以及实现功能发布的技术

部署改变生产运行版本,发布决定用户可用功能。暗发布与功能标记把运行验证和可见性决策分开,仍需防止兼容与持久副作用问题。

部署版本与开放功能分开决策进一步说明此处的机制与边界。

原书依据 · 1 处
10.4.1 暗发布

暗发布让服务先在生产内部可用,也可复制请求给影子预测算法,把结果写日志与现有算法比较,保持原服务回应用户。图10.10显示请求和结果隔离,不能把读类预测例推广为重复真实交易写。Scientist授权重构例在章末登记,不冒充已深读其源码。

暗发布先验证而不暴露结果进一步说明此处的机制与边界。

原书依据 · 1 处
10.4.2 功能标记

功能标记以条件逻辑控制内部或分组用户可见性并逐步扩展,可更快关闭后续路径但不会撤销已写数据。图10.11比较各服务独立存储与集中功能服务;后者降低跨服务协调,不自动保证原子开关及所有缓存立即一致。Flipper/Togglz/Redis为原文工具例。

功能标记按用户控制可见性进一步说明此处的机制与边界。

集中功能配置降低跨服务协调进一步说明此处的机制与边界。

原书依据 · 2 处

10.5 小结

本章把单次构建和部署提升为跨服务可复用、可观察的交付流程,再用暗发布和功能标记区分部署与业务开放。安全来自已实现的验证与失败处置,不能由绿色截图、批准按钮或副本创建替代;原例已知缺口在对应节标明。Scientist仅有授权重构用途介绍,登记参考未伪造实现细节。

第四部分 可观测性和所有权

第四部分把已经部署的服务变成能够理解其运行情况并有人负责的系统:第11章用指标与告警发现偏差,第12章用日志与链路追踪调查具体请求,第13章讨论协作和日常开发。三类信号与团队所有权共同支撑运行反馈,尚未读的后续正文继续保持pending。

第11章 构建监控系统

本章把运行中的服务和依赖转成可保留的指标,用面板了解状态、用告警决定行动,再将多个服务信号关联回用户功能。收集不是越多越好,而要明确口径、成本、上下文和责任。本轮未运行监控栈或发送告警。

11.1 稳固的监控技术栈

监控栈负责采集、存储、展示分析和告警,日志追踪补充事件细节。图11.1三类信号各有面板,属于教学组织而非工具互斥定义;任何单一信号都不保证自动知道根因。历史数据能支持趋势研究,但采集有资源和数据边界。

监控信号串起采集存储与分析进一步说明此处的机制与边界。

原书依据 · 1 处
11.1.1 良好的分层监控

图11.2仍是预留后order-created、收费后order-placed、市场处理的本章示例,与第5章收费流程分开。监测客户端、边界、服务和平台可避免仅见服务空闲而漏掉网络消息中断。队列低量可能空闲或上游断流,高量可能增流或消费慢,必须结合发布消费率及等待时间。

分层监控避免只见局部正常进一步说明此处的机制与边界。

队列数量要结合流入流出解释进一步说明此处的机制与边界。

原书依据 · 2 处
11.1.2 黄金标志

四大黄金信号分别看时延、错误、需求与有限资源压力。它们联合解释服务体验和承载,不能由某个指标异常直接确定根因。下面逐项规定对象和边界。

黄金信号从需求结果看承载进一步说明此处的机制与边界。

原书依据 · 1 处
1.时延

快失败会使混合时延显得很好,应把成功和失败时延分开,同时看错误率。原文排除错误数据应理解为避免污染成功时延,不能把失败耗时从监控中彻底删除。

成功和失败时延应分开观察进一步说明此处的机制与边界。

原书依据 · 1 处
2.错误量

HTTP状态只能表达部分错误,200内容错也是业务失败。定义正确结果及同口径分母,用端到端或契约检查辅助隐式错误识别。

错误率要包含业务结果错误进一步说明此处的机制与边界。

原书依据 · 1 处
3.通信量

流量反映系统需求,可用请求率、消息率或字节率,须与负载载荷及观测层对应。入口请求数不等于后台完成数。

流量指标按系统需求定义进一步说明此处的机制与边界。

原书依据 · 1 处
4.饱和度

饱和度要看CPU、内存、网络或配额等具体约束及剩余承载,平均值未满不能排除峰值和其他瓶颈。

饱和度表示有限资源压力进一步说明此处的机制与边界。

原书依据 · 1 处
11.1.3 度量指标的类型

指标类型决定怎样更新和解释数据,不由名字决定。以下counter累计事件,gauge描述可升降值,histogram保存分布;后文输出还有summary分位,不能混作一种可聚合数据。

1.计数器

计数器累计请求错误字节,正常只增而重启可重置,速率须处理重置。连接数等可下降值另用gauge,已对照官方指标说明。

计数器累计事件并考虑重置进一步说明此处的机制与边界。

原书依据 · 1 处
2.计量器

gauge适合时点连接、内存及负载,采样间峰值可能看不到,聚合须知道资源归属而非盲目相加。

计量器描述可升降的当前值进一步说明此处的机制与边界。

原书依据 · 1 处
3.直方图

直方图把时延大小等观测按值域分桶,桶边界决定估计精度。类型标签不同于分布桶,采样一词不代表默认随机丢弃部分请求。

直方图保留观测分布进一步说明此处的机制与边界。

原书依据 · 1 处
11.1.4 实践建议

渐进建立顶层整体与下钻详细面板,按业务选P95/P99及窗口。标签可给上下文,但原用户ID无界基数建议须限定,逐用户分析更适合日志追踪。统一命名、单位、类型和结果口径,StatsD点分名字不能直接当Prometheus原生命名。

顶层面板先回答服务是否正常进一步说明此处的机制与边界。

百分位目标应对应业务窗口进一步说明此处的机制与边界。

标签上下文要控制基数进一步说明此处的机制与边界。

指标命名统一语义和单位进一步说明此处的机制与边界。

原书依据 · 4 处

11.2 利用Prometheus和Grafana监控SimpleBank

图11.3把StatsD推送经导出器变成Prometheus可拉取数据,Grafana再查询展示;RabbitMQ另作抓取目标。两协议可共存,仍需核对中间丢失采样和时间语义。

推送指标可经导出器被拉取进一步说明此处的机制与边界。

原书依据 · 1 处
11.2.1 配置度量指标收集基础设施

基础设施配置顺序为Compose加入组件→导出器映射→Prometheus抓取→Grafana数据源及面板,不把后续未配置能力当已经存在。

1.向Docker Compose文件添加组件

清单使用多个容器及挂载配置连接监控栈。Prometheus实参9090、注释9000冲突以一致实参为准;StatsD UDP端口和Prometheus HTTP抓取不同。历史镜像未固定及旧命令需对应版本,本轮未创建或删除容器。

监控容器连通先核对实际配置进一步说明此处的机制与边界。

原书依据 · 1 处
2.StatsD导出服务配置

StatsD按服务操作命名,映射后统一指标加app标签,图11.4比较映射前后。旧映射文本不当现行YAML;计时从毫秒转秒要查单位,summary的quantile不可跨实例直接平均成整体分位,已按官方资料限定。

导出映射统一名称保留服务标签进一步说明此处的机制与边界。

客户端分位不能直接跨实例平均进一步说明此处的机制与边界。

原书依据 · 2 处
3.配置Prometheus

Prometheus配置job、target和metrics_path,5秒抓取与10秒规则评估分开。旧RabbitMQ第三方镜像/api/metrics不是所有现行插件通用路径,未验证新版本可运行性。

抓取目标与规则评估周期分开进一步说明此处的机制与边界。

原书依据 · 1 处
4.设置Grafana

Grafana用内部http://prometheus:9090访问数据源,宿主3900映射Grafana3000为另一个入口。Save & Test验证连接配置,不代表业务已正常。默认账号与UI均为历史背景;书中按名称过滤批量删容器仅记录用途,未执行。

面板数据源地址按查询方确定进一步说明此处的机制与边界。

原书依据 · 1 处
11.2.2 收集基础设施度量指标——RabbitMQ

图11.7导入JSON面板并选择实际数据源,图11.8显示RabbitMQ连接消费者队列消息。需要匹配真实指标版本和口径,up不能证明消息消费完成。

基础设施面板补足业务依赖进一步说明此处的机制与边界。

原书依据 · 1 处
11.2.3 监控下单功能

图11.9—11.11将下单各阶段计时和分位并列,并允许时间范围与图例配置。图上分位值的min/max/mean不是原始请求统计,各阶段P99不能相加成端到端P99,单位需查转换和面板倍率。

业务面板串联各阶段耗时进一步说明此处的机制与边界。

原书依据 · 1 处
11.2.4 告警设置

配置webhook渠道、规则条件、测试并保存可得到alerting/ok通知,演示服务只记录不扩容。图11.14实际为每30秒评估最近1分钟avg(query)>100,正文一旦任意值超过100不准确,已按图更正;历史Grafana界面和载荷不是当前API保证。图11.12—11.15为原书状态记录,本轮未设置外部通知。

告警条件要区分窗口聚合进一步说明此处的机制与边界。

通知接收与自动扩容不同进一步说明此处的机制与边界。

原书依据 · 2 处

11.3 生成合理的可执行的告警

告警要可操作、有人负责、上下文简洁并标优先级;同一问题的多重通知和无行动偏差会导致疲劳。自动消费者和人类消费者都需明确后续动作及结果。

可执行告警需要行动和接收者进一步说明此处的机制与边界。

原书依据 · 1 处
11.3.1 系统出错时哪些人需要知悉

谁开发谁运行让了解服务的团队处理相关告警;值班团队凭诊断文档处理或升级。严重影响呼叫、中等排任务、低优先记录或自动动作是分流思路,最终仍按真实业务影响定级。

告警按紧急程度路由和升级进一步说明此处的机制与边界。

原书依据 · 1 处
11.3.2 症状,而非原因

以用户不能完成订单等症状呼叫,再查指标日志追踪找原因,减少对每个资源波动都发通知。业务提交完成差值仍需考虑异步等待,原因指标保留作调查与预警。

用户症状比猜测根因更适合呼叫进一步说明此处的机制与边界。

原书依据 · 1 处

11.4 监测整个应用

图11.16将网关和订单请求、order-created、order-placed关联,但必须先对齐窗口、重试拒绝和事件倍数。队列深度不是发布累计数,不能直接相除算完成率;99%是示例而非默认可靠目标。指标只能为原因提供线索,下章日志追踪补足具体请求。

跨服务比值先对齐业务口径进一步说明此处的机制与边界。

原书依据 · 1 处

11.5 小结

本章闭环为分层信号→正确类型和口径→收集存储与面板→可行动分级通知→跨服务业务关联。原文高基数标签、错误时延删除、summary聚合及平均窗口告警误述已就地限定,未执行生成后内容复核或独立审查。

第12章 使用日志和链路追踪了解系统行为

上一章指标展示分布和整体状态,本章用集中日志查询具体请求,再用追踪展示操作因果与耗时。日志、指标和追踪互补,未记录或未采集部分不能事后凭图补造;本轮无运行日志栈或业务请求。

12.1 了解服务间的行为

图12.1—12.3由单机日志转到多服务多实例散落,需分别解决实例退出后保留和统一检索。原文每Pod不同物理机不成立,实际调度可同机;集中入口也不自动提供可靠持久或日志完整性。

集中检索与日志持久分开保证进一步说明此处的机制与边界。

原书依据 · 1 处

12.2 生成一致的、结构化的、人类可读的日志

团队先约定服务日志的字段和格式,外部不可控来源由收集转换适配。人机可读和语义一致共同降低调查成本。

日志格式约定降低跨源处理成本进一步说明此处的机制与边界。

原书依据 · 1 处
12.2.1 日志中的有用信息

有用日志至少提供时间、关联身份、事件来源和等级等上下文;以下每项有独立作用,不能只靠一段文本推断所有事情。

1.时间戳

时间戳应明确时区及精度,UTC有利比较,但不同机器的时钟准确度、采集时间与事件时间仍需区分,不能保证全局因果顺序。

日志时间统一仍有时钟误差进一步说明此处的机制与边界。

原书依据 · 1 处
2.标识符

请求与资源标识便于跨源分组,已有ID应明确作用范围,用户ID和订单ID不等同trace身份,也不自动承担幂等职责。

关联标识贯通请求与业务实体进一步说明此处的机制与边界。

原书依据 · 1 处
3.来源

主机模块函数文件行号表明来源,辅助找到代码和性能相关范围,但一条日志时间戳不构成耗时测量。

来源字段缩小日志定位范围进一步说明此处的机制与边界。

原书依据 · 1 处
4.日志等级或类别

等级类别便于筛选路由错误报告,需团队约定含义;不能把某等级直接当业务成功失败和呼叫优先级。

日志等级支持筛选与路由进一步说明此处的机制与边界。

原书依据 · 1 处
12.2.2 结构化和可读性

结构化JSON保留字段与事件边界,图像用引用元信息而非原始二进制,多行需正确编码。LogstashFormatter补通用字段;原msecs是日志创建时刻毫秒部分,relativeCreated是相对logging加载时长,不是操作耗时,已按Python官方说明更正。示例时间字段不一致不当有效计时证据。

结构化单行保留事件边界进一步说明此处的机制与边界。

日志创建毫秒不是操作耗时进一步说明此处的机制与边界。

原书依据 · 2 处

12.3 为SimpleBank配置日志基础设施

图12.4将指标面板与集中日志并列,通过ID从整体偏差深入具体请求。所谓ELK在本例用Fluentd传输,不能因名称含Logstash就推断部署服务端Logstash。

12.3.1 基于ELK和Fluentd的解决方案

图12.5服务标准流经收集代理转发到集中索引。应用记录、采集、缓冲和远端保存有不同成功边界,不将stdout写入等同端到端可靠交付。

标准输出与收集转发职责分开进一步说明此处的机制与边界。

原书依据 · 1 处
1.Elasticsearch

Elasticsearch存储并索引日志供检索聚合,本例不据产品名承诺副本恢复与保留策略已具备。

搜索存储与展示界面各有责任进一步说明此处的机制与边界。

原书依据 · 1 处
2.Logstash

Logstash服务端通常可处理事件流水线,但本例只用客户端Logstash风格格式器,转发由Fluentd承担,格式库和服务端不可混同。

3.Kibana

Kibana查询Elasticsearch并以视图展示日志聚合结果,图12.6为历史通用面板,不是本轮数据。

4.Fluentd

Fluentd作为收集转发器接Docker日志驱动,再送索引系统。原文Dockerfile日志提供程序的表达应理解为Docker/Compose运行时logging配置,不是Dockerfile构建指令。

12.3.2 配置日志解决方案

Compose加入索引、面板及Fluentd并配置服务logging驱动。localhost地址按Docker守护进程环境解析,链接不保证日志代理就绪。Fluentd与simplebank.gateway不匹配,copy是复制给两个store而非按JSON分流;logstash_format不自动解析log字段内JSON,还需相应parser。旧v0.12和插件1.9.2未当当前可运行部署。

日志驱动连接地址属于宿主环境进一步说明此处的机制与边界。

日志路由匹配与内容解析分开进一步说明此处的机制与边界。

原书依据 · 2 处
12.3.3 配置应收集哪些日志

root等级环境变量默认INFO,console handler配格式器,DEBUG仅在相应阈值记录。原xtra应为extra,重复handler会重复事件,StreamHandler默认stderr应覆盖收集。Kibana以fluentd-*索引模式和时间字段连接,再按响应ID查询;书中up与POST请求仅作历史说明,本轮未启动或下单。

日志详细性通过等级与处理器控制进一步说明此处的机制与边界。

索引与时间窗决定日志可见性进一步说明此处的机制与边界。

原书依据 · 2 处
12.3.4 大海捞针

图12.8⁄12.9按订单请求ID查看11条来自多服务的记录,包含DEBUG/INFO及代码位置。它重建已记录的线索,不证明每个服务必定有固定日志数、无遗漏或业务已提交,未发现日志也不证明未执行。

日志关联不等于执行完整证明进一步说明此处的机制与边界。

原书依据 · 1 处
12.3.5 记录合适的信息

敏感信息进入集中索引后扩散和事后清理成本变大,优先源头最少记录与必要脱敏,收集端再过滤并控制访问。删除只能整段的说法不是所有版本能力限制,GDPR仅出版背景,不作当前法律判断。

日志敏感数据优先在源头减少进一步说明此处的机制与边界。

原书依据 · 1 处

12.4 服务间的跟踪交互

追踪补足跨服务调用因果和时间线。OpenTracing是本书历史供应商无关API,不等于所有后端的线协议兼容,已按官方说明标记归档及2026兼容要求弃用背景,不冒充完成OpenTelemetry迁移。

追踪接口抽象不等于后端协议通用进一步说明此处的机制与边界。

原书依据 · 1 处
12.4.1 请求关联:trace和span

trace关联多个span,span含操作起止、标签、日志及context引用,时间关系和因果引用是两种视角。图12.10既有ChildOf也有FollowsFrom,G注释与连线不一致,不能硬称唯一父子树;传播需完整context而非只一个ID。

追踪由操作片段和因果引用组成进一步说明此处的机制与边界。

上下文传播连接不同进程操作进一步说明此处的机制与边界。

原书依据 · 2 处
12.4.2 在服务内配置链路追踪

profile调用外部IP服务和内部settings,Jaeger演示all-in-one内存存span,采样1和批量1不当生产配置。5775和旧客户端协议需匹配,未验证当前镜像。清单inject应按API传span.context,Python导入及断词错误须修正,Requests需超时和状态检查。实际根span加get_ip和下游settings共3span,get_user_settings只复用根span未新建客户端span,区别正文笼统描述。

演示收集器不等于持久追踪平台进一步说明此处的机制与边界。

注入应传上下文而非整个span进一步说明此处的机制与边界。

片段划分以实际埋点为准进一步说明此处的机制与边界。

原书依据 · 3 处

12.5 链路追踪可视化

图12.13—12.16由服务筛选到具体3span时间线及两服务依赖图。可定位已观测操作的时间重叠和慢段,但不能相加并行耗时、忽略时钟采样或把动态图当完整静态依赖。图与请求输出均来自原书,本轮没有请求外站或SimpleBank。

追踪时间线定位已观测关键路径进一步说明此处的机制与边界。

追踪依赖图只反映已采集交互进一步说明此处的机制与边界。

原书依据 · 2 处

12.6 小结

日志格式、来源关联、集中索引及跨进程上下文构成调查具体请求的路径。持久与可检索、片段与端到端业务结果是不同保证;原例字段和脚本错误已在生成时注明,不作已部署验证。

第13章 微服务团队建设

本章把技术独立部署落到人的责任和协作:服务越多,运维、安全和值班范围越大,需要在自治与全局协调间建立可持续机制。组织经验来自作者案例,不当普适人数或法律规则。

13.1 建设高效团队

图13.1给全互联潜在关系数3人3、5人10、7人21,小团队可减少内部协作负担,却增加跨队知识与优先级边界。披萨和7±3只是经验,真实通信并不必定全互联。

小团队减少内部沟通但增加边界进一步说明此处的机制与边界。

原书依据 · 1 处
13.1.1 康威定律

组织沟通和系统边界互相影响,逆康威可先调整职责和协作以帮助架构目标,但不是只改组织图即可保证正确服务拆分。

组织沟通与架构相互塑造进一步说明此处的机制与边界。

原书依据 · 1 处
13.1.2 高效团队原则

所有权、自治和端到端责任是设计原则,需结合人员能力预算业务,不存在唯一组织模板。重大调整还需支持信任及解释权衡;《微服务之道》为推荐参考,未凭提名补造管理方案。

团队设计以三项原则取舍进一步说明此处的机制与边界。

原书依据 · 1 处
1.所有权

图13.2是单体多队共享一应用、微服务一队多服务。警告框将1:n解释反了,已以图和上下文更正;明确长期负责团队不等于禁止外队贡献,责任不能只压某个人。

服务所有权属于长期负责团队进一步说明此处的机制与边界。

原书依据 · 1 处
2.自治

自治队内部目标一致并限制外部交付依赖,自管优先级减少管理负担。共同契约、全局目标和事故协作仍需满足。

团队自治依赖可控交付路径进一步说明此处的机制与边界。

原书依据 · 1 处
3.端到端职责

图13.3把设计部署观察循环,设想构建运行由同队承担才易保留真实反馈。端到端业务责任可与专业平台团队合作,不要求每人精通一切。

端到端责任让运行反馈回到设计进一步说明此处的机制与边界。

原书依据 · 1 处

13.2 团队模型

职能团队按专业和限时项目组织,跨职能团队按长期业务结果组合技能;评估应看专业效率、交接等待和长期运维责任,不能以名称判断全部成败。

团队模型区分专业效率和业务结果进一步说明此处的机制与边界。

原书依据 · 1 处
13.2.1 按职能分组

图13.4⁄13.5呈现跨专业流水线交接和项目协调,风险是所有权不清、排队依赖、短期交付和竖井对立。专业知识聚集仍有收益,长期团队也需保持新观点。

职能交接容易分散长期责任进一步说明此处的机制与边界。

原书依据 · 1 处
13.2.2 跨职能分组

图13.6产品开发设计测试共同对任务负责,使日常沟通本地化并保留运维迭代。六个月、双负责人和Amazon历史引文仅作经验,不写成配置要求或当前组织事实。

跨职能团队围绕共同任务交付进一步说明此处的机制与边界。

原书依据 · 1 处
13.2.3 设置团队边界

团队使命限定责任,可用限界上下文作边界起点,按规模和活动内聚校正。图13.7一产品一队、图13.8多队对应SimpleBank上下文;团队既可垂直业务也可水平复杂组件,9人提示不是机械拆分规则。本节此前截断已全文补读。

团队边界从使命和内聚出发进一步说明此处的机制与边界。

原书依据 · 1 处
13.2.4 基础设施、平台和产品

图13.9—13.11从产品兼建平台到专门平台再专业基础设施三层,按共享需求与复杂性演进。下层作为产品赋能上层,不把每次能力消费变成工单等待;并非所有企业都要先建齐三层。

平台团队提供可消费的内部产品进一步说明此处的机制与边界。

原书依据 · 1 处
13.2.5 谁负责值班

图13.12按业务平台基础设施责任路由告警并相互升级,谁开发谁运行仍需专业支持。包容、公平、轮换足够和告警反思让轮值可持续,非工作时间安排为组织原则不作法律判断。

值班按运行责任和专业分层进一步说明此处的机制与边界。

可持续轮值需要公平与反馈进一步说明此处的机制与边界。

原书依据 · 2 处
13.2.6 知识共享

图13.13分会按专业、协会按跨职能主题分享,轮换补知识流动,矩阵管理另增加汇报线。DRY在跨服务需计公共库抽象推广升级成本,适当重复可换速度而非任意复制缺陷。

实践社区连接自治团队知识进一步说明此处的机制与边界。

跨服务复用要计入推广协调进一步说明此处的机制与边界。

原书依据 · 2 处

13.3 微服务团队的实践建议

大量独立服务及团队会引出局部最优、绕过既有问题另建服务、实践孤立与全局视野缺失。后续原则、评审、内部开源及文档把这些风险落到日常协作,不假定每人记住全部服务。

13.3.1 微服务变更的驱动力

图13.14将新需求、法规、缺陷、依赖、安全和扩展性都列作变更驱动。维护不是没有新需求时就可忽略,具体法规仍需另有实际依据。

服务演进不只由新增功能驱动进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.2 架构的角色

架构师用全局目标和可演进原则引导团队局部决策,减少每次集中审批。图13.15目标→原则→实践,图13.16以新市场需求关联多区域与国际化;隐私安全只作原则例,未做当前合规结论。

架构原则引导局部决策演进进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.3 同质性与技术灵活性

技术自由增加知识与运行适配成本,小技术集合加模板降低摩擦,例外借结对轮换文档降低关键人风险。原Java不适合基础设施及语言生态绝对说法不照抄为技术事实,服务可替换还需满足契约和数据兼容。

技术自由需支付维护知识成本进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.4 开源模型

图13.17A/C可提交B的服务变更,B负责评审和长期维护,开放协作不取消所有权及敏感代码访问例外。共同架构交付约定降低跨队贡献成本,本轮未向任何仓库发PR。

内部开源开放贡献保留负责者进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.5 设计评审

RFC在实施前描述问题方案、依赖接口、性能成本、可靠备份回滚、观测故障、安全上线与未知项,请内外团队讨论。模板底座不能代替跨服务设计判断,文档和会议本身不是质量通过。

设计评审提前暴露跨服务权衡进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.6 动态文档

表13.2四层为概述、契约、运行手册及实际技术元数据,服务注册目录提供发现;能从真实状态生成部分则自动化,其余由团队维护。MkDocs和Swagger UI为工具参考,不额外建站。

服务文档按四层支撑发现和运维进一步说明此处的机制与边界。

原书依据 · 1 处
13.3.7 回答应用的问题

全局语言版本、风险、依赖和关键程度来自多种证据,手表架构图易过时,service.yml可保存部分元信息但不替代运行观测。Dependabot和Shopify报告是原书线索,未作当前工具市场推荐。

服务元数据需要可追溯来源进一步说明此处的机制与边界。

原书依据 · 1 处

13.4 延伸阅读

推荐管理书只给题录没有展开论证,逐项登记而不补造四书内容。结论是软件交付由人完成,技术拆分必须配合沟通与负责实践。

13.5 小结

全章将组织与架构相互塑造→长期所有权自治端到端→专业平台和知识网络→原则评审内部开源动态文档连成闭环。脚注中产品模式、Spotify和Shopify资料按实际出现登记,原书经验未当普适因果证明。

附录A 在Minikube上安装Jenkins

附录给第10章的本地Jenkins环境,内容实质纳入阅读,但Helm、插件与集群API属于历史组合。下文保留职责、参数与验证思想,旧命令不作为当前可直接执行教程。

A.1 在Kubernetes上运行Jenkins

图A.1控制节点编排代理,代理取代码和访问资源;Jenkins可作为Minikube中服务,安装控制节点、授权代理和实际构建要分别验证。

集群运行控制器与构建代理分工进一步说明此处的机制与边界。

原书依据 · 1 处

A.2 设置Helm

Chart封装对象模板,values参数化。图A.2客户端经Tiller属于Helm 2,Helm 3已移除Tiller和helm init;没有将书中流程称为最新版。

Chart封装须区分安装版本进一步说明此处的机制与边界。

原书依据 · 1 处

A.3 创建命名空间和数据卷

先建Jenkins命名空间与配置存储,但PV是集群级,namespace字段不能赋予隔离。hostPath只适合本地单节点测试,Retain不是备份,Pod重启保留不代表节点及Minikube数据删除后仍有恢复材料。

持久卷不等于独立备份进一步说明此处的机制与边界。

原书依据 · 1 处

A.4 安装Jenkins

values中的旧Master/Agent字段、插件、stable/jenkins、extensions/v1beta1及Helm 2命令须与确切历史版本匹配。图A.3资源DEPLOYED同时Pod仍初始化,需继续等就绪。cluster-admin、socket和脚本审批强权限非生产默认;Secret命令只说明凭据取自配置,本轮未读取或打印Secret。

安装参数要与Chart版本匹配进一步说明此处的机制与边界。

构建权限应限定目标能力进一步说明此处的机制与边界。

原书依据 · 2 处

A.5 配置RBAC

图A.4选择ID为jenkins的Service Account凭据让云配置使用,认证身份与RBAC授权不同;账户、命名空间和podTemplate参数须贯通。界面保存凭据不等于集群权限已正确授予。

凭据引用与实际授权分开配置进一步说明此处的机制与边界。

原书依据 · 1 处

A.6 测试一切正常

创建test-job、定义podTemplate并执行docker version,可诊断代理及工具路径。图A.6仅展示Client输出,不能据截图片段保证Server可用或构建部署完整成功;/var/run/ docker.sock断词不可照抄。失败先查完整构建日志,本轮无实际执行。

最小构建测试只验证已走路径进一步说明此处的机制与边界。

原书依据 · 1 处

跨章综合

边界必须同时考虑业务、数据和团队。 第1—4章的内聚与限界上下文减少概念混用,第5章显示边界一旦跨库就增加提交和查询成本,第13章又要求有人长期承担这些成本。数据多、接口多或人数多并不是独立的拆分理由;应看哪些变更能独立完成、哪些不变量需要共同协调,以及团队是否能维护运行责任。

确认点贯穿业务与基础设施。 持仓预留和支付事件要说明究竟确认了什么,超时只说明调用方暂时不知道结果;消息ack、镜像push、kubectl apply、健康响应和日志写出也都有各自成功边界。把这些不同阶段压成一个success布尔值,会使重试、补偿、告警和归档证据都被误读。应沿真实状态迁移保留已完成、未完成及未知的区别。

补偿、版本回退与开关关闭保护不同对象。 Saga恢复的是可接受的业务语义,容器或Deployment回退改变运行版本,功能标记改变后续可见路径。它们都不自动撤销持久数据或外部交易。第5章的重复退款与撤销竞争因此不能仅靠第8—10章的发布回退解决;需要业务不变量、并发协议及可恢复记录共同支持。

平台共性降低选择成本,也需要明确适用范围。 第3、7章的底座和平台把日志、通信与组织约定接入服务,第8—10章扩展到工件调度与流水线,第13章将其变成内部产品。过早抽成公共库会增加协调,完全各自实现又制造差异。成熟共性值得共享,业务语义与未知需求应保留自治,不以统一工具替代共同契约。

可观测性要先有合法口径,才能解释现象。 入口QPS不等于完成QPS,队列存量不等于累计事件,平均时延不代表尾部,多个实例P99也不能简单平均。日志msecs不是请求耗时,trace采样和时钟也会限制时间线。第11—12章的面板只有和类型、时间窗、身份及失败路径一起阅读,才成为可靠诊断线索;图表之间相关也不自动证明根因。

独立发布由工程与组织共同维持。 契约兼容降低消费方同步升级,固定工件和配置减少环境漂移,流水线失败门禁限制错误扩散,负责团队的告警和评审推动改进。缺任一环,服务数量增长都可能放大交付摩擦。全书最终关心的是可持续改变系统的能力,不是把所有旧示例重新运行一次。

发散与实践

本轮交付两项实现深读计划及已填写首轮材料,完整实践没有执行。它们是读者延伸,外部项目的具体实现不当作作者原有结论。

  1. ideas/idea-001-深读指标映射与聚合.md:以官方statsd_exporter v0.28.0固定提交追踪收集、映射、观测类型及错误路径,已实际读取相关源码和两个测试,记录UDP队列丢包、默认Summary和单位转换仍需解析器证据的边界。后续按计划补registry/parser,未编译或运行。
  2. ideas/idea-002-深读消息确认与重投.md:以Nameko v2.14.1固定提交对照服务池、prefetch、worker完成、ack/requeue及断连,已读取异常策略与官方测试片段,分清reliable_delivery与普通异常重投。后续继续内部worker和Kombu/RabbitMQ恢复,不执行真实金融操作。

首轮映射在ideas/materials/,概览提供可点击入口。自制Saga框架、全套旧SimpleBank/Jenkins部署未立项,成熟源码足以先回答当前机制问题;团队行为实验缺现实协作周期,不虚构基线或成果。

生成进度与管理记录

微服务实战

Skill 版本:v23

执行模式:light

建档进度:done

本次执行规则:book-workflow v4 / book-notes v23,2026-10-27。历史只有交接而无概览,当前是首次概览,不伪造历史生成版本。

评级:工程实践(高信息浓度、较低稳定性,混合了耐久设计原则)。第1章从内聚、耦合与独立部署解释设计,第3章用分层和准则处理演进,第13章将团队自治与端到端职责相连,均有机制与取舍;但第9章具体依赖Python3.6、Docker镜像和命令,后续Kubernetes、Jenkins及附录安装方式有明显版本依赖,书级以实际部署实践为主。评级只用于描述,不据此略读概念或操作。

评级取样范围:已读译者序、前言及路线图;按4部分分别读取第1章1.1前2600字、第3章3.1前2300字、第9章9.1前2600字、第13章13.1前2300字。只作评级抽样,不把截断或未生成范围标done;全部正文仍按下表完整处理。

整书笔记:_book_note.md,schema1,389张知识卡的逐节讲解、全书导读、主线与综合完成;106/106实质spine、347/347单元及全部配图已读。

来源:book-sources/books/架构归档8/微服务实战.epub;SHA-256 cf7bf75b5832c3e1aead3a51a36a947da12e8615e82a8f6fc05c49ed632f94a5。本轮全新目录以zipfile重新解包442资源,并逐项与活动缓存匹配,117项spine均存在,无加密声明。版权页核实作者、译者、出版社与ISBN;OPF日期2020-04-30无publication事件,中文版权为2019,仅属授权年份,可靠出版日期与版次未知填null。

身份与基线:沿用目录微服务实战与空数据库book_id679,0知识卡、0实践;不并入Kubernetes/Spring或肖睿等其他作者同名书。保留原_workflow及旧确认草案为历史,本次用户完整工作流授权与当前概念取材规则已覆盖MSA217-CONF-001,不再等待重复确认。

章节进度追踪表

章节号 章节标题 状态(pending/done) 卡片数
00 译者序、前言及阅读约定 done 1
01 微服务的设计与运行 done 36
02 SimpleBank公司的微服务 done 25
03 微服务应用的架构 done 30
04 新功能设计 done 28
05 微服务的事务与查询 done 40
06 设计高可靠服务 done 33
07 构建可复用的微服务框架 done 22
08 微服务部署 done 37
09 基于容器和调度器的部署 done 26
10 构建微服务交付流水线 done 29
11 构建监控系统 done 29
12 使用日志和链路追踪了解系统行为 done 24
13 微服务团队建设 done 22
14 附录A 在Minikube上安装Jenkins done 7

非正文排除

spine项 类型 排除理由
001 非正文 封面已查看,只有封面信息,无实质正文。
002 非正文 纯目录及NCX已解析核对全部导航目标,目录不替代正文。
003 非正文 版权信息全文已读,用于ISBN和原书身份。
004 非正文 版权页全文已读,用于作者、译者、出版社。
005 非正文 授权声明全文已读,2018英文版权和2019中文版权不是可靠中文出版日期。
006 非正文 内容提要全文已读,仅总结本书结构和读者对象。
007 非正文 作者简介全文已读,仅作者背景,无本书技术机制。
013 非正文 资源支持全文已读,购书下载页面说明,不执行下载或验证购买信息。
014 非正文 勘误反馈全文已读,无技术正文。
015 非正文 出版商联系及投稿说明全文已读,不执行联系或发送。
016 非正文 异步社区品牌介绍全文已读,无技术正文。

待关联术语

术语名 出现章节 一句话语境

| 中台 | 译者序/前言 | 仅提名或章节预告,待正文展开 | | service mesh | 译者序/前言 | 仅提名或章节预告,待正文展开 | | Monolith First | 译者序/前言 | 仅提名或章节预告,待正文展开 | | Microservice First | 译者序/前言 | 仅提名或章节预告,待正文展开 | | Micro Frontends | 译者序/前言 | 仅提名或章节预告,待正文展开 | | Saga | 译者序/前言 | 仅提名或章节预告,待正文展开 | | API组合 | 译者序/前言 | 仅提名或章节预告,待正文展开 | | CQRS | 译者序/前言 | 仅提名或章节预告,待正文展开 | | 限流 | 译者序/前言 | 仅提名或章节预告,待正文展开 | | 断路器 | 译者序/前言 | 仅提名或章节预告,待正文展开 | | 健康检查 | 译者序/前言 | 仅提名或章节预告,待正文展开 | | 重试 | 译者序/前言 | 仅提名或章节预告,待正文展开 |

| ACID | 1 | 本章列用途或背景,具体机制未展开 | | MVC | 1 | 本章列用途或背景,具体机制未展开 | | 回退 | 1 | 本章列用途或背景,具体机制未展开 | | 服务发现 | 1 | 本章列用途或背景,具体机制未展开 | | 金丝雀部署 | 1 | 本章列用途或背景,具体机制未展开 | | 蓝绿部署 | 1 | 本章列用途或背景,具体机制未展开 |

| HTTP | 2 | 支持同步及异步交互的传输机制,未展开协议 | | MVP | 2 | 已成最小产品完整交付路径卡;保留原缩写便于检索 |

| ISO 27001 | 3 | 仅提名/预告,具体机制未展开 | | 事件溯源 | 3 | 仅提名/预告,具体机制未展开 | | AMQP | 3 | 仅提名/预告,具体机制未展开 | | 限界上下文 | 3 | 仅提名/预告,具体机制未展开 | | Web组件 | 3 | 仅提名/预告,具体机制未展开 | | 客户端包含 | 3 | 仅提名/预告,具体机制未展开 | | iframe | 3 | 仅提名/预告,具体机制未展开 | | ESI | 3 | 仅提名/预告,具体机制未展开 |

| 影响地图 | 4 | 仅提名、方法建议或脚注,未展开机制 | | BDD | 4 | 仅提名、方法建议或脚注,未展开机制 | | 通用语言 | 4 | 仅提名、方法建议或脚注,未展开机制 | | repository模式 | 4 | 仅提名、方法建议或脚注,未展开机制 | | aggregate模式 | 4 | 仅提名、方法建议或脚注,未展开机制 | | factory模式 | 4 | 仅提名、方法建议或脚注,未展开机制 |

| 功能标记 | 7 | 仅列底座能力,未展开策略 |

| IaaS | 8 | 基础设施服务抽象,仅举云平台 | | PaaS | 8 | 托管应用平台抽象,已并入调度模型讲解 |

引用文献

标题 类型(书/论文/框架/源码项目) 出现章节 一句话语境

| Python | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Kubernetes | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Docker | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Google Container Engine | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Jenkins | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Groovy | 源码项目 | 前言 | 教学工具预告,尚未实质展开 | | StatsD | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Prometheus | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Grafana | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Elasticsearch | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Kibana | 框架 | 前言 | 教学工具预告,尚未实质展开 | | Jaeger | 框架 | 前言 | 教学工具预告,尚未实质展开 | | docker-compose | 框架 | 前言 | 教学工具预告,尚未实质展开 |

| 可扩展性的艺术 | 书 | 1 | 扩展立方体来源,三轴已在知识卡解释 | | MonolithFirst | 论文 | 1 | 2015-06-03的历史博客,单体先行论据 | | A long Journey into a Microservice World | 论文 | 1 | Hailo国际化迁移背景 | | How we ended up with microservices | 论文 | 1 | SoundCloud交付生产力背景 | | Building microservice architectures in Go | 论文 | 1 | Monzo采用微服务的历史讨论 | | 没有银弹 | 论文 | 1 | 本质与偶然复杂性的来源 | | Fabric | 框架 | 1 | Python部署工具,仅提名 | | Capistrano | 框架 | 1 | Ruby部署工具,仅提名 | | exrm | 框架 | 1 | Elixir部署工具,仅提名 | | AWS | 框架 | 1 | 可编程基础设施背景 | | Azure | 框架 | 1 | 可编程基础设施背景 |

| RBS could take until weekend to make 600,000 missing payments after glitch | 论文 | 2 | 原书历史新闻引用,数字及日期未作外部核验 | | Royal Bank of Scotland Fined $88 Million Over Technology Failure | 论文 | 2 | 原书历史新闻,标题金额与正文口径不同 | | Site Reliability Engineering | 书 | 2 | 修改引起不可用的历史引述,未当当前统计 | | GCE | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | AWS Formation | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Elastic Beanstalk | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Chef | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Terraform | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Loggly | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Splunk | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Sumo Logic | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | ELK | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 | | Logstash | 框架 | 2 | 基础设施或日志工具,仅提名,未展开实现 |

| Rails | 框架 | 3 | 三层开发框架举例 | | Django | 框架 | 3 | 三层开发框架举例 | | Heroku | 框架 | 3 | 运行时PaaS示例 | | Redis | 框架 | 3 | 代理与队列基础工具,仅提名 | | Resque | 框架 | 3 | 作业队列类库,仅提名 | | Celery | 框架 | 3 | 作业队列类库,仅提名 | | Sidekiq | 框架 | 3 | 作业队列类库,仅提名 | | AWS ELB | 框架 | 3 | DNS负载均衡的历史工具示例 | | Kong | 框架 | 3 | 可选网关,仅提名 | | AWS API Gateway | 框架 | 3 | 可选网关,仅提名 | | Apollo | 框架 | 3 | REST封装GraphQL的实现线索,仅提名 | | Micro Frontends | 框架 | 3 | 原书推荐阅读,未提供展开 | | Mosaic | 框架 | 3 | Zalando项目,仅建议阅读 | | bit.ly/2o86ShQ | 框架 | 3 | 代理负载均衡延伸链接,未访问 |

| 领域驱动设计 | 书 | 4 | Evans同名书,限界上下文分析的来源 | | The Clean Architecture | 论文 | 4 | 2012-08-13文章,本章实体用例适配器参考 | | 六角架构 | 论文 | 4 | 相关架构线索,原书指出与简洁架构并不完全相同 |

| Sagas | 论文 | 5 | 1987年长事务与补偿来源 | | Life Beyond Distributed Transactions | 论文 | 5 | 分布式交互不确定性与业务修正背景 | | Enterprise Integration Patterns: Compensating Action | 书 | 5 | 咖啡补偿案例来源 | | CAP Twelve Years Later: How the Rules Have Changed | 论文 | 5 | 生成时读Brewer2012原文,限定CAP取舍范围 | | Two Hard Thing | 论文 | 5 | 原书缓存难题阅读线索,保留原书写法 | | Troubleshooting Caching Problems | 论文 | 5 | 缓存问题延伸资料,未访问 | | awesome-ddd | 源码项目 | 5 | 延伸资源列表,未访问 | | WS-BPEL | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Conductor | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Step Workflows | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Commanded | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | CQRS.net | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Lagom | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Broadway | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Redshift | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | BigQuery | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | S3 | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Spark | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Presto | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Stream-Framework | 框架 | 5 | 仅列名称或工具例子,未实质展开 | | Reactive Application Development | 书 | 5 | 本章延伸阅读,仅书目信息 | | Microservices Patterns | 书 | 5 | 本章延伸阅读,仅书目信息 | | Event Streams in Action | 书 | 5 | 本章延伸阅读,仅书目信息 |

| Tenacity | 框架 | 6 | 本章重试类库,已生成实质用途卡 | | Requests | 框架 | 6 | HTTP客户端示例,官方核对超时与状态码 | | cachetools | 框架 | 6 | 进程内TTL缓存,已生成实质用途卡 | | Memcached | 框架 | 6 | 外部缓存举例,仅提名 | | Hystrix | 框架 | 6 | 断路器与统一Java通信示例,维护状态仅原书译注 | | CB2 | 框架 | 6 | 断路器类库,仅提名 | | Polly | 框架 | 6 | 断路器类库,仅提名 | | Linkerd | 框架 | 6 | 服务网格示例,本章未核对当前版本 | | Envoy | 框架 | 6 | 通信代理示例,本章未核对当前版本 | | resilience4j | 框架 | 6 | 原书译注替代项目,仅提名 | | 分布式计算的八大谬论 | 论文 | 6 | 原书网络不可靠论据线索 | | Designing robust and predictable APIs with idempotency | 论文 | 6 | 幂等键延伸资料,未访问 | | Exponential Backoff and Jitter | 论文 | 6 | 退避抖动延伸资料,未访问 | | Principles of Chaos Engineering | 论文 | 6 | 原文转述混沌四步,未独立实验 | | Coding Horror: pit of success | 论文 | 6 | 默认易用设计理念的来源 |

| Nameko | 框架 | 7 | 本章Python服务框架,已说明机制及示例 | | nameko-sentry | 框架 | 7 | 错误报告适配类库,已在卡解释用途 | | logstash_formatter | 框架 | 7 | 结构化日志类库,已说明处理器配置 | | circuitbreaker | 框架 | 7 | Python断路器,生成时核对异常匹配 | | gutter | 框架 | 7 | setup依赖,仅提名 | | request-id | 框架 | 7 | setup依赖,仅提名 | | Siege | 框架 | 7 | 本地入口压测工具,只记录原书示例范围 | | Measure Anything, Measure Everything | 论文 | 7 | StatsD延伸阅读,未访问 |

| 十二要素应用宣言 | 论文 | 8 | 配置与代码分离来源,未访问 | | Packer | 框架 | 8 | 镜像构建工具,本章已说明四步用途 | | py2deb | 框架 | 8 | OS打包延伸工具,仅提名 | | HAProxy | 框架 | 8 | 软件负载均衡示例,仅提名 | | CircleCI | 框架 | 8 | 自动构建工具,仅提名 | | rkt | 框架 | 8 | 历史容器例子,不作当前推荐 | | Vault | 框架 | 8 | 受限凭据存储示例,未核对当前规格 | | Ansible | 框架 | 8 | gcloud替代工具线索,未展开 |

| OCI | 源码项目 | 9 | 容器标准化组织,仅背景 | | Docker Swarm | 框架 | 9 | 调度器例子,未展开 | | Apache Mesos | 框架 | 9 | 调度器例子,未展开 | | Borg | 框架 | 9 | Kubernetes历史线索,未展开 | | Omega | 框架 | 9 | Kubernetes历史线索,未展开 | | Clair | 框架 | 9 | 安全扫描工具,仅提名 | | Minikube | 框架 | 9 | 本地Kubernetes演示载体,未当前安装验证 | | GKE | 框架 | 9 | 托管集群示例,未核对当前规格 | | BusyBox | 框架 | 9 | 临时诊断示例,未运行 | | buildpack-deps | 源码项目 | 9 | 历史Python基础镜像链 | | mng.bz/JxDj | 源码项目 | 9 | 原书Dockerfile短链接,未访问 |

| Jenkins Job DSL | 框架 | 10 | 生成任务配置,与Pipeline区分 | | ksonnet | 框架 | 10 | 历史模板工具提名,未当前验证 | | Travis CI | 框架 | 10 | YAML构建配置例子 | | Drone CI | 框架 | 10 | YAML构建配置例子 | | Flipper | 框架 | 10 | 功能标记例子,未深读实现 | | Togglz | 框架 | 10 | 功能标记例子,未深读实现 | | Scientist gem | 源码项目 | 10 | 原文只讲GitHub授权重构回归用途,未深读源码 |

| Prometheus | 框架 | 11 | 指标抓取存储查询告警载体,历史配置范围 | | Grafana | 框架 | 11 | 指标数据源面板及告警演示,非当前UI教程 | | prometheus/statsd_exporter | 源码项目 | 11 | StatsD转指标及单位语法核对 | | Graphite | 框架 | 11 | Grafana数据源提名,未展开 | | InfluxDB | 框架 | 11 | Grafana数据源提名,未展开 |

| Elasticsearch | 框架 | 12 | 日志索引查询,未当前部署 | | Kibana | 框架 | 12 | 集中日志界面,历史UI | | Fluentd | 框架 | 12 | 收集转发及配置核对 | | OpenTracing | 框架 | 12 | 本书历史追踪API,已注明归档与迁移背景 | | Jaeger | 框架 | 12 | 历史all-in-one追踪演示 | | Dapper | 论文 | 12 | 追踪系统背景提名 | | Zipkin | 框架 | 12 | 追踪系统及协议例子 | | HTrace | 框架 | 12 | 追踪系统背景提名 | | X-Trace | 框架 | 12 | 追踪系统背景提名 | | jsontest.com | 源码项目 | 12 | 原书外部HTTP示例,未访问或测试 |

| 微服务之道 | 书 | 13 | Richard Rodger;组织政治与变更参考 | | Elastic Leadership | 书 | 13 | Roy Osherove;ISBN9781617293085,仅题录 | | Managing Humans | 书 | 13 | Michael Lopp;ISBN9781430243144,仅题录 | | Managing the Unmanageable | 书 | 13 | Mantle/Lichty;ISBN9780321822031,仅题录 | | PeopleWare | 书 | 13 | DeMarco/Lister;ISBN9780932633439,仅题录 | | Products Over Projects | 论文 | 13 | Sriram Narayan 2018-02-20,产品模式参考 | | Scaling Agile @ Spotify with Tribes, Squads, Chapters & Guilds | 论文 | 13 | Henrik Kniberg 2012-11-14,历史社区实践 | | Tracking Service Infrastructure at Scale | 论文 | 13 | John Arthorne 2017 SRECon,service.yml线索 | | MkDocs | 框架 | 13 | 服务文档工具提名,未部署 | | Swagger UI | 框架 | 13 | 由接口描述生成文档参考 | | Dependabot | 框架 | 13 | 依赖扫描参考,未当前评测 |

| Helm | 框架 | 附录A | Chart与Tiller属于Helm 2范围,已区别Helm 3 | | stable/jenkins | 框架 | 附录A | 历史chart安装示例,未执行或当当前仓库 |

资金安全问题案例

问题标题 问题卡 解决方案卡(如有) 出现章节 一句话说明

| 出售中的持仓可能重复占用 | 出售中的持仓可能重复占用 | 预留持仓防止重复出售 | 1 | 原文具体资金并发问题及方案,分卡互链 |

| 外部支付完成前不应发布策略订单 | —(原书仅说明到账前提,未展开并发错误根因,不补造问题卡) | 支付完成后才生成策略订单 | 4 | 仅保留原文实际给出的到账后继续方案;未给出幂等与金额校验算法 |

| 收费失败留下订单和持仓占用 | 收费失败留下订单和持仓占用 | 撤销预留修复收费失败 | 5 | 原文具体资金并发问题及方案,分卡互链 |

| 市场提交失败留下已收费状态 | 市场提交失败留下已收费状态 | 失败事件触发退费与释放 | 5 | 原文具体资金并发问题及方案,分卡互链 |

| 补偿重试可能重复退费 | 补偿重试可能重复退费 | 让补偿具备安全重试语义 | 5 | 原文具体资金并发问题及方案,分卡互链 |

| 取消与下单流程可能交织 | 取消与下单流程可能交织 | 提交前复查订单取消状态 | 5 | 原文具体资金并发问题及方案,分卡互链 |

| 并行Saga争锁可能死锁 | 并行Saga争锁可能死锁 | 监控和超时处置Saga等待 | 5 | 原文具体资金并发问题及方案,分卡互链 |

| 离线提款可能超出账户余额 | 离线提款可能超出账户余额 | 离线限额控制透支风险 | 5 | 原文具体资金并发问题及方案,分卡互链 |

实践卡进度

序号 实践标题 实践方式 状态(pending/done) 关联章节 产出
001 深读指标映射与聚合 实现深读 done 11 idea-001-深读指标映射与聚合.md;已填首轮映射
002 深读消息确认与重投 实现深读 done 6、7 idea-002-深读消息确认与重投.md;已填首轮映射

实践候选筛选:done

优先深读指标映射与消息确认,两项分别验证统计转换和消费结果,已有固定成熟实现,完整实践尚未执行。未独立采用自建Jenkins平台、重写Saga框架或全量SimpleBank部署:重复实现及旧版本依赖会增加成本,先以成熟源码回答机制问题;金融案例只作阅读与模拟理解,未做真实交易。团队文档和轮值实验留待有真实协作对象与周期时再立项,不伪造行为基线或结果。light未执行生成后笔记复核、独立审查及审查结果优化。

生成完成范围:389张知识卡,每卡一个primary与至少一处有效原书证据,共394个位置/出处;2项实现深读计划与首轮材料。前期登记“待展开/尚未展开”描述其出现位置当时的提名性质,后续对应机制已逐节取材,不作全书未读判断。light未执行生成后复核、独立审查及审查结果优化。待原生CLI来源格式校验放行,生产导入和归档尚未执行,不提前更新总表v23。

主题索引维护

按 book-topics v4 逐卡判断并归入「架构/系统设计」主题树(L1 software-architecture)。本书为教材型,采用章级默认映射 + 逐卡覆盖:15 章全部判读,389 张知识卡逐张给出结论,386 张复用 71 个既有主题,3 张无需加入;未新建主题(现有叶子均可直接容纳)。主题真源为 notes/_topics/*.md,经 topics validate → sync → check 校验一致。

卡片标题 结论(已复用/已创建/无需加入/待复核) 主题文件或原因
[[微服务交付覆盖全生命周期]] 无需加入 前言泛述,未给可跨书对照的机制
[[微服务以独立功能协作]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[用变更原因判断内聚]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[服务拥有自己的数据]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[出售中的持仓可能重复占用]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[预留持仓防止重复出售]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[出售订单跨服务协作]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[编排逻辑留在服务中]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[扩展立方体区分三个维度]] 已复用 notes/_topics/scalability-dimensions.md
[[按功能选择技术和资源]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[自治依赖契约和独立部署]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[故障隔离需要恢复设计]] 已复用 notes/_topics/high-availability-architecture.md
[[透明性让协作行为可诊断]] 已复用 notes/_topics/observability-engineering.md
[[自动化抵消服务管理成本]] 已复用 notes/_topics/toil-automation.md
[[沿业务纵向划分服务]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[向后兼容保护消费方节奏]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[迁移压力决定拆分动机]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[区分本质与偶然复杂性]] 已复用 notes/_topics/simplicity-complexity.md
[[变更周期耦合拖慢交付]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[小变更降低单次发布风险]] 已复用 notes/_topics/change-release-safety.md
[[整体重写迁移风险集中]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[服务边界错误迁移代价高]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[契约需完整简洁可预测]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[团队自治仍需共同优先级]] 已复用 notes/_topics/org-architecture-alignment.md
[[网络调用改变失败假设]] 已复用 notes/_topics/faults-partial-failure-clocks.md
[[拆分把部分成本移向运维]] 已复用 notes/_topics/devops-adoption.md
[[关联局部数据才能看见全局]] 已复用 notes/_topics/observability-engineering.md
[[按组件必然失效设计系统]] 已复用 notes/_topics/high-availability-architecture.md
[[设计部署监控形成反馈环]] 已复用 notes/_topics/observability-engineering.md
[[单体先行取决于边界认知]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[新功能不必立即新建服务]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[同步异步权衡恢复与诊断]] 已复用 notes/_topics/remote-interface-distribution.md
[[容器标准化服务运行界面]] 已复用 notes/_topics/container-orchestration.md
[[持续交付需要验证与自动化]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[监控结果反哺局部降级]] 已复用 notes/_topics/overload-protection-degradation.md
[[围绕业务功能建立观测层]] 已复用 notes/_topics/observability-engineering.md
[[沟通结构约束服务边界]] 已复用 notes/_topics/org-architecture-alignment.md
[[领域总览先于服务划分]] 已复用 notes/_topics/ddd-strategic-design.md
[[独立税务规则减少发布牵连]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[架构选择还要看团队知识]] 已复用 notes/_topics/org-architecture-alignment.md
[[最小产品验证完整交付路径]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[功能组合成业务能力]] 已复用 notes/_topics/ddd-strategic-design.md
[[按变化驱动力分离市场操作]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[先保留内聚再逐步细拆]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[机器可读契约支持跨团队协作]] 已复用 notes/_topics/openapi-contract-schema-validation.md
[[接口规范显式描述服务契约]] 已复用 notes/_topics/openapi-contract-schema-validation.md
[[协调者膨胀会增加变更耦合]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[命令协调与事件协作有取舍]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[用订单事件分散协作职责]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[创建提交成交是不同状态]] 已复用 notes/_topics/state-activity-modeling.md
[[事件恢复依赖持久化与追踪]] 已复用 notes/_topics/message-brokers-event-logs.md
[[消息队列承接事件分发]] 已复用 notes/_topics/message-brokers-event-logs.md
[[网关为外部应用提供门面]] 已复用 notes/_topics/service-discovery-gateway.md
[[统一网关易积累冲突需求]] 已复用 notes/_topics/service-discovery-gateway.md
[[知识集中降低巴士系数]] 已复用 notes/_topics/org-architecture-alignment.md
[[生产就绪需要运行证据]] 已复用 notes/_topics/service-governance.md
[[标准化研发与发布获得信任]] 已复用 notes/_topics/devops-adoption.md
[[按故障领域检查服务依赖]] 已复用 notes/_topics/high-availability-architecture.md
[[集中日志缩短跨服务定位]] 已复用 notes/_topics/observability-logs.md
[[健康检测和服务目标互补]] 已复用 notes/_topics/slo-error-budget.md
[[统一诊断字段降低技术分歧]] 已复用 notes/_topics/observability-logs.md
[[局部专业化可能形成团队孤岛]] 已复用 notes/_topics/org-architecture-alignment.md
[[架构还要规划服务环境]] 已复用 notes/_topics/infrastructure-design-process.md
[[架构师保障系统持续演进]] 已复用 notes/_topics/org-architecture-alignment.md
[[准则把目标连接到实践]] 已复用 notes/_topics/architecture-principles-complexity.md
[[四层模型分配架构职责]] 已复用 notes/_topics/layered-architecture-ports.md
[[平台封装共同运行能力]] 已复用 notes/_topics/infrastructure-design-process.md
[[运行时目标只是平台基础]] 已复用 notes/_topics/infrastructure-design-process.md
[[技术能力支撑业务能力]] 已复用 notes/_topics/business-architecture-modeling.md
[[聚合器查询协调器发命令]] 已复用 notes/_topics/enterprise-integration-patterns.md
[[沿业务路径评估关键依赖]] 已复用 notes/_topics/high-availability-architecture.md
[[智能端点保持管道简单]] 已复用 notes/_topics/enterprise-integration-patterns.md
[[同步用于后续必需的结果]] 已复用 notes/_topics/remote-interface-distribution.md
[[传输机制与业务逻辑分离]] 已复用 notes/_topics/layered-architecture-ports.md
[[生成契约连接两端实现]] 已复用 notes/_topics/openapi-contract-schema-validation.md
[[同步等待可能耗尽执行资源]] 已复用 notes/_topics/thread-pool-capacity-overload.md
[[事件描述已经发生的变化]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[事件中枢负责接收和分发]] 已复用 notes/_topics/message-brokers-event-logs.md
[[事件存储与消息代理侧重不同]] 已复用 notes/_topics/message-brokers-event-logs.md
[[作业队列让消费者分担任务]] 已复用 notes/_topics/message-brokers-event-logs.md
[[发布订阅让各用途响应同一事实]] 已复用 notes/_topics/message-brokers-event-logs.md
[[服务发现把名称解析为可用实例]] 已复用 notes/_topics/service-discovery-gateway.md
[[注册中心集中提供实例位置]] 已复用 notes/_topics/service-discovery-gateway.md
[[边界隐藏内部变化并适配客户端]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[边缘能力集中不替代领域规则]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[网关入口配合限制后端暴露]] 已复用 notes/_topics/service-discovery-gateway.md
[[按客户端分设后端门面]] 已复用 notes/_topics/service-discovery-gateway.md
[[查询语言让消费者选择响应字段]] 已复用 notes/_topics/graphql-schema-query-execution.md
[[对象查询须选到叶字段]] 已复用 notes/_topics/graphql-schema-query-execution.md
[[账户查询结构组合订单持仓]] 已复用 notes/_topics/graphql-schema-query-execution.md
[[前端单体仍会限制端到端交付]] 已复用 notes/_topics/micro-frontends-business-units.md
[[微前端组合独立界面片段]] 已复用 notes/_topics/micro-frontends-business-units.md
[[从问题到用例再验证服务边界]] 已复用 notes/_topics/use-cases-requirements.md
[[服务划界组合三种观察角度]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[限界上下文统一局部模型含义]] 已复用 notes/_topics/ddd-strategic-design.md
[[领域驱动设计维护共享业务模型]] 已复用 notes/_topics/ddd-strategic-design.md
[[相同实体在上下文中角色不同]] 已复用 notes/_topics/ddd-strategic-design.md
[[投资策略能力不属于账户订单]] 已复用 notes/_topics/ddd-strategic-design.md
[[策略接口分开创建输入与结果]] 已复用 notes/_topics/openapi-contract-schema-validation.md
[[用接口和事件界定服务契约]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[内部边界为未来拆分留接缝]] 已复用 notes/_topics/modularity-information-hiding.md
[[持续增长会改变最初服务职责]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[用例服务封装复杂跨域动作]] 已复用 notes/_topics/domain-logic-organization.md
[[支付完成后才生成策略订单]] 无需加入 单书案例内的时序约束,未展开通用机制
[[策略下单与收款分别拥有职责]] 已复用 notes/_topics/ddd-strategic-design.md
[[用例记录关联并追踪整体结果]] 已复用 notes/_topics/domain-logic-organization.md
[[动作共用实体仍需权威所有者]] 已复用 notes/_topics/ddd-tactical-modeling.md
[[实体用例适配器隔离实现细节]] 已复用 notes/_topics/layered-architecture-ports.md
[[用例可同时命令和响应事件]] 已复用 notes/_topics/domain-logic-organization.md
[[隔离独立变化限制影响范围]] 已复用 notes/_topics/component-cohesion-coupling.md
[[稳定依赖约束变化传播]] 已复用 notes/_topics/component-cohesion-coupling.md
[[未来可塑性与不过度设计平衡]] 已复用 notes/_topics/simplicity-complexity.md
[[通知能力独立于支付处理]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[技术服务拆分须保留自治]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[模块接口先为本地调整服务]] 已复用 notes/_topics/modularity-information-hiding.md
[[扩展迁移收缩有序替换服务]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[迁移消费者需要处理团队激励]] 已复用 notes/_topics/org-architecture-alignment.md
[[所有权拆分降低直接控制能力]] 已复用 notes/_topics/org-architecture-alignment.md
[[共享代码知识减少团队阻碍]] 已复用 notes/_topics/org-architecture-alignment.md
[[避免复用绑死团队发布节奏]] 已复用 notes/_topics/org-architecture-alignment.md
[[收费失败留下订单和持仓占用]] 已复用 notes/_topics/distributed-transactions.md
[[撤销预留修复收费失败]] 已复用 notes/_topics/distributed-transactions.md
[[两阶段提交协调共同决定]] 已复用 notes/_topics/distributed-transactions.md
[[长事务持锁增加资源等待]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[最终一致性需要明确中间态]] 已复用 notes/_topics/consistency-models.md
[[市场提交等待两个业务前提]] 无需加入 单书案例的前置条件描述,未给通用机制
[[单体发事件支持渐进扩展]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[Saga组合本地事务与补偿]] 已复用 notes/_topics/distributed-transactions.md
[[补偿恢复业务含义而非原状态]] 已复用 notes/_topics/distributed-transactions.md
[[市场提交失败留下已收费状态]] 已复用 notes/_topics/distributed-transactions.md
[[失败事件触发退费与释放]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[无中心流程增加状态追踪成本]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[协调型Saga记录每步执行状态]] 已复用 notes/_topics/distributed-transactions.md
[[补偿进度不等于即时到账]] 已复用 notes/_topics/distributed-transactions.md
[[补偿重试可能重复退费]] 已复用 notes/_topics/distributed-transactions.md
[[让补偿具备安全重试语义]] 已复用 notes/_topics/distributed-transactions.md
[[协调器集中顺序但可能架空服务]] 已复用 notes/_topics/distributed-transactions.md
[[取消与下单流程可能交织]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[提交前复查订单取消状态]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[拒绝交织可简化Saga语义]] 已复用 notes/_topics/distributed-transactions.md
[[预留和锁限制并行实体修改]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[并行Saga争锁可能死锁]] 已复用 notes/_topics/distributed-transactions.md
[[监控和超时处置Saga等待]] 已复用 notes/_topics/distributed-transactions.md
[[按业务含义选择一致性策略]] 已复用 notes/_topics/consistency-models.md
[[事件历史重建实体状态]] 已复用 notes/_topics/domain-events-eventual-consistency.md
[[事件溯源与查询投影可以分工]] 已复用 notes/_topics/cqrs-read-write-models.md
[[API组合适合有限数据关联]] 已复用 notes/_topics/cqrs-read-write-models.md
[[分页批量减少逐项远程调用]] 已复用 notes/_topics/remote-interface-distribution.md
[[事件副本减少查询依赖]] 已复用 notes/_topics/cqrs-read-write-models.md
[[分区取舍应细到具体操作]] 已复用 notes/_topics/distributed-data-sharding.md
[[离线提款可能超出账户余额]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[离线限额控制透支风险]] 已复用 notes/_topics/transactions-offline-concurrency.md
[[CQRS分开更新与查询模型]] 已复用 notes/_topics/cqrs-read-write-models.md
[[事件处理器维护专门读模型]] 已复用 notes/_topics/cqrs-read-write-models.md
[[复合查询服务汇合多个领域]] 已复用 notes/_topics/cqrs-read-write-models.md
[[写入确认可能早于查询可见]] 已复用 notes/_topics/cqrs-read-write-models.md
[[乐观界面先展示预期结果]] 已复用 notes/_topics/cqrs-read-write-models.md
[[按进度版本等待读模型追平]] 已复用 notes/_topics/cqrs-read-write-models.md
[[由读模型更新通知驱动界面]] 已复用 notes/_topics/cqrs-read-write-models.md
[[事件流为分析构建独立数据集]] 已复用 notes/_topics/dataflow-unbundled-databases.md
[[可用性必须固定测量口径]] 已复用 notes/_topics/slo-error-budget.md
[[依赖乘积模型需要独立假设]] 已复用 notes/_topics/high-availability-architecture.md
[[按风险影响排序恢复投入]] 已复用 notes/_topics/high-availability-architecture.md
[[沿四类交互识别故障源]] 已复用 notes/_topics/faults-partial-failure-clocks.md
[[冗余应跨实际故障范围]] 已复用 notes/_topics/high-availability-architecture.md
[[配置变更也要验证与回滚]] 已复用 notes/_topics/change-release-safety.md
[[接口下线也是依赖故障]] 已复用 notes/_topics/service-adaptation-compatibility.md
[[重试正反馈放大局部过载]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[重试先判断操作是否重复安全]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[重试需要次数与时间预算]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[指数退避加抖动分散重试]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[重试库组合停止等待与日志]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[客户端集中远程访问适配]] 已复用 notes/_topics/remote-interface-distribution.md
[[降级保留可独立提供的功能]] 已复用 notes/_topics/overload-protection-degradation.md
[[缓存以陈旧窗口换读取依赖]] 已复用 notes/_topics/caching-strategies.md
[[TTL缓存装饰重复读取方法]] 已复用 notes/_topics/caching-strategies.md
[[后备服务需避开共同故障]] 已复用 notes/_topics/high-availability-architecture.md
[[默认桩数据只适合允许替代的用途]] 已复用 notes/_topics/fail-safe-defaults.md
[[读取超时不是整次请求期限]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[传播剩余期限减少无用等待]] 已复用 notes/_topics/rpc-retry-timeouts.md
[[断路器用快速失败隔离坏依赖]] 已复用 notes/_topics/overload-protection-degradation.md
[[半开探测决定是否恢复调用]] 已复用 notes/_topics/overload-protection-degradation.md
[[熔断统计需要样本与窗口]] 已复用 notes/_topics/overload-protection-degradation.md
[[存活与就绪回答不同问题]] 已复用 notes/_topics/container-orchestration.md
[[二值健康无法描述全部负载]] 已复用 notes/_topics/observability-metrics.md
[[限流按容量和优先级分配请求]] 已复用 notes/_topics/overload-protection-degradation.md
[[背压把下游余量反馈给上游]] 已复用 notes/_topics/stream-processing-backpressure.md
[[容量估算随业务流量修正]] 已复用 notes/_topics/capacity-scheduling.md
[[单服务与链路压力测试互补]] 已复用 notes/_topics/testing-effectiveness.md
[[混沌实验尝试推翻恢复假设]] 已复用 notes/_topics/chaos-engineering.md
[[让正确通信成为默认路径]] 已复用 notes/_topics/fail-safe-defaults.md
[[共享通信库统一调用策略]] 已复用 notes/_topics/service-mesh.md
[[服务网格把通信策略放到代理]] 已复用 notes/_topics/service-mesh.md
[[底座复用组织已验证的经验]] 已复用 notes/_topics/service-governance.md
[[统一运行约定不必统一语言]] 已复用 notes/_topics/service-governance.md
[[把新发现反馈到底座降低重复风险]] 已复用 notes/_topics/service-governance.md
[[快速启动让原型更便于取舍]] 已复用 notes/_topics/service-governance.md
[[框架提供机制底座补齐组织约定]] 已复用 notes/_topics/extensible-application-architecture.md
[[受理响应不能代表后台完成]] 已复用 notes/_topics/async-composition.md
[[消息代理也可承载请求响应]] 已复用 notes/_topics/message-brokers-event-logs.md
[[代理对象隐藏RPC传输细节]] 已复用 notes/_topics/rpc-framework-mechanics.md
[[事件订阅按来源与事件名绑定]] 已复用 notes/_topics/message-brokers-event-logs.md
[[可观测性应进入服务初始结构]] 已复用 notes/_topics/observability-engineering.md
[[指标计时连接方法与运行行为]] 已复用 notes/_topics/observability-metrics.md
[[指标代理与演示打印器有区别]] 已复用 notes/_topics/observability-metrics.md
[[异常报告保留错误上下文]] 已复用 notes/_topics/error-handling-mechanisms.md
[[HTTP处理器与错误报告协作]] 已复用 notes/_topics/error-handling-mechanisms.md
[[日志格式化集中补齐通用字段]] 已复用 notes/_topics/observability-logs.md
[[处理器和格式器分工输出日志]] 已复用 notes/_topics/observability-logs.md
[[增加消费者扩容仍需检查瓶颈]] 已复用 notes/_topics/capacity-scheduling.md
[[预取限制未确认消息窗口]] 已复用 notes/_topics/message-brokers-event-logs.md
[[断路器异常分类须匹配客户端]] 已复用 notes/_topics/overload-protection-degradation.md
[[队列积压不自动等于安全重试]] 已复用 notes/_topics/message-brokers-event-logs.md
[[入口压测成功不代表后台追平]] 已复用 notes/_topics/testing-effectiveness.md
[[底座应降低选择成本而非锁定团队]] 已复用 notes/_topics/service-governance.md
[[发布独立还要避免构建耦合]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[生产平台组合六类运行责任]] 已复用 notes/_topics/infrastructure-design-process.md
[[资源交付速度影响服务拆分成本]] 已复用 notes/_topics/infrastructure-as-code.md
[[项目边界集中管理演示资源]] 已复用 notes/_topics/infrastructure-as-code.md
[[启动脚本混合构建与运行工作]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[实例运行和网络可达分开验证]] 已复用 notes/_topics/infrastructure-as-code.md
[[模板实例组维护同类服务副本]] 已复用 notes/_topics/infrastructure-as-code.md
[[以模板创建和调整服务组]] 已复用 notes/_topics/infrastructure-as-code.md
[[跨区实例仍需预留故障容量]] 已复用 notes/_topics/high-availability-architecture.md
[[自愈恢复目标数仍有恢复窗口]] 已复用 notes/_topics/high-availability-architecture.md
[[健康检查策略绑定到实例组]] 已复用 notes/_topics/infrastructure-as-code.md
[[副本扩容还需指标与路由支撑]] 已复用 notes/_topics/capacity-scheduling.md
[[负载均衡路由链需要后端绑定]] 已复用 notes/_topics/load-balancing.md
[[先完整关联资源再验证入口]] 已复用 notes/_topics/infrastructure-as-code.md
[[启动时拉最新代码造成版本漂移]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[构建一次工件再部署多处]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[工件边界需要覆盖隐式依赖]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[不可变工件减少隐含变更]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[替换主机减少配置漂移]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[系统软件包统一安装仍依赖宿主]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[虚拟机镜像固定更大执行环境]] 已复用 notes/_topics/virtualization-architecture.md
[[镜像标签需对应真实构建输入]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[容器镜像封装用户态运行依赖]] 已复用 notes/_topics/container-orchestration.md
[[镜像构建指令分离安装和启动]] 已复用 notes/_topics/container-orchestration.md
[[声明端口不等于发布端口]] 已复用 notes/_topics/container-orchestration.md
[[工件仓库存放可部署镜像]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[运行配置与敏感凭据分开管理]] 已复用 notes/_topics/secrets-credential-management.md
[[环境无关工件仍需绑定配置版本]] 已复用 notes/_topics/centralized-config-management.md
[[一服务一主机简化运行归属]] 已复用 notes/_topics/infrastructure-design-process.md
[[静态共用宿主增加运行耦合]] 已复用 notes/_topics/container-orchestration.md
[[调度器按资源需求放置容器]] 已复用 notes/_topics/container-orchestration.md
[[调度平台收益取决于运维能力]] 已复用 notes/_topics/container-orchestration.md
[[滚动发布在新旧共存中保容量]] 已复用 notes/_topics/change-release-safety.md
[[金丝雀先用有限流量获得反馈]] 已复用 notes/_topics/change-release-safety.md
[[蓝绿切换仍需处理状态兼容]] 已复用 notes/_topics/change-release-safety.md
[[发布回退还要修复业务状态]] 已复用 notes/_topics/change-release-safety.md
[[模板版本驱动试点推广与回退]] 已复用 notes/_topics/infrastructure-as-code.md
[[镜像层复用共同构建内容]] 已复用 notes/_topics/container-orchestration.md
[[拉取运行与检查镜像分工]] 已复用 notes/_topics/container-orchestration.md
[[先复制依赖启动才构成运行工件]] 已复用 notes/_topics/container-orchestration.md
[[构建环境可与运行镜像分开]] 已复用 notes/_topics/container-orchestration.md
[[基础镜像也需维护和核验]] 已复用 notes/_topics/container-orchestration.md
[[容器内网络与宿主发布分开]] 已复用 notes/_topics/virtual-networking.md
[[网络代理配置与镜像分离]] 已复用 notes/_topics/container-orchestration.md
[[镜像分发先明确仓库与内容身份]] 已复用 notes/_topics/container-orchestration.md
[[Pod是共同调度的部署单元]] 已复用 notes/_topics/container-orchestration.md
[[控制器持续调和期望副本数]] 已复用 notes/_topics/container-orchestration.md
[[声明资源前核对API与选择器]] 已复用 notes/_topics/container-orchestration.md
[[服务按标签提供稳定访问]] 已复用 notes/_topics/container-orchestration.md
[[服务端口与节点入口层次不同]] 已复用 notes/_topics/container-orchestration.md
[[控制面组件分别管理状态与决策]] 已复用 notes/_topics/container-orchestration.md
[[节点代理落实容器运行状态]] 已复用 notes/_topics/container-orchestration.md
[[组件监听资源变化各自推进]] 已复用 notes/_topics/container-orchestration.md
[[资源创建与容器启动相隔多步]] 已复用 notes/_topics/container-orchestration.md
[[探针失败动作由职责决定]] 已复用 notes/_topics/container-orchestration.md
[[重启退避不代表删除Pod]] 已复用 notes/_topics/container-orchestration.md
[[探针模板变更不自动更新旧实例]] 已复用 notes/_topics/container-orchestration.md
[[部署对象管理版本替换]] 已复用 notes/_topics/container-orchestration.md
[[金丝雀入口可跨两个管理组]] 已复用 notes/_topics/service-routing-traffic.md
[[滚动预算约束可用与额外副本]] 已复用 notes/_topics/change-release-safety.md
[[修订回退不回滚持久业务数据]] 已复用 notes/_topics/change-release-safety.md
[[服务DNS隔开逻辑与位置]] 已复用 notes/_topics/service-discovery-gateway.md
[[用临时诊断环境检查服务解析]] 已复用 notes/_topics/service-discovery-gateway.md
[[交付一致性降低操作差异]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[小批次交付缩短反馈回路]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[持续交付保留上线决策]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[流水线按阶段保留失败反馈]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[编排工具连接现有交付能力]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[控制节点与执行工作区分工]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[流水线脚本随服务代码演进]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[多分支任务按仓库分支建流水线]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[构建代理封装所需工具]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[宿主套接字不是独立构建器]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[构建标签还需关联真实内容]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[测试门禁先保证失败停止]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[测试报告必须真正写出再归档]] 已复用 notes/_topics/testing-effectiveness.md
[[发布工件要具备写仓库权限]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[预发布验证补足服务协作]] 已复用 notes/_topics/testing-effectiveness.md
[[命名空间隔离仍需其他边界]] 已复用 notes/_topics/container-orchestration.md
[[提交部署后仍需等待就绪]] 已复用 notes/_topics/change-release-safety.md
[[预发布保留代表性而非等规模]] 已复用 notes/_topics/testing-effectiveness.md
[[共享与临时测试环境互补]] 已复用 notes/_topics/testing-effectiveness.md
[[生产门禁需串联观测和处置]] 已复用 notes/_topics/change-release-safety.md
[[中止被捕获后须阻止继续上线]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[封装部署要贯通命名空间]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[金丝雀必须接入真实目标流量]] 已复用 notes/_topics/change-release-safety.md
[[平台共性减少重复交付实现]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[流水线声明意图复用执行细节]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[部署版本与开放功能分开决策]] 已复用 notes/_topics/change-release-safety.md
[[暗发布先验证而不暴露结果]] 已复用 notes/_topics/change-release-safety.md
[[功能标记按用户控制可见性]] 已复用 notes/_topics/change-release-safety.md
[[集中功能配置降低跨服务协调]] 已复用 notes/_topics/centralized-config-management.md
[[监控信号串起采集存储与分析]] 已复用 notes/_topics/observability-metrics.md
[[分层监控避免只见局部正常]] 已复用 notes/_topics/observability-metrics.md
[[队列数量要结合流入流出解释]] 已复用 notes/_topics/observability-metrics.md
[[黄金信号从需求结果看承载]] 已复用 notes/_topics/observability-metrics.md
[[成功和失败时延应分开观察]] 已复用 notes/_topics/observability-metrics.md
[[错误率要包含业务结果错误]] 已复用 notes/_topics/observability-metrics.md
[[流量指标按系统需求定义]] 已复用 notes/_topics/observability-metrics.md
[[饱和度表示有限资源压力]] 已复用 notes/_topics/observability-metrics.md
[[计数器累计事件并考虑重置]] 已复用 notes/_topics/observability-metrics.md
[[计量器描述可升降的当前值]] 已复用 notes/_topics/observability-metrics.md
[[直方图保留观测分布]] 已复用 notes/_topics/observability-metrics.md
[[顶层面板先回答服务是否正常]] 已复用 notes/_topics/observability-metrics.md
[[百分位目标应对应业务窗口]] 已复用 notes/_topics/observability-metrics.md
[[标签上下文要控制基数]] 已复用 notes/_topics/observability-metrics.md
[[指标命名统一语义和单位]] 已复用 notes/_topics/observability-metrics.md
[[推送指标可经导出器被拉取]] 已复用 notes/_topics/observability-metrics.md
[[监控容器连通先核对实际配置]] 已复用 notes/_topics/observability-metrics.md
[[导出映射统一名称保留服务标签]] 已复用 notes/_topics/observability-metrics.md
[[客户端分位不能直接跨实例平均]] 已复用 notes/_topics/observability-metrics.md
[[抓取目标与规则评估周期分开]] 已复用 notes/_topics/observability-metrics.md
[[面板数据源地址按查询方确定]] 已复用 notes/_topics/observability-metrics.md
[[基础设施面板补足业务依赖]] 已复用 notes/_topics/observability-metrics.md
[[业务面板串联各阶段耗时]] 已复用 notes/_topics/observability-metrics.md
[[告警条件要区分窗口聚合]] 已复用 notes/_topics/observability-alerting.md
[[通知接收与自动扩容不同]] 已复用 notes/_topics/observability-alerting.md
[[可执行告警需要行动和接收者]] 已复用 notes/_topics/observability-alerting.md
[[告警按紧急程度路由和升级]] 已复用 notes/_topics/observability-alerting.md
[[用户症状比猜测根因更适合呼叫]] 已复用 notes/_topics/observability-alerting.md
[[跨服务比值先对齐业务口径]] 已复用 notes/_topics/observability-metrics.md
[[集中检索与日志持久分开保证]] 已复用 notes/_topics/observability-logs.md
[[日志格式约定降低跨源处理成本]] 已复用 notes/_topics/observability-logs.md
[[日志时间统一仍有时钟误差]] 已复用 notes/_topics/observability-logs.md
[[关联标识贯通请求与业务实体]] 已复用 notes/_topics/observability-logs.md
[[来源字段缩小日志定位范围]] 已复用 notes/_topics/observability-logs.md
[[日志等级支持筛选与路由]] 已复用 notes/_topics/observability-logs.md
[[结构化单行保留事件边界]] 已复用 notes/_topics/observability-logs.md
[[日志创建毫秒不是操作耗时]] 已复用 notes/_topics/observability-logs.md
[[标准输出与收集转发职责分开]] 已复用 notes/_topics/observability-logs.md
[[搜索存储与展示界面各有责任]] 已复用 notes/_topics/observability-logs.md
[[日志驱动连接地址属于宿主环境]] 已复用 notes/_topics/observability-logs.md
[[日志路由匹配与内容解析分开]] 已复用 notes/_topics/observability-logs.md
[[日志详细性通过等级与处理器控制]] 已复用 notes/_topics/observability-logs.md
[[索引与时间窗决定日志可见性]] 已复用 notes/_topics/observability-logs.md
[[日志关联不等于执行完整证明]] 已复用 notes/_topics/observability-logs.md
[[日志敏感数据优先在源头减少]] 已复用 notes/_topics/observability-logs.md
[[追踪接口抽象不等于后端协议通用]] 已复用 notes/_topics/observability-tracing.md
[[追踪由操作片段和因果引用组成]] 已复用 notes/_topics/observability-tracing.md
[[上下文传播连接不同进程操作]] 已复用 notes/_topics/observability-tracing.md
[[演示收集器不等于持久追踪平台]] 已复用 notes/_topics/observability-tracing.md
[[注入应传上下文而非整个span]] 已复用 notes/_topics/observability-tracing.md
[[片段划分以实际埋点为准]] 已复用 notes/_topics/observability-tracing.md
[[追踪时间线定位已观测关键路径]] 已复用 notes/_topics/observability-tracing.md
[[追踪依赖图只反映已采集交互]] 已复用 notes/_topics/observability-tracing.md
[[小团队减少内部沟通但增加边界]] 已复用 notes/_topics/org-architecture-alignment.md
[[组织沟通与架构相互塑造]] 已复用 notes/_topics/org-architecture-alignment.md
[[团队设计以三项原则取舍]] 已复用 notes/_topics/org-architecture-alignment.md
[[服务所有权属于长期负责团队]] 已复用 notes/_topics/org-architecture-alignment.md
[[团队自治依赖可控交付路径]] 已复用 notes/_topics/org-architecture-alignment.md
[[端到端责任让运行反馈回到设计]] 已复用 notes/_topics/org-architecture-alignment.md
[[团队模型区分专业效率和业务结果]] 已复用 notes/_topics/org-architecture-alignment.md
[[职能交接容易分散长期责任]] 已复用 notes/_topics/org-architecture-alignment.md
[[跨职能团队围绕共同任务交付]] 已复用 notes/_topics/org-architecture-alignment.md
[[团队边界从使命和内聚出发]] 已复用 notes/_topics/org-architecture-alignment.md
[[平台团队提供可消费的内部产品]] 已复用 notes/_topics/org-architecture-alignment.md
[[值班按运行责任和专业分层]] 已复用 notes/_topics/incident-response.md
[[可持续轮值需要公平与反馈]] 已复用 notes/_topics/incident-response.md
[[实践社区连接自治团队知识]] 已复用 notes/_topics/org-architecture-alignment.md
[[跨服务复用要计入推广协调]] 已复用 notes/_topics/org-architecture-alignment.md
[[服务演进不只由新增功能驱动]] 已复用 notes/_topics/microservice-boundaries-evolution.md
[[架构原则引导局部决策演进]] 已复用 notes/_topics/architecture-principles-complexity.md
[[技术自由需支付维护知识成本]] 已复用 notes/_topics/org-architecture-alignment.md
[[内部开源开放贡献保留负责者]] 已复用 notes/_topics/open-source-adoption.md
[[设计评审提前暴露跨服务权衡]] 已复用 notes/_topics/architecture-decision-making.md
[[服务文档按四层支撑发现和运维]] 已复用 notes/_topics/technical-communication.md
[[服务元数据需要可追溯来源]] 已复用 notes/_topics/service-governance.md
[[集群运行控制器与构建代理分工]] 已复用 notes/_topics/ci-cd-pipeline-design.md
[[Chart封装须区分安装版本]] 已复用 notes/_topics/container-orchestration.md
[[持久卷不等于独立备份]] 已复用 notes/_topics/backup-disaster-recovery.md
[[安装参数要与Chart版本匹配]] 已复用 notes/_topics/container-orchestration.md
[[构建权限应限定目标能力]] 已复用 notes/_topics/least-privilege-access-control.md
[[凭据引用与实际授权分开配置]] 已复用 notes/_topics/secrets-credential-management.md
[[最小构建测试只验证已走路径]] 已复用 notes/_topics/testing-effectiveness.md

相关主题

从本书的主题进入跨书阅读,对照其他书籍的讲解。下方数量包含主题关联的全部卡片与书籍。

主题索引

微服务拆分与演进

比较微服务拆分的边界依据、粒度与非业务因素,以及从单体演进和持续重组的策略。

444 张卡片 · 71 本书

主题索引

高可用与异地多活架构

比较主备、主从、集群、分区与异地多活等高可用架构的适用范围、数据同步与代价。

398 张卡片 · 79 本书

主题索引

过载保护与优雅降级

比较限流、减载、退避重试、分级依赖与防御成本的过载应对手段。

386 张卡片 · 68 本书

主题索引

指标与监控

时序模型与拉推采集、黄金指标与分位、探针与 APM、容量与负载、监控分层。

382 张卡片 · 58 本书

主题索引

聚合、实体与值对象

比较实体、值对象、聚合与聚合根、工厂等战术建模要素的判定标准与设计原则。

375 张卡片 · 17 本书

主题索引

测试有效性与验证手段

比较单元测试、变异、模糊测试、静态分析与故障注入各自能证明什么。

366 张卡片 · 63 本书

主题索引

服务治理闭环

比较服务资产、生命周期、依赖关系与运行策略如何形成可观测、可诊断、可执行的治理闭环。

361 张卡片 · 17 本书

主题索引

缓存架构与失效问题

比较缓存穿透、雪崩、热点等问题的成因与应对方案。

345 张卡片 · 58 本书

主题索引

容量规划与资源调度

比较冗余容量、故障域、逻辑与物理资源解耦等容量规划与调度方法。

344 张卡片 · 74 本书

主题索引

领域划分与限界上下文

比较子域划分、通用语言、限界上下文与事件风暴等战略设计方法如何确定业务边界。

330 张卡片 · 31 本书

主题索引

变更发布与回滚安全

比较变更速度、渐进发布、紧急发布与回滚边界的工程控制。

312 张卡片 · 75 本书

主题索引

容器与编排

比较容器隔离与镜像理念、Kubernetes 的资源模型与控制器、应用封装方案,以及容器存储的抽象与扩展机制。

312 张卡片 · 47 本书

主题索引

分布式事务与一致性

比较内部与外部一致性、XA/2PC/3PC、CAP 与 BASE,以及可靠事件队列、TCC、SAGA、AT 等柔性事务方案。

308 张卡片 · 61 本书

主题索引

服务发现与网关

比较服务发现范式、注册中心的 CAP 取舍与实现路线、网关与 BFF,以及地域与区域的流量边界。

286 张卡片 · 70 本书

主题索引

服务网格

比较边车代理、通信可靠性演进、流量劫持、xDS 与控制平面产品,以及网格层的安全与标准化。

266 张卡片 · 23 本书

主题索引

领域事件与最终一致性

比较领域事件、消息中间件、事件总线与数据对账在跨聚合、跨服务一致性上的做法与取舍。

263 张卡片 · 46 本书

主题索引

组织与架构协同演进

比较团队边界、组织结构与技术架构如何对齐,以及组织惯性对架构变革的影响。

255 张卡片 · 57 本书

主题索引

CI/CD流水线设计

流水线的资源模型、任务隔离与显式依赖、定义与运行分离、事件触发,以及构建/发布/运行分离和配置外置如何让同一制品安全跨环境交付。

231 张卡片 · 36 本书

主题索引

架构设计原则与复杂度来源

比较架构要解决的复杂度来源(性能、可用性、扩展、成本、安全、规模)以及合适、简单、演化等设计原则。

228 张卡片 · 40 本书

主题索引

模块化与信息隐藏

比较以函数、闭包、包或服务划定模块边界并隐藏实现细节的方法。

209 张卡片 · 51 本书

主题索引

事件响应与处置

比较事故/安全事件的分级、指挥、沟通、演练与交接做法。

205 张卡片 · 31 本书

主题索引

虚拟化架构

比较全虚拟化、半虚拟化、硬件辅助虚拟化与纯软件模拟在隔离、性能与兼容性上的取舍,以及设备、内存与权限模型的设计。

204 张卡片 · 21 本书

主题索引

追踪与上下文

Trace/Span 模型、标识与上下文传播、采样取舍、OpenTelemetry 与采集器管道。

199 张卡片 · 44 本书

主题索引

备份与故障恢复

比较备份独立性、恢复可验证性与恢复阶段的设计要点。

198 张卡片 · 40 本书

主题索引

分层、洋葱与六边形架构

比较分层、洋葱与六边形架构如何隔离核心业务逻辑与外部技术细节,以及各层职责与调用规则。

196 张卡片 · 43 本书

主题索引

一致性模型与CAP权衡

比较顺序一致性、线性一致性、外部一致性等一致性模型,以及 CAP、弱 CAP、HAT、PACELC 对系统取舍的刻画。

193 张卡片 · 49 本书

主题索引

事务与离线并发控制

系统事务的隔离与锁,以及跨越多个请求的业务事务如何用乐观/悲观离线锁、粗粒度锁和隐含锁保持一致。

188 张卡片 · 35 本书

主题索引

用例与需求表述

比较以用户目标组织需求的用例写法、粒度分层与特性粒度的取舍。

181 张卡片 · 25 本书

主题索引

最小特权与访问控制

比较最小权限、多方审批、紧急绕过与访问审计的设计取舍。

175 张卡片 · 72 本书

主题索引

可扩展应用与插件架构

比较以数据模型、扩展点与插件为核心的应用架构,如何在开放扩展与稳定性、安全性之间取舍。

173 张卡片 · 41 本书

主题索引

架构决策方法

比较在不确定性下做架构决策的方法:以风险而非结果评价决策、期望值与决策树、认知偏差、根因追问与避免不必要的决策。

168 张卡片 · 45 本书

主题索引

日志、审计与取证

日志该记什么、怎么分级与结构化,采集管道与存储成本,以及审计证据与安全事件还原。

167 张卡片 · 46 本书

主题索引

负载均衡

比较负载均衡的分层组合方式与各类分配算法的取舍。

163 张卡片 · 55 本书

主题索引

混沌工程与韧性实验

比较混沌工程的稳态假设、实验设计、生产验证、爆炸半径控制与自动化,以及组织采纳成熟度对系统韧性的作用。

149 张卡片 · 18 本书

主题索引

DevOps落地与组织协作

DevOps 在组织中的适用边界与推进顺序:稳态与敏态系统的区分、工具与流程文化的关系、责任共担取代交接审批、分支模型与团队能力的匹配。

148 张卡片 · 32 本书

主题索引

服务适配与兼容性

比较服务组合中接口与协议失配的分类、适配器的生成与合成方式,以及兼容性分层与组合验证。

146 张卡片 · 38 本书

主题索引

异步编程与结果编排

比较 Future、回调、监听器与阶段式编排在阻塞、线程归属、组合与异常传播上的差异。

140 张卡片 · 30 本书

主题索引

系统扩展的维度

比较水平复制、按业务拆分与数据分片等不同维度的扩展手段及其适用问题。

134 张卡片 · 52 本书

主题索引

组件聚合与耦合原则

比较 REP、CCP、CRP 的组件聚合张力,以及无依赖环、稳定依赖、稳定抽象原则与 I/A 指标对组件耦合的度量。

127 张卡片 · 31 本书

主题索引

技术沟通与架构表达

比较面向不同受众的技术写作、演示与架构图方法:循序渐进的讲解、文档与幻灯片的取舍,以及让图表达连接与语义。

124 张卡片 · 27 本书

主题索引

Broker 存储与读写路径

比较日志段与索引、页缓存与零拷贝、批次与压缩、保留清理与压实,以及副本放置对读写路径与堆积的影响。

118 张卡片 · 24 本书

主题索引

虚拟化网络

比较 Linux 网络栈、虚拟网卡与网桥、VLAN/VXLAN、容器网络模式与 CNI 等虚拟化网络机制。

114 张卡片 · 26 本书

主题索引

可观测性工程化

三支柱的关系与成本、自建与采购、成熟度演进、组织文化与工具化落地。

112 张卡片 · 27 本书

主题索引

故障、部分失效与分布式时钟

比较故障与失效、部分失效、网络与超时的不确定性、时钟漂移与进程暂停,以及系统模型如何界定这些假设。

112 张卡片 · 41 本书

主题索引

投递语义:不丢与不重

比较至少一次、最多一次、恰好一次与幂等的组合,确认、重投、死信与补偿怎样把「不丢不重」落成可实现的条件。

107 张卡片 · 35 本书

主题索引

服务水平目标与错误预算

比较如何定义 SLI/SLO/SLA、设定可靠性目标,以及用错误预算平衡稳定性与变更速度。

107 张卡片 · 23 本书

主题索引

数据集成与分拆:一份真源与多份衍生

多个数据系统怎样连成一套:分拆数据库与读写路径、CDC 与日志捕获、双写与发件箱、数据共享与缓存复制、数据湖与湖仓分工、端到端正确性与可审计性。

103 张卡片 · 23 本书

主题索引

企业集成模式

比较管道过滤器、各类消息通道、命令/文档/事件消息结构、路由(内容、动态、分离聚合、分散聚集、处理过程管理器)、转换(封装、丰富、过滤、存放证、标准化、规范模型)与端点模式的适用场景和取舍。

99 张卡片 · 24 本书

主题索引

配置中心与配置治理

比较配置外置到版本仓库、启动配置与业务配置的分离、按应用与环境匹配资源、敏感配置加密、配置服务高可用与消息总线动态刷新的做法与取舍。

99 张卡片 · 29 本书

主题索引

路由、订阅与寻址

比较交换器与绑定、主题与标签过滤、订阅与广播扇出,以及 vhost、联邦与协议网关等多租户和跨集群寻址方式。

97 张卡片 · 38 本书

主题索引

异步 RPC 与受理语义

异步 RPC 的收发分离、请求标识关联响应、受理与业务完成的区别,业务线程与 IO 线程的边界,异步是否真的省掉等待,以及上下文在异步边界上的传递与丢失。

95 张卡片 · 28 本书

主题索引

分布边界与远程接口

何时才需要分布、远程接口为何要粗粒度,以及远程外观、数据传输对象与序列化格式的设计。

93 张卡片 · 29 本书

主题索引

基础设施即代码与编排

用声明式模板描述资源及其依赖,由编排引擎按依赖图创建、更新与回滚,以及回滚受删除策略和外部副作用约束的边界。

93 张卡片 · 20 本书

主题索引

状态与活动建模

比较状态机与活动图在表达事件响应、并发、流程与责任划分上的用法。

93 张卡片 · 13 本书

主题索引

CQRS与读写模型分离

比较命令与查询的职责、模型及读取路径,并标明薄读取层的适用边界。

88 张卡片 · 13 本书

主题索引

业务架构建模方法

比较业务架构的定义与框架来源,以及用战略分析、价值链、业务领域、流程任务、数据主题域与业务组件构建企业级能力模型、做标准化的方法。

87 张卡片 · 16 本书

主题索引

琐事与运维自动化

比较如何识别和控制重复性运维工作,以及自动化的演进阶段、收益与风险。

85 张卡片 · 21 本书

主题索引

业务事务与离线并发

业务事务比系统事务长得多,中间隔着用户思考时间:乐观离线锁与悲观离线锁怎么选、粗粒度锁与隐含锁的代价、版本号与条件更新怎样防止覆盖、预留与冻结怎样替代事后校验,以及离线并发为什么能免则免。

79 张卡片 · 28 本书

主题索引

领域逻辑的组织方式

事务脚本、领域模型、表模块与服务层的选型、演化与边界:业务逻辑放在哪里、以何种结构组织。

78 张卡片 · 17 本书

主题索引

开源项目选型与使用

比较学习、选型、灰度引入与二次开发开源项目的方法与风险控制。

75 张卡片 · 34 本书

主题索引

线程池容量边界与过载策略

比较线程池/工作队列如何设定容量边界、按任务类型配置线程以及越界后的拒绝、丢弃与背压策略。

75 张卡片 · 34 本书

主题索引

简单性与复杂度控制

比较区分必要与意外复杂度、删减代码与接口、以简化方案推进工程的做法。

72 张卡片 · 25 本书

主题索引

RPC框架调用链与机制

比较远程方法调用中代理、消息定界、编解码与传输分层,以及泛化调用如何复用框架链路。

70 张卡片 · 15 本书

主题索引

错误与异常处理机制

比较延迟执行、异常展开、恢复与返回值错误等机制的语义边界。

62 张卡片 · 27 本书

主题索引

OpenAPI 契约与模式验证

比较 OpenAPI 文档结构、路径与操作、参数/请求/响应、JSON Schema 约束、复用和认证方案,以及规范交互验证的做法。

61 张卡片 · 14 本书

主题索引

RPC重试与期限管理

比较远程调用在不同失败语义下的重试条件、幂等边界、总期限与目标节点选择。

61 张卡片 · 25 本书

主题索引

形态与交互:通道、总线还是代理

消息系统的形态与连接方式:通道、消息总线、代理还是对等、请求-回复与关联号、协议与序列化契约、中间件选型指标。

55 张卡片 · 29 本书

主题索引

告警与 SLO

告警规则与路由、SLO 与错误预算、告警疲劳,以及怎样让告警对应可行动的响应。

51 张卡片 · 22 本书

主题索引

GraphQL 模式、查询与执行

比较 GraphQL SDL 的类型、字段、输入约束、Query 与 Mutation,及选择集、片段、变量、解析器、错误和 HTTP 承载的执行边界。

43 张卡片 · 3 本书

主题索引

密钥与凭证管理

比较密钥轮换、根密钥分发、紧急凭证与凭证泄露风险的管理方法。

42 张卡片 · 18 本书

主题索引

基础设施设计流程与模式

比较从需求、非功能需求等级、风险到模式选择与可追溯记录的基础设施设计流程。

37 张卡片 · 10 本书

主题索引

背压与流控:生产速率怎么被下游约束

背压的成因与实现手段:下游余量怎样反馈给上游、有界队列与拉取模型、缓冲放在哪一层、哪些缓冲只是把过载推迟,以及吞吐由最慢节点决定的后果。

35 张卡片 · 18 本书

主题索引

微前端与业务单元

比较微前端的落地方式、粒度选择,以及前后端组合成业务单元的方法。

34 张卡片 · 7 本书

主题索引

故障时的安全默认状态

比较组件失效时选择开放、关闭或停滞的依据与被利用风险。

30 张卡片 · 17 本书

主题索引

服务路由与流量分组

比较按调用方、业务键和分组限定可见实例,再分配流量及动态调整分组容量的做法。

20 张卡片 · 10 本书