Archive for the '技术(Tech)' Category

早就想试试持续集成.终于有机会了.

刚开始用cruise-control但是免费版有使用限制,而且界面似乎也不是很友好.没用的信息比较多.所以在忍受了1周以后废弃,改用hudson.

hudson比想象中的简单.安装和配置过程不说了.没什么难的东西,多尝试几次即可.

我们的项目用到的是ivy和ant,据说如果项目使用了maven的话就更简单了."因为hudson和maven的搭配几乎可以用天衣无缝来形容".

在使用了hudson将我们的所有模块导入后,整个构建越来越稳定了.而且build fail总是可以在第一时间捕捉并消灭掉.团队初尝ci的好处.

之后我们在构建过程中加入了自动化单元测试和覆盖率工具,当我们发现项目中broken的测试时,团队成员居然自发的去修复他们.在引入单元测试和覆盖率工具3天后,所有单元测试都pass,测试通过率100%.但团队对覆盖率这个东东还不是很了解.似乎也没有多少动力去提高他.此时,覆盖率只有40%左右.

之后我们又引入了findbugs和PMD,发现代码中存在的大量坏味道.此时ci-game插件起了作用.因为每改一个相应的"bug"都会有相应的分数.整个团队掀起了"打怪"狂潮.甚至加班打怪的情况.1周后,我们消灭了90%的不良代码.期间虽然会出现一些改错的地方.但基本上通过持续的代码review(因为所有团队成员都在不停的review代码),即便少有的几次改错的地方也是在第一时间发现并纠正了.

