DevOps チェンジベロシティ へのオンボードJira - クラシック

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

    • Jira サーバーまたは Jira クラウドインスタンスを接続して、プロジェクトおよび作業アイテム (ストーリー、エピック、機能など) を検出、構成、およびインポートします。

    始める前に

    DevOps チェンジベロシティの開始のタスクを完了します。

    必要なロール:sn_devops.admin または sn_devops.tool_owner

    手順

    1. Jira サーバーまたは Jira クラウドインスタンスに接続します。
      1. 次のように移動する。 DevOps > ツール > 新規作成 (従来).
      2. Jira インスタンスに接続するための詳細を入力します。
        Jira サーバー
        1. [ツール名] フィールドに、ツールの名前を入力します。
        2. [ツール統合] フィールドで、[Jira] を検索して選択します。
        3. Jiraサーバーインスタンスの URL を入力します。
        4. [ 認証情報タイプ ] リストから、 Jira サーバーとの接続に使用する認証タイプを選択します。

          • 基本認証

            1. Jiraサーバーのユーザー名を入力します。
              注:
              ここで使用する Jira ユーザーには、 Jira アドミニストレーター権限が必要です。
            2. このインスタンスにアクセスするためのパスワードまたはアクセストークンを入力します。
          • API キー

            インスタンスにアクセスするための API トークンを入力します。
        Jira クラウド
        1. [ツール名] フィールドに、ツールの名前を入力します。
        2. [ ツール統合 ] フィールドで、[ Jira Cloud] を検索して選択します。
        3. [ ツール URL ] フィールドに、 Jira クラウドインスタンスの URL を入力します。
        4. [ 認証情報タイプ ] フィールドで、[ 基本認証 ] または [OAuth 2.0] を選択します。

          基本認証

          1. Jira Cloud のユーザー名を入力します。
            注:
            ここで使用する Jira ユーザーには、 Jira アドミニストレーター権限が必要です。
          2. このインスタンスにアクセスするためのパスワードまたはアクセストークンを入力します。

          OAuth 2.0

          前提条件：
          [ ツール認証情報 ] フィールドで、既存の OAuth 2.0 ツール認証情報レコードを選択します。
          注:
          使用されておらず、Jira Cloud 用に構成されていないレコードのみを、既存の認証情報レコードとして選択できます。

        Jira に接続するために認証情報に必要なすべての権限のリストについては、「DevOpsツールに必要な権限Jira権限」を参照してください。

      3. オプション: Jira インスタンスがMID サーバーに添付されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。

        MID サーバーの詳細については、「MID サーバーの選択」を参照してください。

      4. [Submit (送信)] を選択します。

      ツールは、接続エイリアスと HTTP ツール接続 (基本認証情報) を使用して自動的に接続されます。

    ツールが正常に作成されると、ツールレコードページが表示されます。
    1. ツールへのアクセスを制御する場合は、[アクセス] タブの [管理担当者] フィールドに、ツールへのアクセス権を付与する必要があるグループを追加します。

      グループ内のユーザーが実行できるタスクは、ユーザーにアサインされたロールによって異なります。

      ロール 説明
      DevOps ツールオーナーロール ツールを表示および編集できます。
      DevOps アプリオーナーロール ツールを表示し、履歴データの関連付け、検出、インポート、およびツールのオブジェクト (計画、リポジトリ、パイプラインなど) のパイプラインステップ (該当する場合) の変更を行うことができます。
      DevOps アドミニストレーターロール すべてのツールを編集できます。
      その他の DevOps ロール ツールを表示できます。
      注:
      [管理担当者] フィールドでは、DevOpsロールを持つユーザーを含むグループのみを選択できます。

      ツールへのアクセスを制限することを選択した場合、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ] オプションが選択可能になります。このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプラインステップの変更 (該当する場合) を行うことができます。

    2. [ 検出] を選択して、 Jiraから既存のすべてのプロジェクトを検出します。
      注:
      デフォルトでは、プロジェクトは Jira Cloud に対して 50 のセットで検出されます。50 は、 Jiraでサポートされているページネーションの上限です。この値を減らす場合は、DevOpsCommonConstants スクリプトでそれぞれの定数を編集する必要があります。
    3. [構成] を選択して Webhook を構成します。
      このアクションでは以下を行います。
      • Jira インスタンスと ServiceNow インスタンス間に Webhook を登録し、両者間のリアルタイムデータ転送を有効にします。
      • OAuth 2.0 ベースの認証を使用して Jira ツールを接続した場合、自動構成時に Jira の OAuth 2.0 統合アプリ用の Webhook が作成されますが、ベーシック認証を使用して接続した場合、Jira のすべてのプロジェクトに対して Webhook が作成されます。

      検出されたすべての Jira プロジェクトが計画としてリストされます。

      今すぐ構成しない場合は、 Enable Polling システムプロパティを [はい] に設定することで、後で夜間ポーリングを有効にして、追跡された計画のデータをフェッチできます。
      注:
      Webhook URL の自動構成を許可する Jira のアドミン権限がない場合は、 Jira アドミンに構成を依頼してください。このアクションでは、ツールインスタンスで Webhook URL を手動で作成して構成する必要があります。ツールで Webhook を構成したら、[ 手動構成モードに入る ] を選択して Jira に手動で接続し、手動構成モードを終了します。
    4. [ インポート] 関連リンクを選択して、 Jira プロジェクトから履歴データをインポートします。

      インポートされた作業アイテムは、対応する関連リストに追加されます。

      注:
      Jira でプロジェクトのプロジェクト キーが更新された場合、更新されたオブジェクト名は DevOps チェンジベロシティ に反映されません。オブジェクトが Jiraで更新された場合にのみ、新しい名前が DevOps チェンジベロシティに反映されます。