配置 JIRA

JIRA 是一個工具，可追蹤與您軟體相關的問題及錯誤。只要 Jenkins 或 Delivery Pipeline 執行部署，JIRA 工具整合就會更新專案的問題。

若要讓 JIRA 工具整合追蹤問題，您必須在確定訊息中使用 JIRA Smart Commit。要了解有關 JIRA 智能提交的更多信息，請參閱使用智能提交。

配置 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 工具整合支援下列配置參數，可與 Toolchain HTTP API 及 SDK 搭配使用。

您必須在要求內文中以 jira 值指定 tool_type_id 內容。

JIRA工具整合參數
參數	用法	類型	Terraform 引數	說明
API_URL	必要，可更新	字串	API_URL	JIRA 實例的基本 API URL。
enable_traceability	可選，可更新，`Default: false`	布林	enable_traceability	透過在提交、拉取請求和引用的問題上建立標籤、標籤和註釋來追蹤程式碼變更的部署。
密碼	選用，可更新	密碼	api_token	JIRA 帳戶的 API 記號。公用專案的選用項目。您可以對此參數使用工具鏈密鑰參照。如需相關資訊，請參閱在 Continuous Delivery。
project_key	必要，可更新	字串	project_key	JIRA 專案的專案索引鍵。
使用者名稱	選用，可更新	字串	使用者名稱	JIRA 帳戶的使用者名稱。公用專案的選用項目。