Jenkins升級後頁面出現部分英文的問題處理

從低版本的Jenkins升級到高版本,特別是LTS版本低於2.138.4升級到高於LTS版本2.164.1的情況,就可能出現界面中英文混合的情況,而且通過安裝localization-zh-cn插件都無法解決,如下所示:


經過反覆的降級和升級,並按官網的LTS升級說明進行升級,也沒能解決這個問題,直到對插件目錄plugins進行替換操作,才發現一堆舊版本的插件纔是導致這個問題的罪魁禍首,至於是哪個插件我們也沒法去詳細追究(因爲太多插件了)。


解決方案有兩種

一種是主動降LTS版本,降到之前能顯示中文的低版本或更早版本,就能正常顯示中文(但是這方案治標不治本);

另一種方案是一種迂迴的方案,就是選擇另一臺機器,先安裝最新版本的Jenkins(下載地址:https://jenkins.io/download/)

image.png


比如看到的右側顯示最新版本是2.168,左側顯示最新的LTS版本是2.164.1,我們可以直接選擇下載安裝最新LTS的2.164.1版本,是以完整包的模式進行安裝,安裝後還需要選擇安裝所有常用插件。這樣我們得到plugins目錄插件就相對完整(而且都是標準版本的插件,乾淨未被污染的插件)。


然後把最新版本的plugins目錄覆蓋到舊版本的jenkins目錄下(覆蓋前做好目錄備份,以便出現問題時能夠及時回滾,一般備份好plugins目錄和config.xml文件,以防萬一再把users目錄也備份一下)。


替換完最新版本的plugins目錄後,我們就可以把jenkins.war包也替換成最新的2.164.1版本,然後啓動jenkins服務,這時候進入首頁面應該就能看到完整的中文界面了:

image.png

如果出現登錄提示用戶名或密碼不正確,可以考慮把我們備份的users目錄替換回去(因爲新版本的user文件格式會有變化,可能導致token授權問題)。


剩下的遺留問題就是插件的版本問題了,一般常用插件都不多,我們檢查一下系統管理的各項配置,看看有沒有問題需要調整的,如果沒有就恭喜你升級成功了。


爲了確保所有插件不出現依賴問題或嚴重錯誤(如郵件發送),我們可能需要對插件進行一次糾正,第一步是將插件版本降級到上一版本(選擇按鈕【降到】,當然降級前我們也要備份一下plugins文件夾以防萬一):

降級成功後,重啓jenkins,然後看插件的警告,記住只要是依賴錯誤的插件我們都要想辦法處理和糾正,處理的方式包括升級或是卸載後重裝。


如果是像上面那樣提示failed to load的 ,說明就要想辦法卸載了,而且是可能自動卸載不掉的,我們就需要停止jenkins服務,手動刪除plugins目錄下的指定插件文件(同名下的文件,如Pipeline全刪除),然後啓動服務重新下載這個插件。糾正完依賴錯誤後,我們的插件就能完全滿足最新版本的jenkins了,這時候再檢查一下相關配置,有些相關插件比如郵件的SMTP服務和賬號密碼可能會因爲插件的更新而丟失,需要重新配置一下。


總結:Jenkins的更新,只要保證配置文件,users和Jobs、workspace等歷史數據的完整性,就不會丟失我們的重要歷史數據,所以無論如何降級和升級都不會帶來災難性的問題,在開源系統中屬於更新升級分險很小的了。


補充說明:正常情況下,中文失效後,按照官網的說明安裝插件localization-zh-cn,並在系統設置中配置中文Locale(Default Language=zh_CN)就應該能解決。如果不能解決,一般就是升級過程中,插件出現了依賴包失效或部分插件加載失敗的情況,間接導致localization-zh-cn插件因爲依賴關係而不起作用。


上面說就是太麻煩了,或者下載中文插件試試

下載並啓用插件:localization-zh-cn-plugin

在jenkins的插件管理頁面,在可用插件搜索:localization-zh-cn 。就可以安裝這個插件,然後重啓jenkins服務,然後就解決問題了。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章