本文首發於：Jenkins 中文社群

原文連結    作者：Gunter Rotsaert

譯者：Yanjun Shi

30分鐘搞定 Jenkins CI

設定新的 Jenkins CI，以便可以開始測試新的 Jenkins 外掛

你想在本地設定中使用 Jenkins CI 進行實驗嗎？在本文中，我們將設定一個本地 Jenkins CI 服務，為一個簡單的 Spring Boot Maven 專案建立一個構建工作，並將建立的 Docker 映象推送到 DockerHub。這將是一個本地實驗的設定，但如果你想嘗試一個 Jenkins 外掛，它會非常方便。

1.先決條件

開始之前，我們需要以下先決條件：

• 我們使用了 Ubuntu 18.04；
• 必須安裝 Docker，有關安裝說明，請參見此處；
• 我們需要在 Docker registry 來推送我們的 Docker 映象。最簡單的方法是在DockerHub上建立一個帳戶。你可以免費建立帳戶。也不會收到垃圾廣告郵件；

• 構建工作的 Spring Boot 應用程式。我們將使用前一篇文章中的 Spring Boot MVC 應用程式。原始碼可以在GitHub上找到，相應的Docker影象可以在DockerHub上找到。該應用程式包含 http://localhost:8080/hello

   上的一個 HTTP 端點，並只返回一條 Hello Kubernetes 歡迎訊息。

  2.執行 Jenkins CI

  我們將使用 Jenkins CI Docker 官方映象執行 Jenkins 服務。完整的文件可以在這裡找到。用以下命令啟動容器:

$ docker run -p 8080:8080 --name myjenkins -v jenkins_home:/var/jenkins_home -v jenkins_downloads:/var/jenkins_home/downloads jenkins/jenkins:lts

讓我們來仔細看看我們正在做什麼:

• -p 8080:8080：我們將內部 Jenkins 埠（冒號後）對映到外部埠，該埠可從我們的 Docker 主機訪問；
• –name myjenkins：我們為容器提供一個名稱；否則，Docker將為你生成一個名稱。最好給它起個名字；這樣，你可以輕鬆地啟動和停止容器；
• -v jenkins_home:/var/jenkins_home：我們希望將內部 Jenkins 主目錄(冒號之後)對映到 Docker 主機上的一個目錄。通過這種方式，Jenkins 資料將被儲存在我們的主機上，這讓我們有機會備份資料；
• -v jenkins_downloads:/var/jenkins_home/downloads：我們需要在Jenkins中安裝額外的工具； 因此，我們建立一個目錄來複制 *.tar.gz 檔案。在這篇文章的後面，我們將清楚地知道我們將使用目錄做什麼；
• jenkins/jenkins:lts：要使用的 Docker 映象。我們將使用 LTS 版本，但如果你願意，也可以使用不太穩定的版本。在撰寫本文時，v2.150.1 是 LTS 版本。 在此之後，你可以通過其名稱停止和啟動容器：

··· $ docker stop myjenkins $ docker start myjenkins ···

3.配置 Jenkins 以供首次使用

一旦容器啟動後，我們就可以訪問 Jenkins Web 控制檯了。當然，我們需要知道 Jenkins 例項的 IP 地址。因此，請執行以下命令：

$ docker inspect myjenkins

這將顯示一些 JSON 輸出。轉到該 Networks 部分，引數 IPAddress 顯示我們的 Jenkins IP 地址（在我們的例子中為172.17.0.3）：

"Networks": {
  "bridge": {
    "IPAMConfig": null,
    ...
    "IPAddress": "172.17.0.3",
    ...
    "DriverOpts": null
  }
}

Jenkins Web 控制檯可通過瀏覽器訪問 http://172.17.0.3:8080/。

這將向我們顯示以下頁面：

我們使用臨時密碼，啟動容器後在控制檯輸出中顯示:

*************************************************************
*************************************************************
*************************************************************
Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:
f586346583e04fa78e2cc8edbf7566e1
This may also be found at: /var/jenkins_home/secrets/initialAdminPassword
*************************************************************
*************************************************************
*************************************************************

輸入臨時密碼後，將顯示一個頁面，在這裡我們可以選擇要安裝的預設外掛集或自定義外掛集。我們將選擇預設設定。

現在，坐等外掛安裝好:

接下來，建立第一個管理員使用者：

最後，配置 Jenkins 例項：

太棒了！Jenkins 現在已經準備好可以使用了:

4.安裝所需的工具

我們的構建需要在 Jenkins 中提供一些工具。我們需要 JDK11，Maven 和 Docker。在下一節中，我們將展示如何在容器中使用這些屬性。

在啟動容器期間，我們在容器中建立了 /var/jenkins_home/downloads 的掛載卷。首先，我們將驗證是否可以從容器中訪問此路徑。執行以下命令：

··· $ docker exec -it myjenkins ls -l /var/jenkins_home/downloads total 0 ···

如上所述返回0個結果時，那麼我們就可以繼續了。否則，你必須檢查在啟動容器期間是否輸入正確。

4.1 安裝 JDK 11

我們將使用 Adopt OpenJDK 11，可在此處下載。我們必須將下載的 *.tar.gz 檔案複製到已安裝在主機上的卷 jenkins_home/downloads 中。為了檢索我們機器上的路徑，我們再次執行 docker inspect 命令，就像以前檢索Jenkins IP地址一樣。這一次，轉到分段 Mounts：

"Mounts": [
  ...
  {
    "Type": "volume",
    "Name": "jenkins_downloads",
    "Source": "/var/lib/docker/volumes/jenkins_downloads/_data",
    "Destination": "/var/jenkins_home/downloads",
    ...
  }
],

