一篇文章带给你DevOps如何管理API？

2023-04-13 08:21:38本文提出使用一体化的API管理平台在DevOps工作流中对API进行全生命周期管理，解决过去多个工具之间数据隔离、流程阻滞的问题。

随着DevOps理念在中国企业当中的普及和发展，中国企业DevOps落地成熟度不断提升，根据中国信通院的数据已有近6成企业向全生命周期管理迈进。而在研发全生命周期管理之中，API管理的地位愈发显得重要。随着API数量的大幅增长，也带来了新的API管理需求。如何在DevOps工作流中进行API全生命周期管理，对项目研发来说具有重大意义。

在实际的DevOps工作流中，API管理面临着以下6大方面的困境：规范、协作、自动化质量、迭代、自动化。

困境一：规范落地执行难

因为团队中的API文档质量参差不齐，导致规范很难落地执行。原因在于公司有很多的研发项目和团队，不同的团队有不同的API管理习惯，尤其是常用的Swagger方式的管理，很难进行统一的平台化管理。针对这个困境，可以通过统一的API管理平台规范文档的模板，引导编写流程和习惯，也可以通过自动化文档管理工具来简化流程，提高管理效率。

困境二：岗位协作难、信息沟通效率低

在DevOps工具链中，每一个工具都会有不同的通知消息，导致重要信息淹没在繁杂的通知中。其次是工作流程环节多、流程长，各岗位角色处理工作节奏不一，导致任务链上下游沟通效率低。针对这个困境，可以缩短流程环节，多启用自动化流程。同时制定精细化通知规则，根据优先级提供差异化通知样式。最后，再通过每日推送复盘消息，梳理当日工作项和消息通知，防止遗漏。

困境三：自动化测试体系搭建门槛高

传统的自动化接口测试脚本需要用Python来编写，门槛高，成本高。又因纯手工编写，开发变动后还须对照文档二次调整接口的所有脚本。另外，自动化测试前期投入时间多，准备工作繁杂。针对这个困境，可以使用界面化的自动化测试工具，降低脚本编写门槛。还可以通过一站式API全生命周期管理平台，免去大量前期工作，提高自动化测试效率。

困境四：API生产质量和在线异常的发现、跟踪、解决流程过长

当下，在后端的接口自测、前段的MOCK测试、冒烟测试、集成测试、异常监控这5个环节中都会使用到不同的工具，于是产生了跨工具之间对接复杂、数据隔离，导致API生产质量薄弱，以及大量重复工作。可以通过一体化的API管理工具来打通不同环节的工作流，提高研发质量和效能。

困境五：接口文档无法跟踪迭代版本，回溯排查难度大

传统的接口管理工具如Swagger没有接口修改记录，缺少版本管理，无法通过日志定位问题，无法进行回滚和历史对比。另外团队也缺少接口迭代计划，导致开发量和影响面分析都难以评估。接口文档作为研发项目的重要资产，应该对其变更进行盘点，包括提供接口文档的历史记录。可以通过一站式API全生命周期管理工具，提供项目级的接口版本管理和接口迭代计划，输出更加优质的接口文档，推进DevOps工作流的效率提升。

困境六：DevOps工作流使用工具多

DevOps作为宏观层面的研发管理思路，目前并没有大而全的工具，因此带来企业内部工具越积越多，数据流通阻滞，另外，传统接口管理工具功能也很单一。针对这个问题，可以使用一体化的API全生命周期管理工具来实现与接口相关的所有问题，减少对接的工具数量。

基于前文对DevOps中API管理存在的问题，可以梳理出企业R&D需要以下六个方面：

对于满足这些条件的工具，我们定义为API全生命周期智能协作平台。在这个一体化平台上，可以从API的开发态到发布态到运营态，对API进行全生命周期管理。

平台地址： 。

三、API全生命周期管理如何接入DevOps

根据经典的DevOps流程图，我们从计划、开发、构建、测试、部署、发布、运维跟监控环节，探讨API管理工具对接。

1、计划：制定API文档规范，搭建层次清晰的API仓库

2、开发：基于代码仓库搭建自动化流程，解决前后端调试和沟通问题

基于代码仓库或swagger或本地研发工具，快速自动生成API文档并快速调试，调试没问题后再自动生成 MOCK API和批量接口用例，可以在线分享给前端和测试，文档支持在线评论。最终还可以基于这个 API 文档生成业务代码，协助开发。

3、构建：自动打接口版本及自动冒烟测试，支持回滚和减轻测试工程师压力

构建阶段可以基于 CI 触发器自动构建接口版本，方便后续版本回滚，还可基于接口版本做批量测试，以及做版本差异化的对比。

