如何整合 Code Stream 與 Jenkins

Code Stream 提供 Jenkins 外掛程式，此外掛程式可觸發建置和測試原始程式碼的 Jenkins 工作。Jenkins 外掛程式可執行測試案例，並且可以使用自訂指令碼。

若要在管線中執行 Jenkins 工作，您可以使用內部部署或雲端式 Jenkins 伺服器，並且在 Code Stream 中新增 Jenkins 端點。然後，您可以建立管線並向其新增 Jenkins 工作。

必要條件

• 設定執行 1.561 版或更新版本的內部部署或雲端式 Jenkins 伺服器。
• 如果您使用內部部署 Jenkins 伺服器，請確認您可以存取 VMware Cloud Assembly 以便能夠新增雲端 Proxy。如需範例，請參閱設定 VMware Code Stream 以建立發佈程序模型。
• 確認您是 Code Stream 中的專案的成員。如果您不是管理員，請要求 Code Stream 管理員將您新增為專案成員。請參閱如何在 VMware Code Stream中新增專案。
• 確認 Jenkins 伺服器上存在某個工作，以便管線工作能夠執行此工作。

程序

1. 新增並驗證 Jenkins 端點。
   1. 按一下端點 > 新增端點。
   2. 選取專案，然後針對端點類型選取 Jenkins。然後，輸入名稱與說明。
   3. 如果此端點是您基礎結構中的業務關鍵元件，請啟用標記為受限制。
   4. 如果此端點位於內部部署中，請選取將其連線到 Code Stream 的雲端 Proxy。
   5. 輸入 Jenkins 伺服器的 URL。
   6. 輸入用於登入 Jenkins 伺服器的使用者名稱和密碼。然後輸入其餘資訊。

      表 1. Jenkins 端點的其餘資訊

      端點項目	說明
      資料夾路徑	將工作進行分組的資料夾的路徑。Jenkins 可以執行資料夾中的所有工作。您可以建立子資料夾。例如： folder_1 可包含 job_1 folder_1 可包含 folder_2，後者可能含有 job_2 針對 folder_1 建立端點時，資料夾路徑為 job/folder_1，且端點僅列出 job_1。 若要取得名為 folder_2 之子資料夾中的工作清單，您必須建立將資料夾路徑用作 /job/folder_1/job/folder_2/ 的另一個端點。
      URL	Jenkins 伺服器的主機 URL。輸入 protocol://host:port 格式的 URL。例如： http://192.10.121.13:8080
      輪詢間隔	Code Stream 輪詢 Jenkins 伺服器以進行更新的間隔持續時間。
      申請重試計數	針對 Jenkins 伺服器重試已排程的建置申請的次數。
      重試等待時間	針對 Jenkins 伺服器重試建置申請前等待的秒數。

   7. 按一下驗證，並確認端點會連線至 Code Stream。如果無法連線，請更正任何錯誤，然後按一下儲存。
      
2. 若要建置程式碼，請建立管線，並新增使用 Jenkins 端點的工作。
   1. 按一下管線 > 新增管線 > 空白畫布。
   2. 按一下預設階段。
   3. 在 [工作] 區域中，輸入工作的名稱。
   4. 選取工作類型為 Jenkins。
   5. 選取您建立的 Jenkins 端點。
   6. 從下拉式功能表中，從管線將執行的 Jenkins 伺服器中選取工作。
   7. 輸入工作的參數。
   
3. 啟用和執行管線，並檢視管線執行。
   
4. 在管線儀表板上查看執行詳細資料和狀態。
   您可以識別任何失敗及失敗原因。您還可以查看有關管線執行持續時間、完成和失敗的趨勢。
   

結果

恭喜您！透過新增端點、建立管線，並設定建置程式碼的 Jenkins 工作，以整合 Code Stream 與 Jenkins。

範例： Jenkins 建置工作的範例 YAML

對於此範例中使用的 Jenkins 建置工作類型，YAML 類似於下列程式碼，其中通知已開啟：

test:
  type: Jenkins
  endpoints:
    jenkinsServer: jenkins
  input:
    job: Add two numbers
    parameters:
      Num1: '23'
      Num2: '23'

後續步驟

檢閱其他區段以瞭解更多資訊。請參閱將 VMware Code Stream 連線至端點。