此时,似乎没有什么"怪"可以打了,但ci-game的竞争仍然激烈.此时团队发起了覆盖率提升行动,通过将不同的模块划拨给不同的小组,然后设置一个预期的目标(比如让aaa模块的测试行覆盖率从50%提升到70%.并且每提升1%都可以有5分.ci-game再一次大显神威.覆盖率行动成功并按照计划达到目标.

其实所有这些自动化的事情都可以在每ci工具的情况做到,也可以有类似ci-game这样的机制来提高团队对提高代码质量的积极性.但hudson提供的对代码的"透明",让所有人都可以随时看到代码有哪些问题,改进的如何,更重要的是意识到自己写的代码是会被别人看到的!

当基础模块部分基本稳定后,我们将应用模块也做到自动化构建和发布到开发集成环境.每小时进行一次发布.确保了我们集成开发环境始终都有最新的版本. 后续我们准备将自动化smoke test也做一些,也许不需要很彻底,只需要基本的接口可用即可.

hudson,不,持续集成,很和谐!

-摘自"软件架构师应该知道的97件事"

"...但在现实世界中,最好的架构师不是要去解决难题,而是要围绕难题开展工作.架构师要能够将四处弥漫的软件问题圈起来,并画出其中的各种边界(接口),确保对问题有稳定的,完整的认识."
--Stable problems get high-quality solutions
"架构师要从整体上看待杂乱无章的数据/概念/数据处理逻辑,架构师要能够将他们作为整体看待,并将它们分解为更小的片段或"块".重点在于,这些问题必须是稳定的,它们在范围上有限且稳定,可以作为系统模块解决."
--Stable problems get high-quality solutions
--上面两点说的无外两点: 正确的确定scope, 合理的架构拆解

"从架构师角度看,困难的所在,是要找到设置边界的自然之处,并定义出构建可工作系统所需要的合适接口.大型的企业系统,其自然边界稀少及多个领域之间互有纠缠,做到这点尤为困难."
--Architects' focus is on the boundary and interfaces

"称职的架构师应该勇于接受新观念,敢于尝试新的设计思路和工具,促进项目/团队,甚至整个行业的发展;他不会浪费大把的时间参与管理层会议,或者妄想独自编写所有代码;他应该采纳好点子,营造活跃的思考氛围.只有思想开放的架构师才能平衡各种矛盾因素,顺利完成项目."
--Janus the architect

"将程序设计--或者更准确的说,软件开发, 看作发现和学习的过程,而不是生产和建造的过程."
"如果把编写代码看成设计行为,而不是生产行为,我们就能采用一些已经被证明有效的管理方式,这些方法过去用于管理具有不可预测性的创新工作,比如研发新车/新药/新的电脑游戏.我所指的是敏捷的产品管理方法和精益生产方法,比如scrum,它们关注如何为客户实现最大的投资收益"
--Programming is an act of design

"沉下心来改善系统的生产效率,缩短流程,避免各行其是,才能缩短开发时间.采取一切可行的措施,例如运用模拟方法,降低依赖性,细致划分系统模块,等等.总之要杜绝一起草率提价任务的念头"
--Commit-and-run is a crime

1．引言

1.1编写目的

　　[说明编写这份概要设计说明书的目的，指出预期的读者。]

1.2背景

　　a.[待开发软件系统的名称；]

　　b.[列出本项目的任务提出者、开发者、用户。]

1.3定义

　　[列出本文件中用到的专门术语的定义和外文首字母组词的原词组。]

1.4参考资料

　　[列出有关的参考资料。]

2．总体设计

2.1需求规定

　　[说明对本系统的主要的输入输出项目、处理的功能性能要求。包括]

　　2.1.1系统功能

　　2.1.2系统性能

　　　　2.1.2.1精度

　　　　2.1.2.2时间特性要求

　　　　2.1.2.4可靠性

　　　　2.1.2.5灵活性

　　2.1.3输入输出要求

　　2.1.4数据管理能力要求

　　2.1.5故障处理要求

　　2.1.6其他专门要求

2.2运行环境

　　[简要地说明对本系统的运行环境的规定。]

　　2.2.1设备

　　[列出运行该软件所需要的硬设备。说明其中的新型设备及其专门功能。]

　　2.2.2支持软件

　　[列出支持软件，包括要用到的操作系统、编译（或汇编）程序、测试支持软件

等。]

1　　2.2.3接口

　　[说明该系统同其他系统之间的接口、数据通信协议等]

　　2.2.4控制

　　[说明控制该系统的运行的方法和控制信号，并说明这些控制信号的来源。]

2.3基本设计概念和处理流程

　　[说明本系统的基本设计概念和处理流程，尽量使用图表的形式。]

2.4结构

　　[给出系统结构总体框图（包括软件、硬件结构框图），说明本系统的各模块的

划分，扼要说明每个系统模块的标识符和功能，分层次地给出各模块之间的控制与被

控制关系。]

2.5功能需求与系统模块的关系

　　[本条用一张矩阵图说明各项功能需求的实现同各模块的分配关系。]

　　　 [系统模块1] [系统模块2] [……] [系统模块m]

[功能需求1] 　√　 　　　 　　　 　　　

[功能需求2] 　　　 　√　 　　　 　　　

[┇] 　　　 　　　 　　　 　　　

[功能需求n] 　　　 　√　 　　　 　√　

2.6人工处理过程

　　[说明在本系统的工作过程中不得不包含的人工处理过程。]

2.7尚未解决的问题

　　[说明在概要设计过程中尚未解决而设计者认为在系统完成之前必须解决的各个

问题。]

3．接口设计

3.1用户接口

　　[说明将向用户提供的命令和它们的语法结构，以及相应的回答信息。]

　　[说明提供给用户操作的硬件控制面板的定义。]

3.2外部接口

　　[说明本系统同外界的所有接口的安排包括软件与硬件之间的接口、本系统与各

支持系统之间的接口关系。]

3.3内部接口

　　[说明本系统之内的各个系统元素之间的接口的安排。]

4．运行设计

4.1运行模块组合

　　[说明对系统施加不同的外界运行控制时所引起的各种不同的运行模块组合，说

明每种运行所历经的内部模块的支持软件。]

4.2运行控制

　　[说明每一种外界的运行控制的方式方法和操作步骤。]

4.3运行时间

　　[说明每种运行模块组合将占用各种资源的时间。]

5．系统数据结构设计

　　[不涉及软件设计可不包含]

5.1逻辑结构设计要点

　　[给出本系统内软件所使用的每个数据结构的名称、标识符以及它们之中每个数

据项、记录、文卷和系的标识、定义、长度及它们之间的层次的或表格的相互关系。

]

5.2物理结构设计要点

　　[给出本系统内软件所使用的每个数据结构中的每个数据项的存储要求，访问方

法、存取单位、存取的物理关系、设计考虑和保密条件。]

5.3数据结构与程序的关系

　　[说明各个数据结构与访问这些数据结构的各个程序之间的对应关系。]

　　　 [程序1] [程序2] [……] [程序m]

[数据结构1] 　√　 　　　 　　　 　　　

[数据结构2] 　　　 　√　 　　　 　　　

[┇] 　　　 　　　 　　　 　　　

[数据结构n] 　　　 　√　 　　　 　√　

6．系统出错处理设计

6.1出错信息

　　[用一览表的方式说明每种可能的出错或故障情况出现时，系统输出信息的形式

、含意及处理方法。]

6.2补救措施

　　[说明故障出现后可能采取的变通措施。包括：]

　　a.后备技术 [说明准备采用的后备技术，当原始系统数据万一丢失时启用的副本

的建立和启动的技术，例如周期性地把磁盘信息记录到磁带上去就是对于磁盘媒体的

一种后备技术。]

　　b.降效技术 [说明准备采用的后备技术，使用另一个效率稍低的系统或方法来求

得所需结果的某些部分，例如一个自动系统的降效技术可以是手工操作和数据的人工

记录。]

　　c.恢复及再启动技术 [说明将使用的恢复再启动技术，使软件从故障点恢复执行

或使软件从头开始重新运行的方法。]

6.3系统维护设计

　　[说明为了系统维护的方便而在程序内部设计中作出的安排，包括在程序中专门

安排用于系统的检查与维护的检测点和专用模块。]