IBM Cloud Docs
JIRA の構成

JIRA の構成

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

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

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

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

  2. ツールチェーンがあり、そこにこのツール統合を追加する場合、IBM Cloudコンソールから、メニューアイコンの ハンバーガーアイコン>Platform Automation>Toolchains をクリックします。 「ツールチェーン」ページで、ツールチェーンをクリックしてその「概要」ページを開きます。 あるいは、アプリの「概要」ページの「継続的デリバリー」カードで、**「ツールチェーンの表示」をクリックします。 次に、「概要」**をクリックします。

    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 ツール統合は、 作成、 読み取り、および 更新 のツール統合時に ツールチェーンの HTTP API および SDK で使用できる以下の構成パラメーターをサポートします。

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

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