这两个步骤可以让测试对任务进行评估，更好地去减轻测试的压力。目前接口上自动化能测出来的问题，可预先通过API测试出来。

4、测试：推进自动化测试，降低用例编写成本

在测试阶段我们推荐自动化测试，一体化API全生命周期管理工具可以去快速同步前面开发阶段生成的测试用例，然后对这些测试用例进行流程编排，组成自动化测试用例。也可以基于 API 网关的监控日志做流量回放，自动生成自动化测试用例，识别增量接口并跑模糊测试。可以组成场景案例，做回归测试。模糊测试跟回测试的测试结果发送测试报告，给到对应的测试人员。

5、部署：快速测试核心流程，排除环境差异问题

部署之后可以通过 CD 触发器对环境进行预测，试跑核心的测试场景，生成对应的测试报告。可以通过多环境的测试结果进行对比，排查环境差异的问题，也可以在部署好之后进行压力测试。（注：目前Eolink Apikit压力测试功能将在年中上线，敬请期待）

6、发布：确保对外访问畅通和安全

在发布阶段，主要对接 API 网关，让系统可以正常对外访问，开放接口能力。

7、运维：保障服务持续稳定和安全

在运维阶段依然是使用 API 网关，做流量控制、负载均衡或服务治理。在接口开放上可以去做Open API 调用管控，在线试用跟鉴权。在接口交易上可以去做接口托管、转发跟计算计费以及订单管理。

8、监控：实时观察接口运行情况，及时异常告警

可以设置标准的接口监控指标，做更加灵活的监控配置，并对告警进行规则配置预设，当满足这些告警的预设条件时就会发送消息通知，包括手机短信、主流的 IM 工具，以及webhook。

在消息通知方面，我们认为不仅仅需要DevOps主流程的对接，而是要保证整个DevOps信息流的有效和及时传递，因此需要对 API 文档的变更、测试报告、监控告警，进行智能分发。例如进行分级推送、智能归纳、高风险标记等。

【重磅】DevOps工作流对接API全生命周期管理全流程图

四、不同规模团队如何落地实施

1、大规模团队：全DevOps周期的接口自动化

对于大规模团队来说，推荐基于DevOps全周期的接口自动化方案，需部署Eolink Apikit私有云版本。在这个方案中，可以把Swagger的URL自动同步到Eolink Apikit，自动生成文档，进一步基于文档生成业务代码，然后发送到代码仓库，再去触发CI流水线，给文档打版本，做模糊测试，并把报告发送给对应的人员。接下来在CD环节部署好服务之后，可以对环境进行预测试，并根据需求做压力测试，并把测试报告发送给对应的相关人员。除了CICD，还可以集成Eolink的网关产品，对API进行运维管理。

2、小规模团队：高性价比的接口自动化

对于小规模团队来说，性价比更高的SaaS企业版，可以使用插件生成API文档上传Eolink Apikit，并进行测试，自动生成测试用例。

目前该高性价比解决方案，已覆盖从设计、开发到构建、发布、部署的环节，对运维、监控、压力测试等环节尚且缺失，对于核心的API全自动化的管理流程已完全足够。

本文提出使用一体化的API管理平台在DevOps工作流中对API进行全生命周期管理，解决过去多个工具之间数据隔离、流程阻滞的问题。

API全生命周期管理平台Eolink Apikit是结合 API 设计、文档管理、自动化测试、监控、研发管理和团队协作的一站式 API 研发协作平台，是API研发管理最佳实践产品，可以帮助个人开发者到跨国企业用户，快速、规范地对API进行全生命周期管理，提高研发效能。

平台地址： 。

喜欢一个人的表现

当你喜欢一个人时，你想和他在一起，因为他会带给你快乐；离开后，你会想念，想着想着就会笑，然后继续你平静的生活，并期待着与他再一次重逢。当你爱一个人时，你想和他在一起，那是一种牵肠挂肚的舍不得，怕他受委屈，怕他不能好好照顾自己；离开 后。你也会想念，想着想着叹一口气，“不知他现在过的怎样？”然后你继续你平静的生活，希望他早日回到你身边。

你喜欢的人在你眼中是天使，无所不能，他总会满足你的任性的要求。你爱的人在你 眼中是孩子，傻傻的，你不期望他做出什么“好事”来，只一味纵容他那些让人哭笑不得的举动。你会希望你喜欢的人陪着你，然而你心中想的可能是你爱的人；你会希望陪在你爱的人身边，看他在你面前睡得如此安逸甜美毫不设防的样子，你会微笑，会觉得好幸福。

