軟件三庫管理規(guī)范

1、規(guī)定了公司軟件開發(fā)庫、受控庫、產(chǎn)品庫（以下簡稱三庫）的管理規(guī)范1 參考文獻軟件三庫管理制度2 術(shù)語和定義GitLab ：一個倉庫管理系統(tǒng)，使用 Git 作為代碼管理工具，并在此基礎(chǔ)上搭建起來的web服務(wù)。Jenkins ：基于 Java 開發(fā)的一種持續(xù)集成平臺，用于監(jiān)控持續(xù)重復(fù)的工作。SPM公司研發(fā)部開發(fā)的持續(xù)集成工具，用于集成軟件部署包。Releaser :公司研發(fā)部開發(fā)的基于SPM勺軟件部署包發(fā)布工具。Kiwi TCMS:公司研發(fā)部基于開源代碼改進的測試用例管理系統(tǒng)，用于測試計劃和測試用例的創(chuàng)建和維護、以及測試執(zhí)行的記錄。3 職責3.1 軟件三庫管理職責軟件開發(fā)庫由項目組管理，軟件受控庫由

2、研發(fā)部管理，軟件產(chǎn)品庫由質(zhì)量部管理。3.2 軟件管理員職責a）具備軟件配置管理知識；b）熟悉研制項目的配置管理；c）熟悉公司結(jié)構(gòu)、軟件三庫管理規(guī)定、標識規(guī)定和軟件配置管理計劃。4 管理內(nèi)容與方法4.1 建立軟件三庫開發(fā)庫a）開發(fā)庫代碼部分和說明部分基于 GitLab 建立，按照軟件項目分配倉庫。項目組長任倉庫Master，負責需求說明的管理、成員管理、問題跟蹤、分支Merge、 任務(wù)分配、 Tag 標識等工作。項目組成員任倉庫Developer，負責設(shè)計和交付說明的管理、問題調(diào)查、分支維護 等工作。測試組成員任倉庫 Reporter ，負責測試說明的管理、報告問題、問題回歸等工作。b）開發(fā)庫部

3、署包部分基于Jenkins和SPM建立，按照軟件項目分配倉庫。項目組成員負責維護自動測試腳本和版本生成腳本。Jenkins 管理員（計算機）任庫管理員，負責自動檢查代碼編譯結(jié)果，執(zhí)行版本生 成腳本將通過檢查的工程生成待測軟件部署包，執(zhí)行自動測試腳本驗證軟件部署包， 將通過驗證的軟件部署包打上標識，放入倉庫。另任庫管理員，負責出入庫管理、配置項管理等工作。受控庫a）受控庫代碼部分基于 GitLab 建立，按照軟件項目分配倉庫。軟件經(jīng)理任倉庫Master，負責將通過完整測試的開發(fā)版本打上 Tag標識，在GitLab 上作為獨立穩(wěn)定的分支，該分支不接受更改，有效受控。b）受控庫部署包部分基于Jenk

4、ins和SPM建立，按照軟件項目分配倉庫。Jenkins管理員（計算機）任庫管理員，負責將打上 Tag標識的代碼版本生成軟件 部署包，打上同樣的 Tag 標識，放入倉庫。該部分目錄及目錄下文件一旦生成，不可刪除或更改，有效受控。c）受控庫說明部分存在于公司內(nèi)部的公共服務(wù)器。另任庫管理員，負責出入庫管理、配置項管理等工作。d）受控庫測試用例部分基于 Kiwi TCMS建立，按照軟件項目分配倉庫。項目組長具有測試計劃審核權(quán)限，測試組長具有測試用例編輯和測試用例審核權(quán) 限，測試組成員具有測試用例編輯權(quán)限。產(chǎn)品庫產(chǎn)品庫存在于公司內(nèi)部公共服務(wù)器，按照軟件項目分配倉庫。另任庫管理員，利用Releaser工

5、具將通過申請的打上Tag的受控版本生成軟件產(chǎn) 品包，負責各產(chǎn)品的出入庫管理、配置項管理等工作。4.2 制定三庫管理規(guī)定內(nèi)容要求軟件三庫管理規(guī)定：a）入庫控制相關(guān)人填寫入庫申請，負責人審批，庫管理員操作或檢查入庫，詳見三庫管理要 求（第、節(jié)）。b）訪問控制各倉庫設(shè)置權(quán)限管理，一般來說，給予庫管理員寫權(quán)限，給予相關(guān)人讀權(quán)限，詳 見三庫管理要求（第、 、節(jié)）。c）出庫控制相關(guān)人填寫出庫申請，負責人審批，庫管理員操作出庫，通過安全介質(zhì)交予相關(guān) 人，詳見三庫管理要求（第、 、節(jié)）。d）庫間轉(zhuǎn)換庫間轉(zhuǎn)換遵循入庫控制的要求。e）更改控制詳見三庫管理要求（第、節(jié)）。f）配置狀態(tài)報告詳見受控庫和產(chǎn)品庫管理要求（

