DevOps チェンジベロシティへのオンボードJira —ワークスペース

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：7分

    • DevOps 変更ワークスペースから Jira Server または Jira クラウドインスタンスに接続して利用可能なプランを検出し、Webhook を登録してプロジェクト、ストーリー、機能、エピックを追跡します。

    始める前に

    DevOps チェンジベロシティの開始トピックで指定されたタスクを完了します。

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

    手順

    1. 移動先 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用してプレイブックを開き、 Jiraオンボーディングします。
      オプションステップ
      ホームページ
      1. [ ツールを接続] を選択します。
      2. [ツールに接続] モーダルで、[計画] カテゴリから [Jira] を選択します。
      アプリケーションモジュール
      1. プライマリナビゲーションから [アプリケーション ] (アプリケーションアイコン) を選択します。
      2. 既存のアプリケーションを選択するか、アプリケーションを作成します。アプリケーションを作成するには、「 app-create-workspace.html」を参照してください。
      3. [推奨アクション] ペインから、[ ツールの接続 ] カードを選択します。
      4. [ツールに接続] モーダルで、[計画] カテゴリから [Jira] を選択します。
      ツールモジュール
      1. プライマリナビゲーションから [ツール ] ([ツール] アイコン) を選択します。
      2. [機能] リストから [ 計画] を選択します。
      3. [ ツールを接続] を選択します。
      4. [ツールに接続] モーダルで、[ Jira] を選択します。
      重要:
      ツールへの接続中に計画などのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。
    2. Jira Server または Jira クラウドインスタンスに接続します。
      Jira サーバー
      1. [プラットフォーム] リストから [Jira Server] を選択します。
      2. [ツール名] フィールドに、ツールの名前を入力します。

        この名前は、DevOps チェンジベロシティに接続されているツールのリストから Jira インスタンスを識別するために使用されます。

      Jira サーバーに接続します。
      Jira クラウド
      1. [プラットフォーム] リストから [Jira クラウド] を選択します。
      2. [ツール名] フィールドに、ツールの名前を入力します。

        この名前は、DevOps チェンジベロシティに接続されているツールのリストから Jira インスタンスを識別するために使用されます。

      Jira クラウドに接続します。
    3. [Next (次へ)] をクリックします。

      オンボーディングタスクの完了に役立つ [ DevOps プレイブック] ページが開きます。

    4. プレイブックを使用して、 Jira ツールへの接続を完了します。
      1. 接続の詳細を入力します。
        Jira サーバー
        1. Jira サーバーインスタンスの URL を入力します。
        2. [ 認証情報タイプ ] リストから、 Jira サーバーへの接続に使用する認証タイプを選択します。

          • ベーシック認証

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

            Jira サーバーの基本認証の詳細を入力します。

          • API キー

            インスタンスにアクセスするための API トークンを入力します。

            Jira サーバー API トークンを入力します。

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

          MID サーバーの詳細については、「MID サーバーの選択」を参照してください。
        Jira クラウド
        1. Jira クラウドインスタンスの URL を入力します。
        2. Jira Cloud のユーザー名を入力します。
          注:
          ここで使用する Jira ユーザーには、 Jira 管理者権限が必要です。
        3. このインスタンスにアクセスするためのパスワードまたはアクセストークンを入力します。
        4. JiraインスタンスがMID サーバーに接続されている場合は、[MID サーバー] オプションを選択して、その詳細を入力します。

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

        Jira Cloud インスタンスの詳細を入力します。
      2. [接続] を選択します。

        接続に成功すると、ツールが DevOps チェンジベロシティ に作成され、 Jira インスタンスに接続されます。

      3. 入力した認証情報に対して権限チェックが実行されます。
        必要な権限と利用可能な権限が表示されます。より適切なアクセス許可を持つ資格情報を入力する場合は、 [ 資格情報の再入力] を選択します。必要なすべての権限の詳細については、「 DevOpsツールに必要な権限 の Jira 権限」を参照してください。

        必要なすべての権限がない場合でも、ツール接続を続行することを選択できます。

        Jira に接続するための権限チェック。

    5. ツールのアクセス権を指定します。
      1. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
        グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。
        • DevOps ツールオーナーロール:ツールを表示および編集できます。
        • DevOps アプリオーナーロール:ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
        • DevOps 管理者ロール:すべてのツールを編集できます。
        • その他の DevOps ロール:ツールを表示できます。
        注:
        グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。
      2. ツールへのアクセスを制御することを選択した場合は、[ すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる ]オプションを選択できるようになります。

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

      3. [アサイン] を選択します。

        ツールアクセスを指定します。

    6. DevOps と Jira インスタンス間でリアルタイムでデータを送信するには、 [構成] を選択します。
      このアクションでは以下を行います。
      • Jira インスタンスと ServiceNow インスタンスの間に Webhook を登録し、2 つのインスタンス間のリアルタイムデータ転送を有効にします。
      • Jiraインスタンスから利用可能なすべてのプロジェクトを検出します。

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

      今すぐ構成しない場合は、 Enable Polling システムプロパティを [はい] に設定することで、後で夜間ポーリングを有効にして追跡対象計画のデータをフェッチできます。

      Jira インスタンスを構成します。

      手動で構成するには、 [ 手動構成] を選択します。詳細については、「config-webhooks-jira-manually.html」を参照してください。

      重要:
      • ホームページまたはツールモジュールから接続している場合は、接続が完了し、[概要] ページに移動します。
      • アプリケーションモジュールから接続している場合は、Jira インスタンスで利用可能なプランが検出されます。それらから履歴データを追跡してインポートできます。
    7. 追跡する計画を選択します。

      1. 更新を追跡してアプリケーションに関連付ける計画を選択します。

        ツールのオンボーディングが完了すると、選択したこれらの計画の作業アイテムのみが自動的にインポートされます。

      2. [Next (次へ)] をクリックします。

        追跡する Jira のプランを選択します。

      3. 計画データをインポートする場合は、日付範囲を選択して [送信] を選択します。

        最大 90 日分のデータをインポートできます。

        計画データをインポートします。

    8. [ サマリー] ページで [ ツールレコードを表示 ] を選択して、接続されたインスタンスとそこから検出されたプランの詳細を確認します。

      接続の概要。

    タスクの結果

    Jira ツールが正常にオンボーディングされてDevOps チェンジベロシティされました。

    次のタスク

    ツールレコードページから、次のことができます。

    • ツールの詳細とステータスを確認します。
    • 計画を検出し、Webhook を構成します。
      注:
      • デフォルトでは、プロジェクトは Jira Cloud に対して 50 のセットで検出されます。50 は、 Jira でサポートされているページネーションの上限です。この値を減らす場合は、DevOpsCommonConstants スクリプトでそれぞれの定数を編集する必要があります。
      • 検出されたプロジェクトとバージョンのデータは、リアルタイムでは更新も追跡もされません。
    • [ 管理担当者 ] フィールドを使用してツールへのアクセスを制御するグループをアサインします。
    • 認証情報の権限を確認し、ツールの認証情報を更新します。詳細については、「ツールの権限確認と認証情報の更新 - ワークスペース」を参照してください。
    • [ 計画] タブで計画を選択して、インポートされた作業アイテム、機能などの詳細を表示します。
    • 計画から履歴データをインポートするには、計画をアプリケーションに関連付け、データをインポートします。詳細については、「ツールオブジェクトをアプリケーションに関連付ける:ワークスペース」を参照してください。
    注:
    Jira のプロジェクトのプロジェクトキーは更新しないことをお勧めします。プロジェクトキーが更新されると、更新されたオブジェクト名は DevOps チェンジベロシティに反映されません。オブジェクトが Jiraで更新された場合にのみ、新しい名前が DevOps チェンジベロシティに反映されます。