軟件版本管理制度樣本

軟件版本管理規(guī)范系統(tǒng)軟件開(kāi)發(fā)部-9-20目錄TOC\o"1-3"1 引言 21.1 目 21.2 范疇 31.3 術(shù)語(yǔ)定義 31.4 版序控制記錄 31.5 版本更新記錄 42 版本管理 42.1 流程圖 42.2 版本命名 52.3 版本升級(jí) 52.3.1 版本升級(jí)原則 52.3.2 新版本發(fā)布 62.4 目錄構(gòu)造 62.5 文檔存儲(chǔ) 72.5.1 文本文獻(xiàn)存儲(chǔ) 72.5.2 源代碼存儲(chǔ) 72.5.3 發(fā)行文檔存儲(chǔ) 72.6 權(quán)限控制管理 83 備份管理 83.1 源文獻(xiàn)備份 83.2 庫(kù)文獻(xiàn)備份 84 顧客版本管理 95 版本工具使用 95.1 配備管理工具 95.2 CVS使用 105.2.1 慣用命令 105.2.2 簡(jiǎn)樸操作 105.2.3 版本分支管理 10引言目本文檔是為規(guī)范XXXXXX有限公司軟件版本管理而制定。范疇本文檔為系統(tǒng)軟件開(kāi)發(fā)部版本管理員提供關(guān)于版本管理規(guī)范有關(guān)內(nèi)容，涉及：版本標(biāo)記辦法軟件系統(tǒng)數(shù)據(jù)存儲(chǔ)文檔修改控制文檔備份制度術(shù)語(yǔ)定義CVSCVS是一種開(kāi)源版本控制系統(tǒng)ConcurrentVersionsSystem簡(jiǎn)稱(chēng)文檔一種數(shù)據(jù)媒體和其上所記錄數(shù)據(jù)。配備管理標(biāo)記和擬定系統(tǒng)中配備項(xiàng)過(guò)程，在系統(tǒng)整個(gè)生存周期內(nèi)控制這些項(xiàng)投放和更動(dòng)，記錄并報(bào)告配備狀態(tài)和更動(dòng)規(guī)定，驗(yàn)證配備項(xiàng)完整性和對(duì)的性。軟件配備軟件詳細(xì)形態(tài)在某時(shí)刻瞬時(shí)影像。配備項(xiàng)軟件配備管理對(duì)象稱(chēng)為配備項(xiàng)，如：系統(tǒng)規(guī)格闡明書(shū)，項(xiàng)目開(kāi)發(fā)籌劃，顧客手冊(cè)，源碼?；€(xiàn)軟件生存周期中各開(kāi)發(fā)階段末尾標(biāo)記，它作用是把各階段工作劃分更加明確化，使本來(lái)持續(xù)工作在這些點(diǎn)上斷開(kāi)，使之便于檢查和必定階段成果。版序控制記錄版序狀態(tài)擬稿審核批準(zhǔn)發(fā)布日期1.0系統(tǒng)軟件開(kāi)發(fā)部版本更新記錄*A-增長(zhǎng)M-修改D-刪除版本/修訂版修改頁(yè)碼修改記錄修改人日期1.0初始版本版本管理流程圖文檔歸檔流程文檔編寫(xiě)人員評(píng)審人員配備管理員編寫(xiě)文檔編寫(xiě)文檔修改文檔修改文檔不通過(guò)不通過(guò)文檔評(píng)審文檔評(píng)審?fù)ㄟ^(guò)擬定版本（歸檔入庫(kù)）打評(píng)審版本格式規(guī)范化檢查通過(guò)擬定版本（歸檔入庫(kù)）打評(píng)審版本格式規(guī)范化檢查文檔變更流程變更申請(qǐng)人評(píng)審人員文檔編寫(xiě)人員配備管理員提交變更提交變更取消取消變更通過(guò)不通過(guò)不通過(guò)變更影響分析及審批文檔評(píng)審?fù)ㄟ^(guò)不通過(guò)不通過(guò)變更影響分析及審批文檔評(píng)審?fù)ㄟ^(guò)變更通過(guò)變更實(shí)行更新版本更新版本（歸檔入庫(kù)）代碼歸檔流程開(kāi)發(fā)人員測(cè)試人員配備管理員源代碼入庫(kù)源代碼入庫(kù)從CVS從CVS庫(kù)提取源代碼修改源代碼修改源代碼不通過(guò)系統(tǒng)測(cè)試通過(guò)不通過(guò)系統(tǒng)測(cè)試通過(guò)從CVS庫(kù)提取源代碼進(jìn)行編譯更新版本入庫(kù)：安裝程序源代碼測(cè)試報(bào)告評(píng)審報(bào)告打測(cè)試版本制作安裝程序從CVS庫(kù)提取源代碼進(jìn)行編譯更新版本入庫(kù)：安裝程序源代碼測(cè)試報(bào)告評(píng)審報(bào)告打測(cè)試版本制作安裝程序代碼變更流程變更申請(qǐng)人評(píng)審人員開(kāi)發(fā)人員測(cè)試人員配備管理員提交變更提交變更取消取消變更不通過(guò)測(cè)試報(bào)告評(píng)審?fù)ㄟ^(guò)變更影響分析及審批不通過(guò)測(cè)試報(bào)告評(píng)審?fù)ㄟ^(guò)變更影響分析及審批通過(guò)不通過(guò)變更實(shí)行通過(guò)不通過(guò)變更實(shí)行代碼測(cè)試代碼測(cè)試更新版本更新版本（歸檔入庫(kù)）配備管理流程開(kāi)發(fā)人員項(xiàng)目管理人員測(cè)試人員配備管理員完畢開(kāi)發(fā)任務(wù)完畢開(kāi)發(fā)任務(wù)解決解決BUG提交發(fā)布祈求提交測(cè)試任務(wù)提交發(fā)布祈求提交測(cè)試任務(wù)回歸測(cè)試提交測(cè)試報(bào)告測(cè)試執(zhí)行測(cè)試籌劃、用例回歸測(cè)試提交測(cè)試報(bào)告測(cè)試執(zhí)行測(cè)試籌劃、用例新版本發(fā)布入庫(kù)輸出給市場(chǎng)部發(fā)布文檔更新擬定版本信息制做安裝程序更新測(cè)試環(huán)境新版本發(fā)布入庫(kù)輸出給市場(chǎng)部發(fā)布文檔更新擬定版本信息制做安裝程序更新測(cè)試環(huán)境流程闡明：1、開(kāi)發(fā)人員完畢所負(fù)責(zé)模塊代碼編寫(xiě)任務(wù)后，提交到項(xiàng)目經(jīng)理處2、項(xiàng)目經(jīng)理向測(cè)試部門(mén)提交測(cè)試任務(wù)3、配備管理員準(zhǔn)備測(cè)試所需環(huán)境4、測(cè)試人員開(kāi)展測(cè)試并實(shí)時(shí)提交BUG5、開(kāi)發(fā)人員解決測(cè)試過(guò)程中所浮現(xiàn)BUG，并提交給測(cè)試人員進(jìn)行回歸測(cè)試，直至BUG被關(guān)閉6、測(cè)試基本完畢后，測(cè)試人員提交測(cè)試報(bào)告7、項(xiàng)目狀況依照實(shí)際狀況決定與否發(fā)布新版本8、配備管理員與各有關(guān)人員經(jīng)討論后擬定好新版本各項(xiàng)信息9、配備管理員發(fā)布新版本軟件版本命名軟件版本號(hào)由四某些構(gòu)成，第一種1為主版本號(hào)，第二個(gè)1為子版本號(hào)，第三個(gè)1為階段版本號(hào)，第四某些為日期版本號(hào)加希臘字母版本號(hào)，希臘字母版本號(hào)共有5種，分別為：Alpha、Beta、RC、Release。例如：1.1.1.051021_Beta。對(duì)于小項(xiàng)目或子系統(tǒng)而言，可簡(jiǎn)化為<主版本號(hào)>.<次版本號(hào)>.<修訂版本號(hào)>，如1.0.0。*主版本號(hào)：當(dāng)功能模塊有較大變動(dòng)，例如增長(zhǎng)各種模塊或者整體架構(gòu)發(fā)生變化。此版本號(hào)由項(xiàng)目決定與否修改。*子版本號(hào)：當(dāng)功能有一定增長(zhǎng)或變化，例如增長(zhǎng)了對(duì)權(quán)限控制、增長(zhǎng)自定義視圖等功能。此版本號(hào)由項(xiàng)目決定與否修改。*階段版本號(hào)：普通是Bug修復(fù)或是某些小變動(dòng)，要經(jīng)常發(fā)布修訂版，時(shí)間間隔不限，修復(fù)一種嚴(yán)重Bug即可發(fā)布一種修訂版。此版本號(hào)由項(xiàng)目經(jīng)理決定與否修改。*日期版本號(hào)用于記錄修改項(xiàng)目當(dāng)前日期，每天對(duì)項(xiàng)目修改都需要更改日期版本號(hào)。此版本號(hào)由開(kāi)發(fā)人員決定與否修改。*Alpha版：此版本表達(dá)該軟件在此階段重要是以實(shí)現(xiàn)軟件功能為主，普通只在軟件開(kāi)發(fā)者內(nèi)部交流，普通而言，該版本軟件Bug較多，需要繼續(xù)修改。*Beta版：該版本相對(duì)于α版已有了很大改進(jìn)，消除了嚴(yán)重錯(cuò)誤，但還是存在著某些缺陷，需要通過(guò)多次測(cè)試來(lái)進(jìn)一步消除，此版本重要修改對(duì)像是軟件UI。*RC版：該版本已經(jīng)相稱(chēng)成熟了，基本上不存在導(dǎo)致錯(cuò)誤BUG，與即將發(fā)行正式版相差無(wú)幾。*Release版：該版本意味“最后版本”，在前面版本一系列測(cè)試版之后，終歸會(huì)有一種正式版本，是最后交付顧客使用一種版本。該版本有時(shí)也稱(chēng)為原則版。普通狀況下，Release不會(huì)以單詞形式出當(dāng)前軟件封面上，取而代之是符號(hào)(R)。版本升級(jí)版本升級(jí)原則版本升級(jí)應(yīng)嚴(yán)格納入版本管理控制之下。應(yīng)當(dāng)謹(jǐn)慎地控制版本升級(jí)，保障高版本向下兼容性，或提供嚴(yán)格定義升級(jí)辦法。在下面幾種狀況下，進(jìn)行版本演化和升級(jí)：1、當(dāng)產(chǎn)品發(fā)生重大修改和改進(jìn)時(shí)，主版本號(hào)加1。重大修改和改進(jìn)涉及：平臺(tái)遷移；開(kāi)發(fā)工具遷移；體系構(gòu)造變遷。2、當(dāng)產(chǎn)品發(fā)生較小改進(jìn)或修改時(shí)，次版本號(hào)可以加1。3、對(duì)于改動(dòng)量比較少，如修改產(chǎn)品錯(cuò)誤，可升級(jí)修訂版本號(hào)。4、記錄版本升級(jí)過(guò)程。每次版本升級(jí)，都要填寫(xiě)版本升級(jí)登記表，登記表樣例如下：版本升級(jí)登記表主版本子系統(tǒng)名稱(chēng)子系統(tǒng)版本發(fā)布日期功能變更描述發(fā)布負(fù)責(zé)人批準(zhǔn)人備注闡明：版本號(hào)：記錄當(dāng)前發(fā)布版本。發(fā)布日期：該版本批準(zhǔn)發(fā)布日期。修改文獻(xiàn)：版本修改記錄文獻(xiàn)，普通為版本修改日記。新版本發(fā)布新版本發(fā)布涉及主版本號(hào)和次版本號(hào)升級(jí)，普通不涉及內(nèi)部版本號(hào)升級(jí)。流程如下：依照項(xiàng)目進(jìn)展?fàn)顩r，或者依照顧客需要進(jìn)行發(fā)布準(zhǔn)備。將發(fā)布所需文獻(xiàn)進(jìn)行打包，放在指定目錄中，給目錄加上標(biāo)簽Tag，標(biāo)簽中包括將要發(fā)布版本信息。同樣對(duì)源碼文獻(xiàn)也要加上與版本信息有關(guān)標(biāo)簽Tag。標(biāo)簽Tag命名規(guī)則如下：構(gòu)成：模塊首字母+下劃線(xiàn)+文獻(xiàn)類(lèi)型+下劃線(xiàn)+主版本號(hào)+次版本號(hào)+內(nèi)部版本號(hào)+時(shí)間（+下劃線(xiàn)+合并標(biāo)記）樣例：qzcj_src_1_0_0_110923，qzcj表達(dá)采集模塊首字母，src表達(dá)源碼，1_0_0表達(dá)將要發(fā)布版本號(hào)，合并標(biāo)記可省略，只在有合并操作時(shí)注明，其中合并前標(biāo)記為mbe，合并后標(biāo)記為maf。目錄構(gòu)造但為了能更好地管理各項(xiàng)目組文檔，建議可將被管理配備項(xiàng)分為三大類(lèi)：文檔類(lèi)、源碼類(lèi)及安裝盤(pán)類(lèi)，這樣存儲(chǔ)比較清晰，有助于版本管理，現(xiàn)將目錄構(gòu)造整頓如下：根目錄一級(jí)目錄二級(jí)目錄相應(yīng)配備項(xiàng)備注resp源碼code前置采集源碼后臺(tái)計(jì)算源碼業(yè)務(wù)應(yīng)用源碼數(shù)據(jù)庫(kù)SQL文獻(xiàn)業(yè)務(wù)支撐公用開(kāi)發(fā)包文檔doc需求文檔立項(xiàng)報(bào)告、需求分析、需求記錄設(shè)計(jì)文檔軟件架構(gòu)、總體設(shè)計(jì)、概要設(shè)計(jì)、詳細(xì)設(shè)計(jì)、界面設(shè)計(jì)數(shù)據(jù)庫(kù)文檔數(shù)據(jù)字典、數(shù)據(jù)庫(kù)搭建、備份還原方案、PDM設(shè)計(jì)測(cè)試文檔測(cè)試籌劃、測(cè)試用例、測(cè)試報(bào)告顧客文檔顧客手冊(cè)、產(chǎn)品闡明籌劃文檔項(xiàng)目籌劃、年度月度籌劃外部接口文檔原則規(guī)范發(fā)布文獻(xiàn)SETUPreleaserar文獻(xiàn)發(fā)布文檔二級(jí)目錄中版本指某些特殊版本，不影響基線(xiàn)版本。文檔存儲(chǔ)文本文獻(xiàn)存儲(chǔ)依照各項(xiàng)目部自己狀況，將系統(tǒng)顧客需求記錄、總體設(shè)計(jì)文檔、詳細(xì)設(shè)計(jì)及數(shù)據(jù)構(gòu)造文獻(xiàn)、測(cè)試記錄、顧客手冊(cè)等放入CVS倉(cāng)庫(kù)doc目錄相應(yīng)子目錄下。源代碼存儲(chǔ)源代碼涉及如：java，jsp，BMP，ICO等有關(guān)文獻(xiàn)，是未經(jīng)編譯解決、不能直接交付使用產(chǎn)品文獻(xiàn)以及編譯產(chǎn)品所需文獻(xiàn)；聯(lián)機(jī)協(xié)助文獻(xiàn)HLP在未生成HLP文獻(xiàn)之前DOC，RTF等格式文檔也視為源代碼。各子系統(tǒng)當(dāng)前程序源文獻(xiàn)放入CVS倉(cāng)庫(kù)code目錄相應(yīng)bb目錄下，對(duì)于一種子系統(tǒng)又分各種分子系統(tǒng)狀況，應(yīng)在該目錄下分別建立幾種相應(yīng)子目錄。發(fā)行文檔存儲(chǔ)發(fā)行文檔是指產(chǎn)品交付顧客使用所必要文獻(xiàn)。涉及：產(chǎn)品可執(zhí)行文獻(xiàn)，顧客使用闡明書(shū)，聯(lián)機(jī)協(xié)助（HLP）；資源文獻(xiàn)（BMP，ICO等），環(huán)境配備文獻(xiàn)等。以上文檔作為制作發(fā)行盤(pán)素材，放在CVS倉(cāng)庫(kù)發(fā)布文獻(xiàn)目錄Release目錄之下，制作好發(fā)行盤(pán)放在發(fā)布文獻(xiàn)Setup目錄。權(quán)限控制管理為保障文檔安全性，一致性，以及防止意外修改，必要對(duì)不同文檔設(shè)立不同訪問(wèn)權(quán)限。文檔權(quán)限類(lèi)別：無(wú)任何權(quán)限，只讀權(quán)限，所有權(quán)限。文檔類(lèi)別：設(shè)計(jì)文檔，源碼，發(fā)行文檔。顧客類(lèi)別：開(kāi)發(fā)人員、測(cè)試人員、項(xiàng)目經(jīng)理、配備管理員等。為了控制不同使用權(quán)限，依照規(guī)定在服務(wù)器上分別建立不同顧客，針對(duì)不同配備項(xiàng)所在目錄分派不同權(quán)限。為了便于管理，應(yīng)以表格形式列出人員與管理對(duì)象訪問(wèn)關(guān)系（顧客權(quán)限清單），詳見(jiàn)《系統(tǒng)部CVS權(quán)限配備》。備份管理為了保證文檔最大可恢復(fù)性，要隨時(shí)及定期地進(jìn)行備份工作。源文獻(xiàn)備份開(kāi)發(fā)人員每天都要將自已當(dāng)天修改源文獻(xiàn)提交（commit）至CVS倉(cāng)庫(kù)。庫(kù)文獻(xiàn)備份為防止服務(wù)器浮現(xiàn)異常，需對(duì)服務(wù)器上CVS倉(cāng)庫(kù)文獻(xiàn)進(jìn)行備份，當(dāng)前采用方案如下：工作日備份：每個(gè)工作日將原本位于D盤(pán)倉(cāng)庫(kù)文獻(xiàn)在H盤(pán)上備份一份，當(dāng)D盤(pán)倉(cāng)庫(kù)浮現(xiàn)異常時(shí)，顧客可把ROOT目錄修改至H盤(pán)備份目錄，再進(jìn)行更新操作。每周備份：每周五下班時(shí)將H盤(pán)備份文獻(xiàn)異地備份至其他IP（當(dāng)前備份在192.168.53.68上）。每月備份：每月底將最新版本備份至光盤(pán)。顧客版本管理為了更好地管理源程序，應(yīng)為每一顧客建立一種顧客版本文獻(xiàn)，該文獻(xiàn)應(yīng)包括如下內(nèi)容：顧客編號(hào)：顧客名稱(chēng)：軟件版本號(hào)：開(kāi)始使用時(shí)間：聯(lián)系人：聯(lián)系電話(huà)：顧客程序更改日記樣例如下：更改時(shí)間版本號(hào)修改模塊名稱(chēng)變更因素變更概述軟件位置變更人員備注闡明：顧客購(gòu)買(mǎi)軟件時(shí)要為該顧客建立一種包括上述內(nèi)容一種顧客版本文獻(xiàn)，并填寫(xiě)關(guān)于數(shù)據(jù)。顧客進(jìn)行版本更新時(shí)規(guī)定填寫(xiě)該文獻(xiàn)版本變更記錄，用以反映顧客版本變更狀況。版本工具使用配備管理工具開(kāi)發(fā)部采用CVS進(jìn)行配備管理，CVS是一種C/S系統(tǒng)，各種開(kāi)發(fā)人員通過(guò)一種中心版本控制系統(tǒng)來(lái)記錄文獻(xiàn)版本，從而達(dá)到保證文獻(xiàn)同步目。當(dāng)前采用CVS服務(wù)端為cvsnt-2.5.03.2260，客戶(hù)端為T(mén)ortoiseCVS-1.8.29。CVS使用慣用命令英文命令中文命令操作、闡明備注Checkout提取/取出將文獻(xiàn)下載到本地目錄第一次下載目錄取Commit提交將改動(dòng)過(guò)文獻(xiàn)提交到版本庫(kù)每次對(duì)文獻(xiàn)更新后使用Update更新將文獻(xiàn)同步到最新版本獲取最新版本Tag標(biāo)簽給某個(gè)版本添加一種標(biāo)記符號(hào)便于合并分支與主線(xiàn)Branch分支創(chuàng)立某個(gè)文獻(xiàn)分支建立特殊版本時(shí)用到Merge合并將分支文獻(xiàn)（或主文獻(xiàn)）更改合并到主文獻(xiàn)（或分支文獻(xiàn)）diff比較不同比較任意兩個(gè)版本間不同ReversionGraph版本分支圖查看文獻(xiàn)各版本（涉及分支文獻(xiàn)）走向圖查詢(xún)各個(gè)版本及TagHistory歷史查看文獻(xiàn)各個(gè)版本更新歷史查詢(xún)版本詳細(xì)信息簡(jiǎn)樸操作文獻(xiàn)提?。撼醮问褂眯鑼⒃次墨I(xiàn)從倉(cāng)庫(kù)提取出來(lái)，執(zhí)行checkout命令將庫(kù)文獻(xiàn)提取至本地相應(yīng)位置。定期更新：開(kāi)發(fā)人員每天早上對(duì)源代碼或文獻(xiàn)進(jìn)行更新操作（右鍵執(zhí)行update操作）。實(shí)時(shí)更新：某一開(kāi)發(fā)人員提交更改后，可告知其他人員進(jìn)行更新操作。實(shí)時(shí)提交：對(duì)某一文獻(xiàn)進(jìn)行更改完畢后，執(zhí)行commit命令將更改提交至倉(cāng)庫(kù)，更改前先進(jìn)行更新操作，如各種人員對(duì)同一文獻(xiàn)同步進(jìn)行操作，會(huì)產(chǎn)生沖突，這時(shí)需要對(duì)沖突進(jìn)行解決。沖突解決：提交產(chǎn)生沖突時(shí)，先對(duì)文獻(xiàn)進(jìn)行同步（即更新）操作，之后會(huì)產(chǎn)生一種合并文獻(xiàn)，‘<’號(hào)前為兩個(gè)版本相似某些，‘＝’號(hào)前為本地版本修改內(nèi)容，‘>’前為當(dāng)前服務(wù)器最新版本修改內(nèi)容，找到近來(lái)提交該文獻(xiàn)同事，進(jìn)行協(xié)商后對(duì)源文獻(xiàn)進(jìn)行修改并提交。創(chuàng)立分支/標(biāo)簽：右鍵菜單中選取‘Branch’或‘Tag’找開(kāi)創(chuàng)立對(duì)話(huà)框，輸入Branch名或Tag名，選中‘Createnewbranch’/‘Createnewtag’，點(diǎn)擊OK即可。查看版本/歷史：文獻(xiàn)（非文獻(xiàn)夾）右健菜單中選取‘RevisionGraph..’或‘History..’，可查看該文獻(xiàn)版本更新記錄或歷史信息。版本分支管理咱們把一種項(xiàng)目重要開(kāi)發(fā)過(guò)程稱(chēng)作開(kāi)發(fā)基線(xiàn)。當(dāng)某一種特殊事件發(fā)生時(shí)候，例如，有一種顧客有特殊需求，于是就從這個(gè)開(kāi)發(fā)基線(xiàn)里分離出來(lái)一種叉，以滿(mǎn)足顧客特殊需求，這個(gè)叉有它自己發(fā)展方向，這就是分支。分支///●開(kāi)發(fā)基線(xiàn)上面這個(gè)點(diǎn)，代表開(kāi)發(fā)基線(xiàn)最新版本，如果從開(kāi)發(fā)基線(xiàn)建立分支來(lái)進(jìn)行定制開(kāi)