6、第、節(jié)）0g) 配置審核詳見受控庫和產(chǎn)品庫管理要求(第、節(jié)) 。h) 維護規(guī)程GitLab 平臺搭建在服務(wù)器上， Jenkins 平臺搭建在服務(wù)器上，產(chǎn)品庫位于服務(wù)器(群暉NAS,采用RAID技術(shù)便于數(shù)據(jù)重構(gòu)，每晚0點各平臺數(shù)據(jù)庫對現(xiàn)有數(shù)據(jù)進行 自動備份。每三個月對三庫服務(wù)器進行檢查維護，以便從緊急狀態(tài)恢復(fù)。相關(guān)要求軟件三庫管理規(guī)定相關(guān)要求：a) 配置項選擇配置項選擇由項目組識別。b) 配置標識各庫采用適應(yīng)性標識，標識規(guī)范詳見三庫管理要求。c) 版本控制代碼版本由 GitLab 自動管理，部署包版本由 Jenkins 自動管理，產(chǎn)品包版本由產(chǎn) 品庫管理員管理。d) 基線建立和更改(基線的基本劃

7、分和更改)采用 GitLab 平臺的里程碑概念，里程碑要求分自主升級與項目組要求兩部分。e) 軟件發(fā)行軟件發(fā)行必須經(jīng)過測試、申請、審批。4.3 安全控制庫管理員在入庫、出庫、更改、發(fā)行時，實施介質(zhì)鑒別、病毒檢查和權(quán)限審查。4.4 軟件開發(fā)庫管理要求入庫內(nèi)容 軟件開發(fā)庫入庫內(nèi)容應(yīng)是項目確定的軟件配置項。項目組按照顧客方要求和研制項目 特點明確軟件配置項的種類、格式和內(nèi)容，對軟件規(guī)模和復(fù)雜度不大的項目，可將軟件配 置項種類作適應(yīng)的合并，但應(yīng)確保內(nèi)容完整。庫屬性軟件開發(fā)庫屬性一般應(yīng)包括的內(nèi)容：a) 配置項(配置標識、配置項位置) ，b) 開發(fā)人，入庫時間，c) 更改人，更改時間，d) 提取人，出庫時

8、間，以及提取原因，e) 其他。入庫控制將符合項目標識、版本等軟件配置要求的軟件配置項入庫，并按照庫屬性的相關(guān)要求 做入庫記錄。訪問控制軟件開發(fā)庫代碼部分和說明部分的訪問控制基于GitLab權(quán)限機制實現(xiàn)，部署包部分的訪問控制基于服務(wù)器的權(quán)限機制實現(xiàn)。出庫控制軟件開發(fā)庫出庫應(yīng)按照以下要求進行：a）按規(guī)定的權(quán)限出庫：如無極特殊的情況，代碼部分不允許出庫；實需出庫的情況，須經(jīng)項目組長和軟 件經(jīng)理審批；部署包部分和配置項部分的出庫經(jīng)項目組長審批，由項目組配置管理員操作出庫。b）登記出庫原因、去向和用途、使用人等信息；c）記錄出庫項、提取人和出庫時間等信息。更改控制軟件開發(fā)庫的更改應(yīng)按照以下要求進行：a）

9、按規(guī)定的權(quán)限實施更改：項目組相關(guān)人建立Git分支，完成更改后提交由GitLab自動備份，在Jenkins發(fā) 起集成，提交部署包給測試組成員，完成更改測試后將結(jié)果反饋給項目組，項目組長 審核通過，將該分支Merge到主分支，并在Jenkins發(fā)起集成；應(yīng)客戶特殊需求更改的分支不應(yīng) Merge到主分支，通過測試后直接轉(zhuǎn)入受控庫；項目組成員相應(yīng)修改配置項；b）利用GitLab的刨能向相關(guān)人實時發(fā)布更改信息，以便相關(guān)人做相應(yīng)更改；特別緊急的情況，可口頭通知之后需在 GitLab的Issue平臺記錄；c）Git分支及更改的配置項須符合標識、版本的要求，標記對應(yīng)版本的里程碑：Bug修復(fù)型更改須以hotfi

