日期：2025年 07月 12日

標籤： Jenkins Continuous Integration(CI) Continuous Deployment(CD) Docker Docker-Compose Container Ubuntu Linux Windows Jenkins DotNETSDK

摘要：Jenkins

第一部分：問題描述

Step 1：舊版遷移到新版 Jenkins - 遭遇問題

需求上，會需要將舊版的 Windows Jenkins 機器淘汰，轉移到新版 Jenkins 並且使用 Ubuntu 作業系統安裝

此時不可能讓我們直接將舊的 Windows Jenkins 的所有內容貼上到Jenkins(Ubuntu 容器化) 的新機器上
首先面臨的問題就是作業系統不同與版本差異 ，這就是要克服的部分。將在第二、第三部分說明

Step 2：建立可復現的 Jenkins 容器 - 目的

可復現容器是適合 團隊協作、CI/CD 穩定性與環境一致性需求強的場景
並且實現後有以下好處(目的)：

可以避免大量的重工 & 排查不同環境下的問題 & 可攜性 & 支援多環境部署

第二部分：各轉移項目 - 安全的做法

Step 1：版本落差太大 - 跨平台遷移的風險

以下是基本跨平台 Windows 轉移到 Linux 上的風險差異

Step 2：版本落差太大 & 需遷移的內容 - 安全的作法

基於風險上的描述後，Jenkins 要搬遷從 Windows 的 Jenkins (安裝在作業系統上) 到 Linux Ubuntu 上的容器 Jenkins
分成以下可搬移的項目，分析說明

跨平台的升級 Jenkins 基本上都是手動重建，只有在 相同作業系統 、 相同Jenkins版本下，複製可搬移的方案才是最有可能的

Step 3：補充說明 - 以 Job 舉例，為何建議手動

我們隨意開啟舊版 Jenkins (Windows)機器下的 Job 目錄的作業中的 config.xml
一眼看去可以知道語言 UTF-8 、 Pluging 相依套件，若遷移的 Jenkins 語系不同會發生錯誤、套件不支援也會發生錯誤
因此 建議手動 搬遷，讓 Ubuntu 的 Jenkins 自動產出新的設定值

第三部分：舊版遷移到新版 Jenkins

Step 1：搬移項目說明

手動重建的項目會直接忽略，會依序對這些項目做搬移說明：

以下 2 項會在 第四部分：建立可復現的 Jenkins 容器 說明：

Step 2：確保 Jenkins 容器可執行 - dotnet 已安裝

為了確保 Jenkins 容器可建置 DotNet Core，首先要進入 Jenkins 容器中

docker exec -u root -it {你的 Jenkins 容器 ID} bash

並且安裝 DotNet Core，依序執行：

curl -O https://packages.microsoft.com/config/ubuntu/20.04/packages-microsoft-prod.deb
dpkg -i packages-microsoft-prod.deb
apt-get update
apt-get install -y apt-transport-https
apt-get install -y dotnet-sdk-8.0

全部安裝完後，可以在容器內輸入以下檢查：

dotnet -v

Step 5：確保 Jenkins 容器可執行 - 權限足夠

為了確保 Jenkins 容器權限足夠，可以用 root 權限啟動容器：
備註：依照實際情況使用，若為開發環境 100% 可以這樣配置

docker run -d --name jenkins --user root --rm -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts

Step 6：Views 視景 - 將 config.xml 檔案複製 - 複製來源

將舊版 Jenkins (Windows)機器下的 config.xml 進行複製，檔案路徑 :

您的安裝目錄\\jenkins\\config.xml

Step 7：Views 視景 - 將 config.xml 檔案複製 - 覆蓋目標

直接覆蓋貼上

Step 8：Views 視景 - DEMO成果 - Views 建構完成

可以看到 Views 會出現，完成了 Views 的遷移
再次提醒：若有安裝大量 Views 插件，仍有可能因為 Windows -> Ubuntu 造成異常，出現 Jenkins OOPS!

Step 9：Users 帳號 - 將 users 資料夾全部複製 - 複製來源

將舊版 Jenkins (Windows)機器下的 users 資料夾全部複製，檔案路徑 :

您的安裝目錄\\jenkins\\users\\

Step 10：Users 帳號 - 將 users 資料夾全部複製 - 覆蓋目標

