如要接收 Jenkins 建構項目的相關通知,請在 Chat 中使用 Jenkins 應用程式。
事前準備
- 你需要取得 Google Workspace 管理員授予的權限,才能安裝應用程式。
- 在 Chat 中新增應用程式。瞭解如何在 Chat 中尋找及新增應用程式。
步驟 1:在 Jenkins 伺服器上安裝 Chat 外掛程式
你必須以 Jenkins 管理員身分登入,才能進行安裝。
- 在裝置上下載 Chat Notifier Plugin file。
- 在「Jenkins」中依序選取「Manage Jenkins」「Manage Plugins」。
- 在「“Advanced”」分頁的「“Upload Plugin,”」下方,選取外掛程式檔案。
- 按一下「Upload」。
貴機構使用者現在可以安裝並設定 Jenkins 應用程式。
步驟 2:在 Chat 中設定 Jenkins 應用程式
如要將建構通知傳送至 Chat,Jenkins 需要應用程式產生的符記。每個已新增應用程式的聊天室都會獲得一個符記,而應用程式會傳送通知到每個該應用程式所屬的聊天室。
- 開啟 Google Chat。
- 開啟即時訊息或前往聊天室。
- 複製應用程式中的符記。
- (選用) 如要讓系統再次顯示符記,請選擇下列其中一種做法:
- 在即時訊息中輸入 token。
- 在聊天室中輸入 /jenkins_token。
- (選用) 如要重新產生符記,請按一下「Regenerate Token」。
步驟 3:設定通知
- 開啟「“Jenkins.”」
- 找到要新增 Chat 通知的建構項目。
- 在「“Build,”」下方,按一下「“Add build step,”」旁邊的「向下箭頭」圖示 。
- 選擇要接收的通知。
- 在「“Post-build Actions,”」下方,按一下「“Add post-build actions,”」旁邊的「向下箭頭」圖示 。
- 選取「Notify Hangouts Chat」。
- 選擇其中一個選項,並貼上從 Chat 複製的符記。
- Chat: 選擇先前設置的全域設定。
- Chat Token: 針對特定 Chat 聊天室覆寫全域設定。
- 針對你要在 Chat 中接收通知的項目,勾選對應的方塊。
- 按一下「Save」。
在建構事件通知中按一下:
- Open Build:這會修改 Jenkins 中的建構設定。
- View Details:這可讓你查看通知的相關資訊。
步驟 4:接收特定管道的通知
- 開啟「Jenkins」。
- 開啟要新增 Chat 通知的管道。
-
在管道指令碼中輸入:
hangoutsNotify message: "This message is from a pipeline!",token: {your_jenkins_token},threadByJob: false
提示:請務必將{your_jenkins_token}
替換成你從 Chat 應用程式取得的符記。你可以將threadByJob
設為true
或false
。 - 按一下「Save」。
在聊天室中使用應用程式
如要在聊天室中使用應用程式,你必須在每則傳送給應用程式的訊息以及回覆應用程式的訊息中使用 @ 號提及應用程式,這有助於確認你的訊息傳送對象是應用程式,而不是聊天室中的其他使用者。你也可以輸入 /jenkins_,然後從下拉式選單中選取所需指令。
透過 Chat 觸發建構項目
- 在已安裝 Jenkins 的聊天室或 Jenkins 即時訊息中,輸入 /jenkins_triggerJob。
- 在隨即開啟的對話方塊中,填寫下列必填欄位:"Jenkins URL," "Job Name," "UserName" and "ApiToken."
- 按一下「Submit」。
此外,你可以視需要選擇是否要儲存符記 (該符記一律不會顯示),並將選用參數傳遞至建構要求。
Google、Google Workspace 與相關符號和標誌均為 Google LLC 的商標。所有其他公司名稱和產品名稱則為相關公司的商標。