10、x/開頭，需求蠕動型更改須以feature/開頭。轉(zhuǎn)受控庫在軟件開發(fā)過程中，通過公司認可的測試或評審的軟件配置項轉(zhuǎn)入受控庫。受控庫的代碼和部署包一般具有release/的tag標識，公司內(nèi)部使用的保留develop入庫內(nèi)容軟件受控庫的入庫內(nèi)容是通過測試或評審的軟件配置項以及公司和顧客方認可的其 他內(nèi)容。庫屬性軟件受控庫屬性至少應(yīng)包括以下內(nèi)容:a）配置項（配置標識、配置項位置），b）開發(fā)人、開發(fā)時間，c）評測人、評測時間，d）入庫批準人、入庫時間，e）更改說明、更改人、更改批準人、更改時間、更改申請?zhí)?，f）出庫目的、提取人、出庫時間、出庫批準人，以及g）其他。入庫控制當開發(fā)庫中的軟件配置項完成評

11、測時，開發(fā)人提出入庫申請；受控庫管理員審查入庫 項的標識、版本以及測評發(fā)現(xiàn)的問題是否歸零；受控庫管理員有關(guān)入庫信息進行登記。訪問控制軟件受控庫代碼部分的訪問控制基于 GitLab權(quán)限機制實現(xiàn)，部署包部分和說明部分 的訪問控制基于服務(wù)器的權(quán)限機制實現(xiàn)。出庫控制提取人提交出庫（或復(fù)制）申請；相關(guān)負責人審批；受控庫管理員對有關(guān)出庫信息進 行登記。更改控制不對受控庫配置項實施更改，所有更改以升級的形式實現(xiàn)，將升級后的相關(guān)配置項按 照入庫規(guī)則進行入庫，并及時向有關(guān)人員發(fā)布更改信息。升級標識符合規(guī)定：核心升級，第一位升一級；依賴升級，第二位升一級，bug修復(fù)和需求蠕動，第三位升一級；alpha標識對內(nèi)，b

12、eta標識對外。配置狀態(tài)報告受控庫管理員在配置項更改時向公司的有關(guān)部門報告配置狀態(tài)，并向生產(chǎn)、使用、維 護相關(guān)人員發(fā)布受控庫配置信息。配置審核在研制階段結(jié)束之前對受控庫進行配置審核：a）研發(fā)部指定配置審核人員；b）配置審核人員擬制配置審核計劃，并獲批準；c）實施配置審核；d）項目組對審核發(fā)現(xiàn)的不符合項進行整改；e）配置審核人員驗證整改情況；f）將配置審核及驗證結(jié)果通報軟件經(jīng)理。轉(zhuǎn)產(chǎn)品庫在定型（鑒定）通過后，將軟件受控庫中的軟件配置項轉(zhuǎn)入軟件產(chǎn)品庫，其他相關(guān)項 納入檔案管理，其保存期應(yīng)與系統(tǒng)服役期保持一致4.6軟件產(chǎn)品庫管理要求入庫內(nèi)容軟件產(chǎn)品庫入庫內(nèi)容是供交付、生產(chǎn)、檢驗驗收、維護的軟件產(chǎn)品和

13、其他軟件工作產(chǎn) 品。庫屬性軟件產(chǎn)品庫屬性一般應(yīng)包括以下內(nèi)容：a）配置項（配置標識、配置項位置）b）開發(fā)人、開發(fā)時間，c）入庫時間、入庫批準人，d）評測時間、評測人，e）評審組長、評審時間，f）更改說明、更改人、更改批準人、更改時間、更改申請?zhí)?，g）發(fā)行人、發(fā)行版本、發(fā)行時間，h）出庫目的、出庫時間、提取人、出庫批準人，以及i）其他。入庫控制開發(fā)人提出入庫申請；產(chǎn)品庫管理員對入庫項進行標識和版本審查；公司代表（或授 權(quán)人）應(yīng)會同顧客方代表共同批準入庫；產(chǎn)品庫管理員有關(guān)入庫信息進行登記。出庫控制軟件產(chǎn)品庫中的項出庫（或復(fù)制）時，由使用部門或提取人提交出庫（或復(fù)制）申請; 公司代表（或授權(quán)人）審批；產(chǎn)品庫管理員對有關(guān)出庫信息登記。更改控制不對產(chǎn)品庫配置項實施更改，所有更改以升級的形式實現(xiàn)，將升級后的相關(guān)配置項按 照入庫規(guī)則進行入庫，并及時向有關(guān)人員發(fā)布更改信息。公司會嚴格控制升級，升級標識符合規(guī)定：核心實現(xiàn)升級，第一位升一級；依賴實現(xiàn) 升級，第二位升一級，bug修復(fù)、配置更改、需求蠕動等，第三位升一級。配置狀態(tài)報告產(chǎn)品庫管理員在配置項更改時向公司的有關(guān)部門和顧客方代表報告配置狀態(tài)，并向生 產(chǎn)、使用、維護相關(guān)人員發(fā)布軟件產(chǎn)