文档：“DevOps下我该怎么办？”：农行文档自动化管理实践

DevOps时代

发布于 2021-03-15 10:16:30

5230

发布于 2021-03-15 10:16:30

众所周知，DevOps 是一种在产品研发周期中强调沟通、集成和协作的文化，在 DevOps 标准框架下构建开发、测试、运维实现全流程自动化管理。文档，作为产品的重要组成部分和重要资产之一，似乎被隐匿于 DevOps 管理流程中，毕竟大家都认为，在敏捷开发理念中，产品价值交付要优于面面俱到的文档。

但是对于农行这样的大型国有商业银行来说，项目文档是组织级重要而宝贵的资产，如何在实施 DevOps 过程中更好的实现端到端的快速交付能力，缩短交付周期，同时又能确保文档这一组织级资产得以留存，成为农行在快速推进 DevOps 实施过程中又一重要课题。

项目文档是项目最系统、最全面的反映，在项目各成员角色之间，项目文档起到了多种桥梁作用，是研发人员前一个阶段工作成果的体现以及后阶段工作的依据，可为用户了解系统使用和维护提供详细的资料。

同时，项目文档也是管理者跟踪项目的一个重要管理工具，利于管理人员了解项目进度、资源使用和成果等具体情况。鉴于项目文档对于农行项目资产的重要性，农业银行在 DevOps 实施过程中，开启了项目文档标准化、自动化管理实践。

农行于 2020 年启动了以 ITA 为主管理链、TFS为辅助工具的项目文档线上化自动化研发工作。围绕着项目文档标准化输出、线上化传递、结构化填写、自动化检查及全流程共享的思路，农行将科技项目管理相关制度要求形成统一的文档编写标准并落实内建于平台，采取文档线上结构化填写的方式，利用工具抽取并管理的关键要素，实现项目数据全流程贯通及项目信息自动化管理及复用，力求将项目文档融入 DevOps 工具链建设中，实现项目文档标准化管理及输出。

在文档自动化建设过程中，秉承 DevOps 建设理念和目标，农行将项目文档数量精简了近 30%，明确了文档产生部门、管理要求负责部门及使用各方的职责。对项目文档产出阶段、编写范围、文档模板发布及使用规程制定了标准化的管理要求。同时，农行推进了各文档源系统间的联动操作，通过文档自动归档功能以落实文档统一管理的标准化要求。

同时实行文档标准化检查及输出，依据各科技项目管理相关制度并结合各项目类型特点，农行确定项目文档内容检查的统一标准并将检查标准项内建于平台，让工具平台可真正发挥其作用，通过工具自动化校验的方式保证项目文档实现标准化输出。

经过对项目文档进行的一系列自动化管理及复用、文档全流程管理，农行已实现项目文档100%伴随流程线上提交及传递，实现了项目过程中对文档提交范围的自动化管理。结构化填写及导出功能也实现了利用工具对项目关键数据进行自动化管理及复用的目的，真正达到项目信息全流程共享的目标。

历时一年的攻坚克难、坚持不懈、努力奋进之后，农行 DevOps 标准持续交付部分已顺利通过三级评测。后续将持续内化标准、优化工具中台、内建DevOps平台、内塑 DevOps 文化，全面塑造农行特色的 DevOps 体系。项目文档管理作为其中不可或缺的一部分，在流程优化、流水线建设中将进一步考虑项目文档管理的再细化优化及落地工作。在稳步推进 DevOps 建设的同时，实现一站式项目文档管理。

作者简介

陆笳，中国农业银行研发中心DevOps组织级教练，负责对口研发部门DevOps流水线推广事宜。

2020年11月27日，由云计算开源联盟指导，由高效运维社区和开放运维联盟联合主办的 2020 GOPS 全球运维大会 · 上海站上，隆重发布了 DevOps 标准持续交付部分第九批评估结果，中国农业银行手机存款贷款模块顺利通过由中国信通院开展的《研发运营一体化（DevOps）能力成熟度持续交付3级评估。DevOps 标准共分 5 级，持续交付部分如果能达到 3 级已经是国内领先水准，这代表着中国农业银行在参评项目的持续交付能力达到国内领先水平。这是中国农业银行在 6 月 19 日同时 5 个项目通过持续交付标准评估之后通过的第 6 个项目。