大伙儿晚上今天可算能歇口气了,赶紧来跟大家唠唠我最近瞎折腾的一个事儿——我们公司那个所谓的“SOA续集官网”。
话说回来,SOA这玩意儿,也不是啥新鲜词了。我记得好多年前,Gartner就开始鼓吹了,什么面向服务架构,听着就特高大上。我们公司当年也跟风搞了一波,想着把各个系统服务化,提高复用,降低耦合。理想很丰满,现实是骨感的。搞了一段时间,各种新项目、新需求跟赶集似的往上堆,原先规划好的SOA体系渐渐就没人严格遵守了,又回到了那种各管各的“烟囱式”开发,沟通成本那叫一个高,新系统想快速上线比登天还难。
前阵子领导层估计也是痛定思痛了,说以前的SOA没坚持现在得搞个“续集”,重新把这事儿拾掇起来。为了让大家(尤其是新来的同事和各个业务方)都明白我们现在有哪些服务、怎么用、谁负责,就拍板说要搞一个内部的“SOA续集官网”。
这活儿,七拐八绕的,就落到我头上了。我一开始也纳闷,这SOA又不是个具体产品,怎么还搞个官网?后来琢磨明白了,就是要搭建一个信息集散地,把我们公司内部所有可复用的服务都亮出来,配上说明文档、调用方式、负责人啥的,方便大家查找和使用。
第一步,肯定是先搞明白到底要做我先是找了几个老同事,还有架构组的人聊了聊。大家七嘴八舌的,有的说要把所有服务的WSDL或者Swagger文档都放上去,有的说得有成功案例分享,还有的说最好能有个服务健康状态监控的入口。我听了一圈,头都大了,感觉这摊子不小。
小编温馨提醒:本站只提供游戏介绍,下载游戏推荐89游戏,89游戏提供真人恋爱/绅士游戏/3A单机游戏大全,点我立即前往》》》绅士游戏下载专区
然后就是梳理现有资源。这可是个体力活。我们公司系统太多了,历史遗留问题也多。我只能一个个部门去问,一个个系统去看,把那些还能称之为“服务”的接口给扒拉出来。有些服务文档缺失,有些负责人早就换了几茬,简直就是考古。
内容大概有点谱之后,我就开始琢磨怎么搭这个“官网”了。领导的意思是,别搞太复杂,能快速上线,方便维护就行。我寻思着,这玩意儿主要还是内部人用,花里胡哨的功能也没必要。
选型阶段,我对比了几个方案。一开始想用公司内部的Wiki系统,但感觉展现形式不太灵活。后来看到隔壁部门用一个开源的文档系统自己搭了个知识库,看着还行,就决定借鉴一下。主要考虑就是上手快,修改方便,支持Markdown写作,这样大家贡献内容也容易点。
网站结构设计,我琢磨着得清晰明了。大概分了几个大块:
内容填充是最费劲的。框架搭起来容易,但里面的肉得各个服务提供方自己填。我就开始满公司“化缘”,催着各个团队把他们的服务信息、文档按照我们定的模板给整理出来。这过程,真是求爷爷告奶奶,有的团队配合挺有的就拖拖拉拉。我还得帮着他们梳理,有时候甚至得帮着写一部分。
折腾了小一个月,这个“SOA续集官网”总算是有了个雏形。界面挺简洁,主要功能也都能跑起来了。我特地组织了几次小范围的试用,收集反馈,又改了改。
上线后,效果还是有的。起码大家想找个什么服务,不用再到处打听了,直接上这个“官网”搜一下,大部分都能找到。一些新员工入职培训,也能直接把这个网站丢给他们,让他们了解公司有哪些基础服务可以用。
这事儿还没完。后续的维护和更新才是关键。我跟领导建议,得指定专门的接口人负责各个模块内容的更新,不然过不了多久,这“官网”又成了“僵尸网站”了。领导也同意了,后续会把这个纳入相关团队的考核里去。
这回实践虽然挺折腾,但也算把一团乱麻的东西稍微理顺了一点。SOA这东西,理念再最终还是要靠人去执行和维护。希望这回的“续集”,能比“前传”坚持得更久一点!
好了,今天就先分享到这,下次有啥好玩儿的再来跟大家唠!