1.版本升級

版本升級是軟件維護(hù)和演進(jìn)中的關(guān)鍵環(huán)節(jié)，但它可能帶來一系列問題。這些問題涉及兼容性、功能、性能、安全性等方面。

• 【強(qiáng)制】版本管理：使用版本控制工具管理版本，確保不同版本間的兼容性。遵循語義版本控制（SemVer）原則，以清晰標(biāo)識版本間的兼容性。
• 【強(qiáng)制】遷移指南：提供詳細(xì)的遷移指南和文檔，幫助用戶了解版本升級的變化和兼容性注意事項(xiàng)。
• 【強(qiáng)制】回歸測試：在新版本發(fā)布前，執(zhí)行回歸測試，確保新版本的代碼不會破壞舊版本的功能。
• 【強(qiáng)制】灰度發(fā)布：在新版本發(fā)布時(shí)，采用灰度發(fā)布的方式，逐步將流量引導(dǎo)到新版本，并監(jiān)控兼容性問題。
• 【建議】自動(dòng)化測試：建立向后兼容性的自動(dòng)化測試，模擬舊版本客戶端的行為，驗(yàn)證其在新版本環(huán)境下的兼容性。

2.配置發(fā)布

服務(wù)配置變更是系統(tǒng)維護(hù)和優(yōu)化的重要操作，但如果配置變更過程中出現(xiàn)錯(cuò)誤，可能會導(dǎo)致線上問題。以下是規(guī)避服務(wù)配置變更引發(fā)問題的措施：

• 【強(qiáng)制】配置梳理。在發(fā)布前，梳理所有依賴的配置項(xiàng)，確保所有配置項(xiàng)的完整性，發(fā)布模板中的 checklist 需要有此動(dòng)作。
• 【強(qiáng)制】配置 Review。服務(wù)配置發(fā)布需要經(jīng)過其他同事 Review 同意后方可發(fā)布。
• 【強(qiáng)制】預(yù)發(fā)布環(huán)境驗(yàn)證：在將配置變更應(yīng)用到生產(chǎn)環(huán)境之前，先在預(yù)發(fā)布環(huán)境中進(jìn)行測試，確保配置變更不會引入新的問題。
• 【強(qiáng)制】發(fā)布后驗(yàn)證，由測試同學(xué)在生產(chǎn)環(huán)境進(jìn)行回歸驗(yàn)證，確保配置加載正確且系統(tǒng)功能正常。
• 【強(qiáng)制】配置回滾：建立有效的回滾機(jī)制，在配置變更出現(xiàn)問題時(shí)能夠快速恢復(fù)到穩(wěn)定的配置。
• 【建議】發(fā)布前驗(yàn)證：在配置變更前，使用配置驗(yàn)證工具或腳本檢查配置文件的正確性，確保語法和參數(shù)設(shè)置無誤。
• 【建議】在配置文件中注釋說明每個(gè)字段及其取值的含義。

3.數(shù)據(jù)庫/腳本操作

• 【強(qiáng)制】在進(jìn)行數(shù)據(jù)庫和腳本操作前，必須讓相關(guān)團(tuán)隊(duì)（如開發(fā)、運(yùn)維）review，確認(rèn)操作需求的詳細(xì)描述和業(yè)務(wù)背景，確認(rèn)操作的合理性和必要性，確保操作設(shè)計(jì)符合業(yè)務(wù)需求，并記錄所有操作場景及其用途。
• 【強(qiáng)制】優(yōu)化腳本和SQL語句，確保操作高效且不會對系統(tǒng)性能造成影響。例如，分批刪除數(shù)據(jù)避免全表掃描鎖表
• 【強(qiáng)制】在涉及多個(gè)步驟的操作中（如批量更新），使用數(shù)據(jù)庫事務(wù)，確保操作的原子性和一致性。
• 【強(qiáng)制】使用 DMS 平臺進(jìn)行數(shù)據(jù)庫變更操作，嚴(yán)格控制數(shù)據(jù)庫和腳本操作權(quán)限，確保只有授權(quán)人員才能進(jìn)行相關(guān)操作。
• 【強(qiáng)制】按照預(yù)先制定的操作步驟進(jìn)行操作，確保每一步操作都記錄在案。
• 【強(qiáng)制】在發(fā)布完成后，及時(shí)進(jìn)行回歸驗(yàn)證，確保操作執(zhí)行正確且系統(tǒng)功能正常。
• 【強(qiáng)制】對定期腳本的執(zhí)行過程和結(jié)果要有監(jiān)控告警和打印日志。
• 【建議】涉及重大的變更發(fā)布時(shí)，制定詳細(xì)的回滾方案，確保在操作出現(xiàn)問題時(shí)能夠快速恢復(fù)到操作前的狀態(tài)。常見的手段是備份當(dāng)前數(shù)據(jù)庫狀態(tài)，準(zhǔn)備好回滾腳本。
• 【建議】在操作完成后，進(jìn)行總結(jié)和反饋，記錄操作過程中出現(xiàn)的問題和解決方案，以便后續(xù)改進(jìn)。
• 【建議】定期進(jìn)行數(shù)據(jù)庫和腳本操作相關(guān)的培訓(xùn)和知識共享，提升團(tuán)隊(duì)成員的操作能力。

4.發(fā)布依賴確認(rèn)

發(fā)布依賴問題通常涉及到在軟件發(fā)布過程中，系統(tǒng)組件、庫或服務(wù)的依賴關(guān)系出現(xiàn)不一致或沖突，可能導(dǎo)致應(yīng)用程序運(yùn)行不穩(wěn)定或失敗。

