# Jenkins on Windows 心得分享 (05)：如何將介面顯示語言設定為英文(en)

早期版本的 [Jenkins](https://www.jenkins.io/) 由於多國語系的設定完全依賴瀏覽器的語言設定自動判斷，為了要強制將介面調整為 English (英文) 還需要特別安裝 Chrome 擴充套件才能做到。不過新版的 Jenkins 已經不用這麼麻煩了，你只要加裝 [Locale](https://plugins.jenkins.io/locale/) 外掛，就可以指定顯示語言。本篇文章也順便講解使用 Docker 建置 Jenkins 的完整過程。

### 使用 Docker 安裝與啟動 Jenkins 最新版本

1.  取得最新版 `jenkins/jenkins:lts` image
    
    ```powershell
    docker pull jenkins/jenkins:lts
    ```
    
2.  建立 `jenkins-data` volume 用來保存 Jenkins 所有設定
    
    ```powershell
    docker volume create jenkins-data
    ```
    
3.  啟動 Jenkins 容器
    
    ```powershell
    docker run -d --rm --name jenkins -p 8080:8080 -p 50000:50000 -v jenkins-data:/var/jenkins_home jenkins/jenkins:lts
    ```
    
    > 注意：Port `8080` 是 Jenkins 預設 Web 介面。Port `50000` 則是用來讓 [Jenkins Agent](https://www.jenkins.io/doc/book/using/using-agents/) 建立連線的 Port 埠號。
    
4.  取得預設管理者密碼(`initialAdminPassword`)
    
    ```powershell
    docker exec -it jenkins cat /var/jenkins_home/secrets/initialAdminPassword | clip
    ```
    
    > Windows 10 有內建一個 `C:\Windows\System32\clip.exe` 執行檔，可以將 Console 輸出直接放入「剪貼簿」中，對於複製 Jenkins 預設管理者密碼非常方便！👍
    
5.  啟動 Jenkins 介面
    
    ```powershell
    start http://localhost:8080/
    ```
    
    ![Unlock Jenkins](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/8adac9e004df423a2d75-116778325-cc5d7480-aaa3-11eb-89fb-69b40b40e644.png)
    
    > 因為步驟 4 已經複製了預設管理者密碼，所以直接 `Ctrl-V` 貼上即可登入成功！
    

### 加裝 [Locale](https://plugins.jenkins.io/locale/) 外掛

1.  在首次安裝的時候，你就可以選取 **Select plugins to install** 按鈕
    
    ![Customize Jenkins](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/14a816b083886864b36b-116778434-70472000-aaa4-11eb-9d73-5999be6ffa9e.png)
    
2.  除了預設的 Plugins 之外，建議加裝 [Locale](https://plugins.jenkins.io/locale/) 外掛，然後按下 **Install** 按鈕
    
    ![Select plugins to install - Languages - Locale](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/91aa28e0b97fc53776e6-116778517-eba8d180-aaa4-11eb-88fd-8b20778183da.png)
    
    > 如果你要在 Windows 建置 .NET 專案，建議可加裝 [MSBuild](https://plugins.jenkins.io/msbuild/) 外掛！
    
3.  安裝完成並成功登入後，先針對系統進行 Locale 設定
    
    ![Manage Jenkins - Configure System](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/75b5005167caa54ea3b2-116779226-9de19880-aaa7-11eb-9041-9af4bbf539e9.png)
    
    請找到 Locale 區段的設定，並將 **Default Language** 設定 `en`，而 `Ignore browser preference and force this language to all users` 請務必勾選
    
    ![Manage Jenkins - Configure System - Locale](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/20c84646809ca44f0712-116779293-0af52e00-aaa8-11eb-865b-39cf7b21f87e.png)
    
    按下 **Apply** 之後，畫面就會全部顯示為「英文」了！
    
    ![Jenkins English locale](https://stwillblogassets.blob.core.windows.net/files/images/external/user-images.githubusercontent.com/58a16e1e5e46c0b4581f-116779529-3b899780-aaa9-11eb-9051-83e84d2d9599.png)
    

### 相關連結

-   [Jenkins Plugins](https://plugins.jenkins.io/)
    -   [Locale](https://plugins.jenkins.io/locale/)
    -   [MSBuild](https://plugins.jenkins.io/msbuild/)