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

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

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

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

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

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

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

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

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

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

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

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

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

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