服务说明文档

对于每个服务而言，都应有一个清晰的服务说明，描述当前服务的信息，同时帮助团队更快腿解并快速上手。服务说明都包括如下几个部分。

1. 服务介绍

• 服务提供什么功能，譬如产品服务主要提供产品数据的获取或者存储。

• 谁是服务的消费者。譬如产品服务的消费者为电商的前端网站系统或者CRM系统。

服务维护者

• 挑选1-2个团队的成员，作为服务的负贵人，登记其姓名、电子邮件、电话等联系方式，以便其他团队遇到问题能及时找到服务的负责人。

服务可用期

• 服务可用周期，如7X24小时，或周一?到周五（7:00?丨9:00)等。

• 可用率，可用率是指服务可以正常访问的时间占总时间的百分比，如99.9%或者99%。

• 响应时间，指服务返回数据的可接受响应时间。譬如为0.5-1秒

定义环境，描述服务运行的具体环境，通常包括：

• 生产环境

• 测试环境

开发，描述开发相关的信息，通常包括：

• 如何搭建开发环境

• 如何运行服务

• 如何定位问题

测试，描述测试相关的信息，通常包括：

• 测试策略

• 如何运行测试

• 如何查看测试的统计结果，譬如测试覆盖率、运行时间、性能等。

构建，描述持续集成以及构建相关的信息，通常包括：

• 持续集成访问的URL

• 持续集成的流程描述

• 构建后的部署包

部署，描述部署相关的信息，通常包括：

• 如何部署到不同环境

• 部署后的功能验证

运维，雛运维相关的信息，通常包括：

• 日志聚合的访问

• 告警信息的访问

• 监控信息的访问

转自：王磊的《微服务架构与实践》

作者：UEUEO
链接：https://www.jianshu.com/p/add0bc7f2b37