全部直接覆蓋貼上，複製的時候注意 admin 帳號，也會被取代

Step 11：Views 視景 - DEMO果 - Users 帳號建立完成

可以從Jenkins管理 -> 使用者設定 看到所以舊版 Jenkins (Windows)機器的所有使用者帳號

再次提醒：這個方法是有可能造成以下狀況，輸入相同帳號密碼無法登入，原因為新舊版、作業系統上加密方式有差異，因此解密會異常

第四部分：建立可復現的 Jenkins 容器

Step 1：新機器上 - 建立 DockerFile 與 DockerCompose

在 Ubuntu 宿主機上，開啟一個資料夾並且建立 dockerfile 與 docker-comopese.yml 檔案
※內容可從範例腳本

Step 2：新機器上 - Tools 工具配置 - DockerFile 腳本

此腳本實現了以下：
其中 Tools 工具

FROM jenkins/jenkins:2.452.2
USER root

RUN curl -O https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb && \
    dpkg -i packages-microsoft-prod.deb && \
    apt-get update && \
    apt-get install -y apt-transport-https && \
    apt-get install -y dotnet-sdk-8.0

COPY plugins.txt /usr/share/jenkins/ref/plugins.txt
RUN jenkins-plugin-cli --plugin-file /usr/share/jenkins/ref/plugins.txt

RUN ln -sf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime
RUN echo 'Asia/Shanghai' > /etc/timezone

USER jenkins

補充：Microsoft 不支援 Jenkins 的 Plugin 安裝 dotnet 8.0 SDK ，停留在 5.0

Step 3：新機器上 - Tools 工具配置 - DockerCompose 腳本

此腳本實現了以下：

version: '3.8'

services:
  jenkins:
    container_name: Jenkins
    build:
      context: .
      dockerfile: Dockerfile
    ports:
      - "8080:8080"
      - "50000:50000"
    volumes:
      - jenkins_home:/var/jenkins_home
      - ./jenkins_root:/container_root
    restart: unless-stopped

volumes:
  jenkins_home:

Step 4：舊機器上 - Plugins 外掛插件 - 進入控制台

舊版 Jenkins (Windows)機器進入 Jenkins管理 -> Scripts 控制台

Step 5：舊機器上 - Plugins 外掛插件，取得 txt 檔案

輸入以下 Goovy Script

def plugins = Jenkins.instance.pluginManager.plugins 
plugins.each {println "${it.getShortName()}:${it.getVersion()}"}

Step 6：舊機器上 - Plugins 外掛插件 - 複製所需插件

將產生的內容，依照自己新的 Jenkins 機器所需要的插件，進行複製

Step 7：Plugins 外掛插件 - 建立 plugins.txt 檔案

複製並且貼上，格式符合 :

插件名稱:版本號

第五部分：DEMO 成果 - 可復現容器

Step 1：進入新機器，並到可復現的資料集合目錄下

進入安裝範例檔案(docker-compose.yml)的根目錄下

cd /home/containerbuild

Step 2：安裝 docker-compose

依序輸入以下指令安裝啟動
先關閉舊的安裝 (如果有安裝過的話)

docker compose donw -v

執行安裝

docker compose up -d

Step 3：登入新機器容器化的 Jenkins - 首次登入

啟動完成後，輸入網址列訪問

http://{你的機器IP}:8080

預設需要輸入 secret 做 admin 權限的登入，下一個 Step 說明如何取得容器化內的 initalAdminPassword

Step 4：首次登入 - 找出 Volumes 位置

輸入以下指令找出產生的掛載位置

docker inspect Jenkins

Step 5：首次登入 - 進入 Volumes 位置 - 取得 secret

進入新容器的宿主機此資料位置


複製金鑰，並且繼續登入 完成 Step 3. 的工作

Step 6：首次登入 - 開始使用 - 跳過設置插件

登入後，因為第一次登入，會跳出插件安裝，直接選擇右上角的 X ，因為已經在 dockerFile 步驟中完成

Step 7：檢查插件 - 可復現容器化 Jenkins - 完成

可以到 Jenkins管理 -> Plugins 配置 -> 可檢查到舊版Windows 的插件已經出現到新版的Ubuntu Jenkins 中


也可直接檢查容器掛載的 Plugins 資料夾，也都會自動安裝所有 plugins.txt 清單中的套件