IBM Cloud Docs
JIRA の構成

JIRA の構成

JIRA は、ユーザーのソフトウェアに関連する問題およびバグを追跡するツールです。 Jenkins または Delivery Pipeline によってデプロイメントが実行されるたびに、JIRA ツール統合はプロジェクトの問題を更新します。

JIRA ツール統合で問題をトラッキングするには、コミット・メッセージ内で JIRA Smart Commits を使用する必要があります。 JIRA Smart Commitsの詳細については、 「Smart Commitsの使用」 を参照してください。

品質コードの計画、追跡、および配信のために、JIRA を構成します。

  1. ツールチェーン作成時にこのツール統合を構成する場合は、「構成可能な統合」セクションで**「JIRA」**をクリックします。

  2. ツールチェーンをお持ちで、このツール統合を追加する場合は、コンソール IBM Cloud からメニュー アイコン( ハンバーガーアイコン>プラットフォーム自動化****>ツールチェーンをクリックしてください。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。

    a. **「ツールの追加」**をクリックします。

    b. 「ツール統合」セクションで**「JIRA」**をクリックします。

  3. JIRA プロジェクトがあり、それに接続したい場合、JIRA タイプとして**「既存」**をクリックします。

    a. JIRA プロジェクトの JIRA プロジェクト・キーを入力します。 プロジェクト・キーは JIRA プロジェクトの URL に含まれています。

    b. JIRA インスタンスのベース API URL を入力します。 API URL は、JIRA インスタンスのヘッダーで見つけることができます。 **「管理」アイコンをクリックし、「システム」**をクリックします。

    c. プライベート JIRA インスタンスに接続しているか、パブリック JIRA インスタンスからトレーサビリティー情報を受け取る場合は、JIRA のユーザー名とパスワードを入力します。

    d. 参照される問題に対するラベルおよびコメントを作成することによってプロジェクトに関するコード変更のデプロイメントをトラッキングするには、**「コード変更のデプロイメントを追跡する (Track deployment of code changes)」**チェック・ボックスにチェック・マークを付けます。 JIRA Smart Commit を使用して、GitHub コミットの JIRA 問題を参照するようにしてください。 このオプションが選択されていない場合、JIRA ツール統合はすべてのコミットを無視します。

  4. JIRA プロジェクトを作成する場合、JIRA タイプとして**「新規 (New)」**を選択します。

    a. 新規プロジェクトに使用する JIRA プロジェクト・キーを入力します。 このキーは、プロジェクト URL 内で固有 ID として使用されます。

    b. JIRA プロジェクトの名前を入力します。

    c. JIRA インスタンスのベース API URL を入力します。 API URL は、JIRA インスタンスのヘッダーで見つけることができます。 **「管理」アイコンをクリックし、「システム」**をクリックします。

    d. このプロジェクトに使用したい JIRA プロジェクト・リーダーのユーザー名を入力します。 JIRA プロジェクト・リーダーとして指定される個人は、JIRA でプロジェクト・リーダー許可を持っている必要があります。

    e. JIRA のこのインスタンスの管理者のユーザー名を入力します。

    f. JIRA のこのインスタンスの管理者のパスワードを入力します。

    g. 参照される問題に対するラベルおよびコメントを作成することによってプロジェクトに関するコード変更のデプロイメントをトラッキングするには、**「コード変更のデプロイメントを追跡する (Track deployment of code changes)」**チェック・ボックスにチェック・マークを付けます。 JIRA Smart Commit を使用して、GitHub コミットの JIRA 問題を参照するようにしてください。 このオプションが選択されていない場合、JIRA ツール統合はすべてのコミットを無視します。

  5. 「統合の作成」 をクリックします。

  6. ツールチェーンの「概要」ページの**「サード・パーティー・ツール」カードで、「JIRA」**をクリックして、接続先の JIRA プロジェクトのダッシュボードを表示します。

APIを使用したJIRAの設定

JIRAツール統合は、ツール統合 の作成読み取り更新時にToolchain HTTP APIおよびSDK で使用できる以下の設定パラメータをサポートしています。

jira 値を使用して、要求本体に tool_type_id プロパティーを指定する必要があります。

JIRAツール統合パラメータ
パラメーター 使用法 タイプ Terraform 引数 説明
api_url 必須、更新可能 ストリング api_url JIRAインスタンスのベース URL API。
enable_traceability オプション、更新可能、 Default: false ブール値 enable_traceability コミット、プルリクエスト、参照された課題に対してタグ、ラベル、コメントを作成し、コード変更のデプロイ状況を追跡する。
パスワード オプション、更新可能 パスワード API トークン ご使用の JIRA アカウントの API トークン。 パブリック・プロジェクトの場合はオプションです。 このパラメーターには、ツールチェーン秘密参照を使用できます。 詳しくは、 Continuous Deliveryでの機密データの保護 を参照してください。
プロジェクト・キー 必須、更新可能 ストリング プロジェクト・キー JIRA プロジェクトのプロジェクト・キー。
ユーザー名 オプション、更新可能 ストリング ユーザー名 ご使用の JIRA アカウントのユーザー名。 パブリック・プロジェクトの場合はオプションです。