三毛 温柔的夜 读后感（500字内）

《圣经》上说，“你看天上的飞鸟，也不种，也不收，天父尚且看顾他们，你们做人的，为什么总忧虑明天呢？一天的忧虑一天担就够了。 ”——三毛《五月花》 “请你告诉我——为什么，为什么，这世上有那么多寂寞的人啊---”。 夜，像一张毯子，温柔地向我覆盖上来。 ----三毛《温柔的夜》断断续续，用了将近一个月的时间读完了这本书。 书中带给我最深印象的，莫过于三毛的善良和荷西的忠厚。 最让我佩服的是他们对待生活的态度，以及夫妻之间的理解和信任。 文章中的一个个小故事，或许是三毛的真实经历，或许是三毛的心理想象。 但不管怎样，每一篇作品都透着三毛对人的看法，对人生的启迪和概括，并且是那么恰如其分。 每读一篇，我的心情都会静谧起来，尽管情节也有曲折趺宕，但三毛语言的特色，总不至于让我有大起大落的心理起伏。 游离其中，就仿佛来到漫山遍野的花丛当中，有一条小路，漫步迈向前方，两旁飘溢着花的芬芳。 走着走着，眼前突然闪出一个大花园，顿时让人豁然开朗，心境明亮。 沉浸在这样的情景当中，总是有所期待，想象着三毛对这件事又会有什么样的精辟哲理。 其实，吸引我读下去的还有另外一个原因。 那就是化身真实中的三毛，去游览、去经历五彩斑斓的生活路程，去感悟、去体验丰富多采的酸甜心路。 一直很崇拜那些飞来飞去的人，当然也喜欢读他们关于在路上的书籍作品。 三毛就是这样一个作家。 一个中国女孩，年纪轻轻就留美游欧，后来还让人吃惊地嫁给一个大胡子的西班牙人。 可结婚五年，荷西就意外去世，这使三毛的心灵受到严重创伤。 有句话说，“每个不幸的东西，都让我心灵颤动。 ”我喜欢三毛的作品，却不是因为怜惜，而是因为崇拜。 阅读中我发现，三毛的心理反应竟和我出奇的相似（或许这也是每一个忠实读者的感觉）。 这是人性的善良还是性格的懦弱？我不去追究，只想静静地体会。 毕竟，意识是我自己的，谁也夺不去，谁也左右不了。 就如三毛做的一样：心灵上受到亏欠，一辈子也不安心，世俗的东西又算得了什么。 我喜欢三毛，喜欢《温柔的夜》。

现代诗的创作要注意什么？

要注意以下几个方面：1、选题新颖选取别人很少涉及的题材，可能成为写作的一大优势。 有时候，同样的旧题材，能够发掘出新的东西，也可以得到这样的结果。 2、词语精炼诗句不要拖拉，不要堆积华丽的词汇。 要做到每个意象都发挥用处，每个字都不可删改与替换。 3、注意细节诗歌不同于小说和散文，无法对事物作出全面的描述，因此，诗人要善于观察和把握，抓住最具有代表性的点，以点盖面。 4、深化主题写作中不要完全束缚于题材的限定，加强事物的横向联想，提高诗歌的深度。 峰回路转，往往有出人意料的效果。 要注意不可离题太远，导致整首诗不知所云。 5、保持速度诗句的推进速度要严格控制在作者的笔下，不可过快，导致内部结构的过于纷乱；也不可过慢，对阅读造成障碍。 具体情况，应照诗歌的选题、意象密度、情绪等因素而定。 6、提炼标题题目是文章的眼睛，一个好的题目，首先就可以吸引读者的目光。 同样的题材，好的标题所具有的优势是不言而喻的。 从诗句中提炼切题的句子是一个不错的办法。 也可以另外拟题，但要注意与内容的对应。 7、断句与分行一首诗，不仅要在内容上追求完美，外在的形式也同样重要。 好的断句与分行，可以加强阅读效果，提高诗句的感染度，使阅读更加流畅。 8、介入的角度在诗歌当中，为了强化题材的感染力，作者往往会以各种角度介入诗句的进行。 注意不同题材的介入角度，或切身，或旁观，或第二、第三人称，应视具体情况而定。 9、注意修改诗歌的写作不同与其他题材作品的写作，它更注重瞬间的灵感与爆发，很少会在进行中不断推敲和构思。 因此，完成后的修改就显得非常重要。 反复阅读与修改，有时候，最终的版本会与初稿完全不同。 10、编排组诗把题材相近、写法相似的诗编成组诗，是提高震撼力的好办法。 组诗的先后顺序、总标题的选定视个人而定。