在我們的示例中，卷位於 /var/lib/docker/volumes/jenkins_downloads/_data 上。將 *.tar.gz 檔案複製到此位置。

跳轉到 Manage Jenkins – Global Tool Configuration 和 *JDK 安裝部分*。單擊 Add JDK 按鈕。預設情況下，java.sun.com 會新增安裝程式。我們不會使用這個，所以刪除它並新增一個 Extract *.zip/*.tar.gzinstaller。根據下面的螢幕截圖填寫欄位。二進位制存檔的路徑是 file:/var/jenkins_home/downloads/OpenJDK11U-jdk_x64_linux_hotspot_11.0.1_13.tar.gz。Label 留空是很重要的；否則，JDK的安裝將失敗。

跳轉到 *Manage Jenkins – Configure System*，到 Global properties 部分並啟用 *環境變數*。為其新增環境變數 JAVA_HOME並填充路徑 /var/jenkins_home/tools/hudson.model.JDK/JDK11/jdk-11.0.1+13。

4.2 安裝 Maven

我們將使用 Maven 3.6.0，可以在這裡下載。安裝過程與 JDK 安裝相同：下載 *.tar.gz 檔案並將其複製到 jenkins_home/downloads。

轉到 Manage Jenkins – Global Tool Configuration 和 Maven 安裝部分。單擊 Add Maven 按鈕。預設情況下，Apache 會新增安裝程式。我們不會使用這個，所以刪除它並新增一個 Extract *.zip/*.tar.gzinstaller。根據下面的螢幕截圖填寫欄位。二進位制存檔的路徑是 file:/var/jenkins_home/downloads/apache-maven-3.6.0-bin.tar.gz。Label 留空是很重要的；否則，Maven 的安裝將失敗。將子目錄設定為 apache-maven-3.6.0 也很重要；否則，Maven 主目錄沒有正確設定，mvn 可執行檔案將無法找到。

4.3 配置 Docker

在 Docker 內部安裝 Docker 不是一個好主意，請參閱本文。因此，我們將使用宿主機的 Docker 安裝，並將宿主機的 Docker 套接字掛載到容器。實際上，這也不是一個好主意，但是對於我們的 Jenkins 實驗環境來說，這是可以的，但是出於安全原因，永遠不要以這種方式暴露 Docker 套接字。

我們刪除現有的容器（這不是有害的，因為我們的所有資料都儲存在我們的主機上，我們不會丟失任何資料），然後使用 -v /var/run/docker.sock:/var/run/docker.sock 重新啟動容器。

$ docker rm myjenkins
$ docker run -p 8080:8080 --name myjenkins -v /var/run/docker.sock:/var/run/docker.sock -v jenkins_home:/var/jenkins_home -v jenkins_downloads:/var/jenkins_home/downloads jenkins/jenkins:lts

為了使其工作，我們還必須設定 docker.sock 的許可權給 jenkins 使用者。預設情況下，它被掛載為 root，因此，由於 Permission Denied 錯誤，我們的構建將失敗。

以 root 身份登入 Docker 容器:

$ docker exec -it -u root myjenkins

檢查許可權 docker.sock，這表明它擁有者 root：

$ ls -l /var/run/docker.sock
srw-rw---- 1 root 999 0 Jan 6 11:45 /var/run/docker.sock

讓 jenkins 成為新所有者，並再次列出許可權:

$ chown jenkins: /var/run/docker.sock
$ ls -l /var/run/docker.sock
srw-rw---- 1 jenkins jenkins 0 Jan 6 11:45 /var/run/docker.sock

現在，jenkins 是所有者，我們不會再得到 Permission Denied 的錯誤。

為了將 Docker 映象推入 Docker registry，我們需要通過 settings.xml 將憑據提供給 Maven。我們可以通過配置檔案提供程式外掛輕鬆地提供 settings.xml。去 Manage Jenkins – Manage plugins 並安裝外掛(不重啟安裝)。

轉到 *Manage Jenkins – Managed files*，然後單擊 *Add a new Config*。建立 Global Maven settings.xml 並使用 DockerHub 帳戶憑據新增以下部分：

<servers>
  <server>
    <id>docker.io</id>
    <username>docker_username</username>
    <password>docker_password</password>
  </server>
</servers>

5.建立構建工作

最後要做的是建立我們的構建工作。轉到 Jenkins CI 主頁，然後單擊 *New Item*。我們將把構建工作命名為 *MyKubernetesPlanet*，並選擇一個 *Freestyle Project*。

在構建工作的配置部分，我們轉到 Source Code Management 部分，並填寫 Git URL https://github.com/mydeveloperplanet/mykubernetesplanet.git 和 branch */feature/jenkinsci。

在 Build 部分，我們添加了一個 Invoke top-level Maven targets 的構建步驟。我們將呼叫以下 Maven 目標來構建我們的應用程式並將 Docker 映象推送到 Docker registry：

$ clean install dockerfile:push

我們還需要設定之前建立的 Maven版本 和 *全域性配置檔案*。

手動為我們的工作啟動構建，這將建立 jar 檔案，建立我們的 Docker 映象，並將其推送到 Docker registry。

6.結論

在本文中，我們提供了一種讓 Jenkins 例項執行的快速方法，包括執行 Maven 構建、建立 Docker 映象並將其推入 Docker registry 的構建作業。請注意，這不是一種安全的方法，但是對於實驗用例來說，它並沒有太大的危害。現在我們已經有了一個完全執行的 Jenkins 例項，我們可以使用它來測試新的 Jenkins 外掛。

相關推薦