配置 JIRA
DevOps Insights 將於 2026 年 8 月 31 日結束服務並停止運作。Continuous Delivery 將於 2027 年 2 月 12 日在以下地區停止運作:au-syd、ca-tor、us-east。 Code Risk Analyzer 也將於該日於所有地區停止提供服務。 若某個區域未實際使用這些功能,該區域中的功能可能會提前停用,並停止接受新的實例。 了解更多
JIRA 是一個工具,可追蹤與您軟體相關的問題及錯誤。 只要 Jenkins 或 Delivery Pipeline 執行部署,JIRA 工具整合就會更新專案的問題。
若要讓 JIRA 工具整合追蹤問題,您必須在確定訊息中使用 JIRA Smart Commit。 如需進一步了解 JIRA Smart Commits,請參閱《 使用 Smart Commits 》。
配置 JIRA,以計劃、追蹤及交付優質程式碼:
-
如果您要在建立工具鏈時配置此工具整合,請按一下「可配置的整合」區段中的 JIRA。
-
若您已擁有工具鏈並欲將此工具整合至其中,IBM Cloud 請從控制台點擊選單圖示 (
)> 平台自動化 > 工具鏈。 在「工具鏈」頁面中,點擊該工具鏈以開啟其「概覽」頁面。
a. 點擊「新增工具」。
b. 在「工具整合」區段中,按一下 JIRA。
-
如果您有 JIRA 專案,並且要與之連接,請針對 JIRA 類型按一下現有:
a. 鍵入 JIRA 專案的 JIRA 專案索引鍵。 您可以在 JIRA 專案的 URL 中找到專案索引鍵。
b. 鍵入 JIRA 實例的基礎 API URL。 您可以從 JIRA 實例的標頭中找到 API URL。 按一下管理圖示,然後按一下系統。
c. 如果您要連接至專用 JIRA 實例,或要接收來自公用 JIRA 實例的可追蹤性資訊,請輸入 JIRA 使用者名稱及密碼。
d. 若要透過建立所參照問題的標籤及註解來追蹤專案的程式碼變更部署,請選取追蹤程式碼變更部署勾選框。 請確定您使用 JIRA Smart Commit,以在 GitHub 確定中參照 JIRA Issues。 如果您未選取此選項,則 JIRA 工具整合會忽略任何確定。
-
如果您要建立 JIRA 專案,請針對 JIRA 類型按一下新建:
a. 鍵入要用於新專案的 JIRA 專案索引鍵。 此索引鍵用作專案 URL 中的唯一 ID。
b. 鍵入 JIRA 專案的名稱。
c. 鍵入 JIRA 實例的基礎 API URL。 您可以從 JIRA 實例的標頭中找到 API URL。 按一下管理圖示,然後按一下系統。
d. 鍵入您要用於此專案之 JIRA 專案領導人的使用者名稱。 若要將某個人指定為 JIRA 專案領導人,該人員必須具有 JIRA 中的專案領導人許可權。
e. 鍵入此 JIRA 實例的管理者使用者名稱。
f. 鍵入此 JIRA 實例的管理者密碼。
如: 若要透過建立所參照問題的標籤及註解來追蹤專案的程式碼變更部署,請選取追蹤程式碼變更部署勾選框。 請確定您使用 JIRA Smart Commit,以在 GitHub 確定中參照 JIRA Issues。 如果您未選取此選項,則 JIRA 工具整合會忽略任何確定。
-
按一下建立整合。
-
在「工具鏈」的「概觀」頁面上的 協力廠商工具 卡片上,按一下 JIRA,以檢視您所連接之 JIRA 專案的儀表板。
使用 API 來配置 JIRA
JIRA 工具整合支援下列配置參數,您 可在建立、讀取及 更新工具整合時,透過工具鏈 HTTP API 與 SDK 使用這些參數。
您必須在要求內文中以 jira 值指定 tool_type_id 內容。
| 參數 | 用法 | 類型 | Terraform 引數 | 說明 |
|---|---|---|---|---|
| API_URL | 必要,可更新 | 字串 | API_URL | 您 JIRA 實例的基礎 API URL。 |
| enable_traceability | 可選、可更新、Default: false |
布林 | enable_traceability | 透過在提交、拉取請求及相關問題上建立標籤、標記和註解,來追蹤程式碼變更的部署狀況。 |
| 密碼 | 選用,可更新 | 密碼 | API 金鑰 | JIRA 帳戶的 API 記號。 公用專案的選用項目。 您可以對此參數使用工具鏈密鑰參照。 如需相關資訊,請參閱 在 Continuous Delivery。 |
| 專案金鑰 | 必要,可更新 | 字串 | 專案金鑰 | JIRA 專案的專案索引鍵。 |
| 使用者名稱 | 選用,可更新 | 字串 | 使用者名稱 | JIRA 帳戶的使用者名稱。 公用專案的選用項目。 |