1、关于JIRA结合SVN的项目管理关于JIRA结合SVN的项目管理V1.0撰写人：吕晓晨（67547）更新日期： 2012- 10 - 21亚信联创科技股份有限公司目录一、 前言 3 1 、 适用者 3 2 、 说明 3 3 、 流程概要 3 4 、 重点关注 4 二、 结合 JIRA 管理版本 4 1 、选择项目 4 2 、项目版本 5 3 、创建新版本 5 三、项目开发流程规范 6 1 、需求的来源 , 创建新问题 6 2 、开发经办人接受 JIRA 任务需求 7 3 、开发经办人解决问题 9 4 、需求分配至测试人员 10 5 、任务的关闭 10 6 、开发人员在 SVN 代码库打 tag
2、 10 7 、版本发布 12 8 、上线 12 9 、版本归档 13 四、单人与多人开发并存的情况 13 1 、单人开发： 13 2 、多人并行开发 14 五、 Q&A 16 1 、项目版本的定义 16 2 、接收一个新的 JIRA 单，有了新需求，如何从 SVN 取最新开发代码版本 16 3 、关于项目管理中的角色 18 一、 前言1 、 适用者本文档适用开发人员，测试人员及项目涉及相关管理人员，并对 JIRA 管理平台， SVN 版本控制有一定操作经验者。2 、 说明本人文档不涉及 JIRA 项目管理平台， SVN 版本控制软件具体的操作及应用，相关详细使用操作，请参照官方提供的使用手册或
3、其它文档。3 、 流程概要在这里首先简要说明一下项目管理流程：前期，客户提出相关需求，项目经理协商后接收需求。由设计人员出具满足客户要求的用户需求书，并针对开发人员编写概要设计文档。在已有产品的情况下，根据事先的规定，项目管理人员通过 JIRA 管理平台，在对应省份的产品项目，创建新的需求，并定义新的版本号（版本号参照第二章的第 6 小节的描述），新的版本号将代表了本次版本的更新来源及满足了客户何种需求，提交必要的概要设计文档等，并填写相关环境信息。新需求创建好以后，创建者可以分配需求到相关开发人员。开发人员通过人个帐号成功登录 JIRA 平台后，接受新需求，并开始进行这个需求，在规定开发周期
4、内完成开发任务，并更新或部署能测试本次需求是否按要求已实现的测试系统，必提交必要的文档或填写可以更好地有助与测试的备注信息，完成以上规定动作。开发人员转交任务到相关测试人员，测试人员完成测试，在 JIRA 单备注信息填写测试是否通过。通过后，可以转交 JIRA 单到需求创建者，经确认后，创建者可以关闭需求 JIRA 单。以后步骤完成以后，开发人员在 SVN 对应项目的 TAG 上可以打标记 tag ，该 tag 标记的名称也必须和版本号保持一致。后期，经与项目管理者确认后，由项目管理者通过 JIRA 平台，在项目版本控制中对该版本执行发布操作，版本发布，表明该版本对应的项目代码是可以交付给客户
5、的，是软件提供方具备了成熟上线条件的，从开发上讲，是实际有效的完成了客户需求的软件。上线，项目管理者与客户协商确认后，在相关维护人员的参与下，开发人员将完成需求的代码在规定时间，规定条件下，准确实施到客户系统主机上，并得到维护人员及客户验证无误后，确保实施上线成功。最后，完成上线以后，项目管理人员通过 JIRA 平台，在项目的版本控制下，对完成本次需求的版本，执行归档操作。版本的归档，表明了一个版本指代的需求的终结，一个版本从产生到最终结束的完整流程。4 、 重点关注本文档重点关注第二章节及第三单节的内容，这两个章节描述了在一个合理地按照一个理想条件下的完整的开发流程，其中第二章的第 6 小节
6、详尽地体现了版本号的规则。二、 结合JIRA管理版本切记：1 ） . 版本要早规划早定义，而不是开发启动后再确定版本号；2 ） . 使用工具辅助开发管理；3 ） . 作为介质，为开发管理的持续改进提供了数据支撑。1 、选择项目描述：项目管理用户登录 JIRA 平台后，在项目中选择所要创建版本的项目。2 、项目版本描述：在项目主面板左侧菜单中，选择版本，将展示当前该项目已有的版本信息3 、创建新版本描述：在版本右侧上部选择“版本管理”，则将展示如下。版本名称的要求： MANAGE7.1_JSCT0002各字符代表含义：MANAGE ： 业务管理7.1 ：大版本号（根据实际情况视需求而定）JSCT
7、 ：运营商标识（ JS ： 江苏； CT : 电信； CM : 移动； CU : 联通）0002 ：小版本号（对应单个需求的版本标识）可以通过添加版本，创建新版本，版本信息填写参考如下。版本的描述：填写清晰地并能准确描述并次本次的信息。创建生成新的版本后，对已有版本，可进行 “ 编辑明细 | 合并 | 发布 | 归档 | 删除 ”。三、项目开发流程规范1 、需求的 来源 , 创建新问题在 JIRA 平台创建新问题（区分任务与 BUG 类型）描述：新问题（需求）创建为提出需求的拥有 JIRA 管理平台权限项目管控且实际参予的人员；新问题填写要求：主题：填写本问题简明扼要的描述主题内容优先级：分为
8、：紧急，严重，一般，次要，无关紧要。到期日：评估完成问题的时间点模块：涉及的影响功能模块影响版本：新需求开发所采用的已有版本号 修复版本：本次新需求来源产生的新版本号经办人：负责者，如果新任务类型，则分配予相关开发人员，若是 BUG 则分配给负责测试的人员报告人：提交者，当前新需求或 BUG 的创建者环境：本需求涉及的开发环境（中间件，运行环境），测试环境，数据库等信息附件：以附件的形式提交相关的开发文档，或其它可以有效并有助与需求开发的资料。标签：为新需求添加分类Documentation ：可以通过查找 Confluence 知识共享平台的文档，添加 Confluence Document
9、 文档所在的 URL 访问信息。例：一个完整的任务单2 、开发经办人接受 JIRA 任务 需求2.1 、描述：作为当前经办人的开发人员，收到邮件提醒后，经办人员在用个人帐号密码成功登录 JIRA 后，在主面板右上侧会看到当前已被分配，需进行的问题统计。2.2 、点击问题统计当前显示的用户名链接，进入可查看当前需要处理的所有 JIRA 问题2.3 、选择其中一个问题点击进入，可查看该问题的具体信息，点击“开始进行”，则该问题将进入开启状态。2.4 、根据问题进行的程度，及对问题的跟踪关注点，可以提交必要的备注信息，记录下来，以备后续查阅，或供他人查看。可以跟进问题的进展程度。注：备注信息非常重要
10、，为了让测试人员更好的配合测试，开发人员可以填写需求沟通过程中确认的信息，需求可能的变更带来的对需求的影响，及可能的相关数据库实体表的名称，或需要特别关注的字段或其它有效信息。需求相关人员如果发现该描述与实际情况有偏差，仍可以提出异议，再提交新的信息，供测试人员实施测试。3 、开发经办人解决问题描述：当前分配人，即开发人员在处理完问题后，可以点击问题上“解决问题”，并选择分配给下一个经办人（转交测试人员进入测试阶段），同时填入必要的备注信息，供下一经办人查阅。4 、需求 分配至测试人员描述：测试经办人员接受到 JIRA 的问题后，根据用户需求说明书，需求设计文档，采用合理测试工具或技术手段，以
11、合理满足用户需求为准则，完成测试，若发现新的问题或 BUG 等通过 JIRA 平台提交 BUG 类问题至相关开发人员，并根据是否需要出具测试报告，追踪定位需求的完整性。测试通过后，提供必要备注信息，供可关闭需求经办人查阅，将需求转至具有关闭需求权限的项目管理人员。5 、任务的关闭描述：具有需求问题关闭权限的项目管理人员，在接到分配的已测试通过后的问题时，确定该需求被很好的解决后，即可以关闭关题。可能存在的情况是，若是维护已存在项目将交由维护人员，或 需求来源着关闭问题。问题从创建到关闭，各经办人员按照规范作业，借此保证了创建的问题，从始而终。6 、开发人员在 SVN 代码库打 tag描述：对已
12、开发完，并测试通过后的开发需求，更多的情况是，还需现场维护人员测试确认通过后，开发人员可以通过myeclipse的SVN插件，在选定项目，对应的开发库trunk 上对该项目打标记tag。该种情况，将表明，此版本对应的项目，是可以交付实施的。标记 tag 对应名称标识描述名称的要求： MANAGE7.1_JSCT0002特别地，tag标记的名称应和JIRA平台的版本号保持一致。各字符代表含义：MANAGE ： 业务管理7.1 ：大版本号（根据实际情况视需求而定）JSCT ：运营商标识（JS ： 江苏；CT : 电信；CM : 移动；CU : 联通）0002 ：小版本号（对应单个需求的版本标识）参
13、考规范URL:http:/192.168.97.50:10080/svn/repos/%E6%B1%9F%E8%8B%8F%E8%81%94%E9%80%9A/manage70 / tags/tag_MANAGE 7.0 _JSCU00017 、版本发布描述：满足条件，已完成，测试通过(此处指测试人员，现场维护人员均已测试通过)，在SVN 版本库按规范要求打了tag的需求，通过开发人员协商通知项目管理人员（特别指需求的创建者），对该需求对应的项目，通过JIRA平台，执行版本发布操作。关键：版本发布表明此时的项目代码是具备了交付条件的版本。8 、上线描述：开发人员接到上线通知，在规定上线时间，在
14、现场维护人员的配合下，按照上线要求，在规定上线步骤的情况下，将已开发完成的需求内容上线实施到客户现网环境，并通过测试及确认，上线是成功的。9 、版本归档描述：项目管理人员，在得到确认上线成功的需求后，对当前管理项目，通过JIRA管理平台，执行版本归档的操作。关键：版本归档表示了已上线的需求。四、单人与多人开发并存的情况说明：在此仅是提供了一此建设性的可供参考的情况。例如，可能的情况是，不管参与开发的人员有多少，均采取分支开发的方式进行。1 、单人开发：描述：单人对自己经办的 JIRA 需求单执行开发任务，采用代码库 SVN 的 trunk 开发，根据需求的前后顺序，完成开发，在 trunk 上
15、提交代码，测试通过，按照前述标记 tag 生成的要求，按次序完成一个需求，将新建一个 tag 标识。2 、多人并行开发描述：假如存在 2 人的情况，其它情况相似2 个开发经办人接受了各自的 JIRA 需求单 1 ，进行各自的需求开发时，第一个人完成 JIRA 需求单顺序的开发任务后，提交代码到 trunk 上，并按规定动作打了 tag 。此时另外一个人需要 checkout 代码库代码到本机实施开发，根据从 jira 的版本中找到最新的版本发布，名称对应 tag 的标识名，从最新现网对应的 tag 上拉出一个分支到 branches 下，该经办人的 JIRA 需求 2 开发任务将在这个分支下进
16、行，代码即提交到自己开发的分支上。待需求开发完成，再将自己的代码合并到 trunk 开发库上。合并过程需求比对，在前一个开发完成的基础上加入自己的代码，并测试通过，满足要求。按照规定动作在标记 tag 上打需求对应的 tag 标记。故此种情形下，开发库 trunk 上是需求单 1 与需求单 2 的合并。在多人并行开发的情况下，采用该种模式将保证代码的及时入库，避免代码的遗失。五、 Q&A1 、项目版本的定义以业务管理版本的要求为例：版本名称的要求： MANAGE7. 0 _JSCT000 1注意事项：tag标记的名称应和JIRA平台的版本号保持一致。名称代表含义：MANAGE ： 业务管理缩写
17、7. 0 ：大版本号（根据实际情况视需求而定）JSCT ：运营商标识（JS ： 江苏；CT : 电信；CM : 移动；CU : 联通）000 1 ：小版本号（对应单个需求的版本标识）2 、接收一个新的 JIRA 单，有了新需求，如何从 SVN 取最新开发代码版本因为在打 tag 标记时， SVN 会生成新的版本号，所以如果开发时要从 SVN 代码库的开发库 trunk 上取最代码的方法为：1 ）、选择 SVN 上项目所属的 tag 目录，找到最新的 tag 标记 , 即 MANAGE7. 0 _JSCT000 2。2 ）、右键选择该 tag （ MANAGE7. 0 _JSCT000 2 ）的
18、 Show History ，以此查看所有历史版本信息。3 ）、该历史版本信息中，最上面是打 tag 生成的版本，即 Revision = 5545, 我们选取版本号 5545 的上一个版本 5539 就是要取的版本。这个 版本 5539 表明，该 tag 标记为 MANAGE7. 0 _JSCT000 2是已发布的。所以5539就是我们用来在下一次需求来临时，版本需要递增时，我们将要从开发库trunk上取代码的版本。3 、关于项目管理中的角色一般意义上讲，我们新需求到来时，首先需要项目管理 JIRA 平台创建新的需求任务，这个 JIRA 单的创建者是由需求的来源者创建。实际情况下，有时会由现网维护人员或省区的项目经理创建，更可能直接由开发人员创建。所以真正执行的情况下，需要协商沟通，共通维护项目需求的开发。严格意义上讲，任务涉及项目有关的情况，需要以公司邮件确认函件明确具体的职责，目前为了维持好版本的统一有序，版本方面交由支撑相关省份的开发人员维护较好。
