Git版本管理工具操作規(guī)范 V1.1

Git版本管理工具操作規(guī)范V1.1Git版本管理工具操作規(guī)范V1.1Git版本管理工具操作規(guī)范V1.1資料僅供參考文件編號：2022年4月Git版本管理工具操作規(guī)范V1.1版本號：A修改號：1頁次：1.0審核：批準:發(fā)布日期：Git版本管理工具操作規(guī)范2017年5月修改記錄編號日期描述版本作者審核發(fā)布日期1新建文檔劉田李凱靖//2調(diào)整文檔結(jié)構(gòu)，增加站點容器系統(tǒng)的git操作規(guī)范相關(guān)內(nèi)容，增加各系統(tǒng)工作流說明李凱靖李鐵山34目錄TOC\o"1-4"\h\u9586１引言 -6-32276１.１文檔目的 -6-999１.２適用對象 -6-1013１.３適用范圍 -6-19751２分支命名規(guī)范 -6-23471３操作規(guī)范 -7-24367３.１O(jiān)A系統(tǒng) -7-16145３.１.１工作流 -7-14647３.１.２開發(fā)人員日常操作規(guī)范 -7-12948克隆分支 -7-12165創(chuàng)建新分支 -8-23625提交修改內(nèi)容 -8-3875推送自己的開發(fā)分支到遠端 -8-8017合并自己的開發(fā)分支到主開發(fā)分支 -9-14344３.１.３測試人員日常操作 -9-1998克隆分支 -9-10668創(chuàng)建新分支操作 -9-13236合并開發(fā)人員的代碼 -10-7461合并自己的測試分支到主測試分支 -10-1772３.１.４運維人員日常操作 -10-24889克隆分支 -10-11672beta環(huán)境發(fā)布 -11-4117正式環(huán)境發(fā)布 -11-17795３.２站點容器系統(tǒng) -11-13178３.２.１工作流 -11-4095３.２.２開發(fā)人員操作規(guī)范 -12-21414３.２.３測試人員操作規(guī)范 -13-22459發(fā)送安裝包給運維 -13-3659合并開發(fā)分支到生產(chǎn)環(huán)境主分支 -13-21089４操作重點注意事項 -13-32319４.１開發(fā)人員注意事項 -13-17396４.１.１合并代碼操作注意事項 -13-16859４.１.２解決代碼合并沖突注意事項 -14-6724４.１.３配置文件操作注意事項 -14-7454４.２測試人員注意事項 -15-10492４.２.１解決沖突注意事項 -15-24077４.２.２配置文件操作注意事項 -15-13069４.２.３分支合并注意事項 -15-7397４.３運維人員注意事項 -16-5253４.３.１分支合并注意事項 -16-32542４.４個人賬號管理 -16-14358５定責(zé)標準 -16-6997５.１對日常工作造成影響 -16-7638５.２造成公司經(jīng)濟損失 -17-引言文檔目的本文檔旨在制定統(tǒng)一的Git版本管理工具的日常操作規(guī)范，解決因不規(guī)范操作而引起的系統(tǒng)異常問題，提高開發(fā)人員、測試人員、運維人員的工作效率與質(zhì)量，提升系統(tǒng)運行的穩(wěn)定性。適用對象本文檔適用于所有開發(fā)人員、測試人員、運維人員等相關(guān)技術(shù)人員使用。適用范圍本文檔適用于Git版本管理工具（OA系統(tǒng)與站點容器系統(tǒng)）。分支命名規(guī)范分支命名規(guī)范開發(fā)分支Dev測試分支TestBeta分支Beta生產(chǎn)環(huán)境分支Master新開發(fā)分支姓名拼音_[bug|task]_編號_簡要描述新測試分支姓名拼音_[bug|task]_編號_簡要描述操作規(guī)范OA系統(tǒng)工作流OA系統(tǒng)采用四條主分支的管理方式，分別為開發(fā)分支Dev、測試分支Test、Beta分支以及生產(chǎn)環(huán)境分支Master，其工作流如下圖所示：OA系統(tǒng)工作流示意圖開發(fā)人員日常操作規(guī)范克隆分支適用場景：開發(fā)人員第一次操作或后期特殊情況需要重新克隆分支時執(zhí)行此操作。操作步驟：右鍵Git克隆-》輸入源碼地址，設(shè)置分支名稱（開發(fā)人員固定為Dev）-》確定完成。創(chuàng)建新分支適用場景：開發(fā)人員有新的任務(wù)或BUG時需要創(chuàng)建新分支處理時執(zhí)行此操作操作步驟：在主開發(fā)分支下右鍵拉取-》右鍵創(chuàng)建分支（分支命名規(guī)范：姓名拼音_[bug|task]_編號_簡要描述），填寫相應(yīng)描述-》右鍵“切換/檢出”切換到新添加的分支。提交修改內(nèi)容適用場景：開發(fā)人員創(chuàng)建的開發(fā)分支完成或暫停任務(wù)時執(zhí)行此操作操作要求：不要求每做一次操作都進行一次提交，但是當(dāng)需要切換分支或是進行推送、拉取分支時，要求必須提交當(dāng)前的操作（新增文件一定要記錄加入到Git上）。提示：提交只會提交到本地不會影響別人的代碼或是主開發(fā)分支。推送自己的開發(fā)分支到遠端適用場景：開發(fā)人員將一個任務(wù)或BUG處理完，需要將分支推送到遠端時執(zhí)行此操作。操作步驟：在當(dāng)前自己的開發(fā)分支下右鍵推送（先提交后推送）-》輸入遠端分支名稱（與當(dāng)前本地分支名保持一致）-》確定完成。合并自己的開發(fā)分支到主開發(fā)分支適用場景：當(dāng)測試人員反饋安裝包己經(jīng)測試通過，此時開發(fā)人員需第一時間將已通過測試的開發(fā)分支合并到主開發(fā)分支。操作步驟：提交自己手上正在處理的分支-》切換到主開發(fā)分支上-》右鍵拉取主開發(fā)分支-》右鍵合并（找到對應(yīng)的開發(fā)分支）-》確定完成（如發(fā)生沖突則先解決沖突）-》右鍵推送（合并后的代碼必須要推送到遠端主開發(fā)分支上）。測試人員日常操作克隆分支適用場景：測試人員第一次操作或后期特殊情況需要重新克隆分支時執(zhí)行此操作。操作步驟：右鍵Git克隆-》輸入源碼地址，設(shè)置分支名稱（測試人員固定為Test）-》確定完成。創(chuàng)建新分支操作適用場景：測試人員需要對開發(fā)人員的代碼進行測試時必須創(chuàng)建新分支來處理。操作步驟：在主測試分支下右鍵拉取-》右鍵創(chuàng)建分支（分支命名建議：姓名拼音_[bug|task]_編號_簡要描述）,填寫相應(yīng)描述-》右鍵“切換/檢出”切換到新添加的分支。合并開發(fā)人員的代碼適用場景：測試人員需要先合并開發(fā)人員的代碼，再開展測試工作。操作步驟：在當(dāng)前自己的測試分支下右鍵合并-》搜索并選擇相應(yīng)開發(fā)人員的分支-》確定合并（如果出現(xiàn)沖突，請告知開發(fā)人員自行解決沖突后，再重新提交）。合并自己的測試分支到主測試分支適用場景：測試通過后測試人員需要將代碼合并到主測試分支上。操作步驟：右鍵切換到主測試分支-》右鍵拉取最新的主測試分支-》右鍵合并（找到對應(yīng)的測試分支）-》確定完成-》將程序發(fā)布到IIS上再進行一次測試-》測試完成后右鍵推送（合并上來的代碼必須要推送到遠端主測試分支上）。運維人員日常操作克隆分支適用場景：運維人員第一次操作或后期特殊情況需要重新克隆分支時執(zhí)行此操作。操作步驟：右鍵Git克隆-》輸入源碼地址（Beta環(huán)境需要設(shè)置分支名稱為Beta，Master環(huán)境無需設(shè)置分支名稱）-》確定完成。beta環(huán)境發(fā)布適用場景：運維人員需要進行beta環(huán)境版本發(fā)布時。操作步驟：右鍵拉取最新的Beta分支-》右鍵合并（找到主測試分支）-》確定完成-》提交到Beta本地倉庫-》推送到遠端Beta倉庫正式環(huán)境發(fā)布適用場景：運維人員需要進行正式生產(chǎn)環(huán)境版本發(fā)布時。操作步驟：右鍵拉取最新的Master分支-》右鍵合并（找到主Beta分支）-》確定完成-》提交到Master本地倉庫-》推送到遠端Master倉庫站點容器系統(tǒng)工作流站點容器系統(tǒng)采用兩條主分支的管理方式，分別為開發(fā)分支Dev與生產(chǎn)環(huán)境分支Master，其工作流如下圖所示：站點容器工作流示意圖開發(fā)人員操作規(guī)范操作項目詳情克隆新分支參考創(chuàng)建新分支參考提交修改內(nèi)容參考推送自己的開發(fā)分支到遠端參考打包安裝包開發(fā)人員需在模塊根目錄創(chuàng)建文件，并將相關(guān)信息打包為安裝包提交測試人員測試合并自己的開發(fā)分支到主開發(fā)分支參考，但如果修改的代碼涉及多個模塊，需相關(guān)模塊都測試通過，才能進行開發(fā)分支的合并操作測試人員操作規(guī)范發(fā)送安裝包給運維適用場景：開發(fā)分支打包為安裝包，對涉及模塊進行測試并測試通過后執(zhí)行該操作。操作步驟：按照發(fā)布計劃將安裝包提交給運維人員，進行發(fā)布。合并開發(fā)分支到生產(chǎn)環(huán)境主分支適用場景：運維將安裝包發(fā)布到線上后，對應(yīng)的開發(fā)分支需合并到生產(chǎn)環(huán)境主分支。操作步驟：右鍵切換到Master主分支-》右鍵拉取最新的Master主分支-》右鍵合并（找到對應(yīng)的開發(fā)分支）-》確定完成-》推送到遠端（合并上來的代碼必須要推送到遠端Master分支上）。操作重點注意事項開發(fā)人員注意事項合并代碼操作注意事項合并代碼前，必須從主分支上拉取最新的代碼，再進行合并。進行代碼合并時，要求開發(fā)人員不能覆蓋他人代碼，如出現(xiàn)代碼覆蓋導(dǎo)致系統(tǒng)異常的問題，發(fā)現(xiàn)人需自行確認責(zé)任人，未及時查找責(zé)任人，則由發(fā)現(xiàn)人承擔(dān)責(zé)任。責(zé)任人需協(xié)助問題發(fā)現(xiàn)人進行問題修復(fù)，不允許出現(xiàn)不理睬不處理。提示：出現(xiàn)代碼覆蓋問題，目前推薦的解決方案由被覆蓋了代碼的責(zé)任人重新提交本地代碼。如果修改的代碼涉及多個模塊，需相關(guān)模塊都測試通過，才能進行開發(fā)分支的合并操作。當(dāng)測試人員告知開發(fā)人員已經(jīng)測試通過時，開發(fā)人員要第一時間將分支合并到主開發(fā)上，以免出現(xiàn)其他人拉不到最新的代碼造成后期代碼合并測試時產(chǎn)生沖突。解決代碼合并沖突注意事項當(dāng)出現(xiàn)沖突時，由當(dāng)前開發(fā)人員負責(zé)解決沖突，如需要其他人協(xié)助解決沖突，請積極與相關(guān)人員進行溝通。如果開發(fā)人員在解決沖突時需要另一個開發(fā)人員協(xié)助，另一個開發(fā)人員需全力協(xié)助，不允許出現(xiàn)不理睬不處理。當(dāng)測試人員合并代碼時出現(xiàn)沖突，開發(fā)人員需積極解決沖突，但不能影響測試人員的正常工作（如使用測試人員的電腦解決沖突）。配置文件操作注意事項開發(fā)人員不允許添加配置文件，包括但不僅限于以下配置文件：App_Databgservice的測試人員注意事項解決沖突注意事項如果程序出現(xiàn)沖突必須由開發(fā)人員進行解決，測試人員不能擅自修改程序代碼，不能私自解決，更不能為了解決沖突而還原開發(fā)人員的代碼。配置文件操作注意事項測試人員不允許刪除配置文件，如出現(xiàn)跟配置文件相關(guān)的報錯，請進行還原配置文件操作。提示：如果合并時配置文件被刪除，測試人員可以在操作日志中將配制文件還原。分支合并注意事項合并分支前，必須拉取最新的分