為避免發(fā)布依賴不滿足導(dǎo)致的問題，可通過如下措施規(guī)避：

• 【強(qiáng)制】跨組的事項(xiàng)負(fù)責(zé)人需要梳理發(fā)布依賴項(xiàng)。
• 【強(qiáng)制】跨組的事項(xiàng)一定要確定負(fù)責(zé)人，統(tǒng)一發(fā)布節(jié)奏。
• 【強(qiáng)制】現(xiàn)網(wǎng)功能有損，修復(fù)發(fā)布的第一時(shí)間應(yīng)該是修復(fù)功能。要根據(jù)功能的情況、修復(fù)的復(fù)雜度，重要程度去思考如何發(fā)布。

5.發(fā)布規(guī)范

系統(tǒng)發(fā)布規(guī)范是指在軟件系統(tǒng)開發(fā)和部署過程中，為了確保系統(tǒng)的穩(wěn)定性、安全性和可維護(hù)性而制定的一系列標(biāo)準(zhǔn)和流程。這些規(guī)范有助于團(tuán)隊(duì)在發(fā)布新版本時(shí)保持一致性，減少錯(cuò)誤，確保用戶體驗(yàn)。以下是一些關(guān)鍵的系統(tǒng)發(fā)布規(guī)范：

強(qiáng)制：

• 確認(rèn)即將發(fā)布的版本已通過CI/CD流水線的所有測試，并且版本號正確。
• CI流水線應(yīng)該有增量覆蓋率的攔截節(jié)點(diǎn)，不允許代碼未經(jīng)測試就發(fā)布上線。
• 檢查服務(wù)器配置、網(wǎng)絡(luò)連接、數(shù)據(jù)庫、MQ、Redis 等，確保已經(jīng)配置正確。
• 選擇適當(dāng)?shù)陌l(fā)布時(shí)間，如盤后，確保在問題發(fā)生時(shí)有足夠的時(shí)間進(jìn)行處理，且不會影響到大部分用戶。
• 在發(fā)布完成后，及時(shí)進(jìn)行功能驗(yàn)證，確保新版本功能正常，系統(tǒng)穩(wěn)定。例如驗(yàn)證關(guān)鍵功能、接口、性能指標(biāo)等。
• 嚴(yán)格控制發(fā)布權(quán)限，確保只有授權(quán)人員才能進(jìn)行服務(wù)發(fā)布操作。
• 涉及其他依賴方的發(fā)布，需要通知對應(yīng)依賴方，依賴方確認(rèn)后方可發(fā)布。比如發(fā)布大流量場景應(yīng)提前通知數(shù)據(jù)上游擴(kuò)容，以免請求量激增導(dǎo)致上游服務(wù)被壓垮。

建議：

• 涉及重大發(fā)布時(shí)，按照預(yù)先制定的發(fā)布步驟進(jìn)行操作，確保每一步操作都記錄在案。
• 在發(fā)布完成后，進(jìn)行總結(jié)和反饋，記錄發(fā)布過程中出現(xiàn)的問題和解決方案，以便后續(xù)改進(jìn)。
• 編寫詳細(xì)的發(fā)布文檔，記錄發(fā)布步驟、注意事項(xiàng)、回滾方案等。
• 定期進(jìn)行發(fā)布相關(guān)的培訓(xùn)和知識共享，提升團(tuán)隊(duì)成員的發(fā)布操作能力。
• 生產(chǎn)環(huán)境的變更及時(shí)同步到驗(yàn)證群，并@相關(guān)同事進(jìn)行double check。

6.服務(wù)下線

服務(wù)下線屬于高危高作，可能會對系統(tǒng)的可用性和用戶體驗(yàn)產(chǎn)生負(fù)面影響。為減少服務(wù)下線所帶來的問題需要制定嚴(yán)格的規(guī)范流程和應(yīng)急措施。

• 【強(qiáng)制】制定下線計(jì)劃：明確服務(wù)下線的目標(biāo)和理由（如淘汰過時(shí)的服務(wù)、進(jìn)行重大升級等）。制定詳細(xì)的時(shí)間表，包括服務(wù)下線的開始時(shí)間、各階段時(shí)間點(diǎn)和預(yù)計(jì)完成時(shí)間。
• 【強(qiáng)制】通知相關(guān)方：內(nèi)部通知：通知開發(fā)、運(yùn)維、產(chǎn)品、客服等相關(guān)團(tuán)隊(duì)，確保所有團(tuán)隊(duì)了解服務(wù)下線的計(jì)劃和影響。外部通知：向用戶發(fā)布公告，告知服務(wù)下線的時(shí)間、影響范圍和替代方案。如果可能，提供替代服務(wù)或解決方案。
• 【強(qiáng)制】逐步下線：根據(jù)服務(wù)的功能模塊逐步下線，減少對用戶的影響。可以通過逐步停用功能或減少流量的方式進(jìn)行。
• 【強(qiáng)制】回滾計(jì)劃。指定服務(wù)下線過程中發(fā)生意外情況的回復(fù)計(jì)劃，比如服務(wù)重新上線，數(shù)據(jù)恢復(fù)等。
• 【建議】收集反饋：用戶反饋：收集用戶對服務(wù)下線過程的反饋，了解用戶體驗(yàn)和問題。內(nèi)部反饋：收集團(tuán)隊(duì)對下線過程的反饋，評估下線過程中的問題和改進(jìn)建議。

---

參考文獻(xiàn)