DevOps 変更速度管理へのオンボードJira —ワークスペース

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

始める前に

DevOps 変更速度管理 の使用を開始するにはトピックで指定されたタスクを完了します。

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

手順

1. 移動先 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用してプレイブックを開き、 Jiraをオンボーディングします。

   オプション	ステップ
   ホームページ	[ツールを接続] を選択します。 [ツールに接続] モーダルで、[計画] カテゴリから「Jira」を選択します。
   アプリケーションモジュール	プライマリナビゲーションから [アプリケーション] () を選択します。 既存のアプリケーションを選択するか、新規作成します。アプリケーションを作成する場合は、アプリケーションを作成 - ワークスペース を参照します。 [推奨アクション] ペインから、[ツールを接続] カードを選択します。 [ツールに接続] モーダルで、[計画] カテゴリから「Jira」を選択します。
   ツールモジュール	プライマリナビゲーションから [ツール] () を選択します。 [機能] リストから [計画] を選択します。 [ツールを接続] を選択します。 [ツールに接続] モーダルで、「Jira」を選択します。

   重要:

   ツールへの接続中に計画などのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。
2. Jira Server または Jira クラウドインスタンスに接続します。

   Jira サーバー	[プラットフォーム] リストから「Jira Server」を選択します。 [ツール名] フィールドに、ツールの名前を入力します。 この名前は、DevOps 変更速度管理に接続されているツールのリストから Jira インスタンスを識別するために使用されます。
   Jira クラウド	[プラットフォーム] リストから「Jira Cloud」を選択します。 [ツール名] フィールドに、ツールの名前を入力します。 この名前は、DevOps 変更速度管理に接続されているツールのリストから Jira インスタンスを識別するために使用されます。

3. [次へ] を選択します。

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

4. プレイブックを使用して、 Jira ツールへの接続を完了します。
   1. 接続の詳細を入力します。

      Jira サーバー

      Jira サーバーインスタンスの URL を入力します。 [認証情報タイプ] リストから、 Jira サーバーへの接続に使用する認証タイプを選択します。 基本認証 Jira サーバーのユーザー名を入力します。 注: ここで使用する Jira ユーザーには、 Jira の管理者権限が必要です。 このインスタンスにアクセスするためのパスワードまたはアクセストークンを入力します。 API キー インスタンスにアクセスするための API トークンを入力します。 Jira インスタンスが MID サーバー に添付されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。 MID サーバーの詳細については、「MID サーバーの選択」を参照してください

      Jira クラウド

      Jiraクラウドインスタンスの URL を入力します。 注: 次のステップで認証情報タイプとして OAuth 2.0 with 3LO を選択する場合は、Jira インスタンスの URL を次の形式で入力する必要があります。 https://api.atlassian.com/ex/jira/<Cloud-ID> クラウド ID の値の取得については、「Obtain the value of Cloud ID」を参照してください。 認証情報タイプとして [基本認証] または [OAuth 2.0 with 3LO] を選択します。 基本認証 Jira Cloud のユーザー名を入力します。 注: ここで使用する Jira ユーザーには、 Jira の管理者権限が必要です。 このインスタンスにアクセスするためのパスワードまたはアクセストークンを入力します。 OAuth 2.0 (3LO 使用) 前提条件： Jira Cloud の認証情報レコードを作成します [認証情報] フィールドで既存の OAuth 2.0 認証情報レコードを選択するか、[OAuth 2.0 認証情報レコードの作成] を選択して新しいレコードを作成します。新しい認証情報レコードを作成する手順については、「 Jira Cloud の認証情報レコードを作成する」を参照してください。 注: 新しい OAuth 2.0 を作成するオプションは、接続 & OAuth admin ロールを持っている場合にのみ使用できます。 使用されておらず、Jira Cloud 用に構成されていないレコードのみを、既存の認証情報レコードとして選択できます。 Jira インスタンスが MID サーバー に添付されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。 MID サーバーの詳細については、「MID サーバーの選択」を参照してください

   2. [接続] を選択します。

      接続に成功すると、ツールが DevOps 変更速度管理 に作成され、 Jira インスタンスに接続されます。

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

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

      

   4. [次へ] を選択します。
5. ツールのアクセス権を指定します。
   1. ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
      グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。

      • DevOps ツールオーナーロール: ツールを表示および編集できます。
      • DevOps アプリオーナーロール: ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
      • DevOps 管理者ロール: すべてのツールを編集できます。
      • その他の DevOps ロール: ツールを表示できます。
      注:

      グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。
   2. ツールへのアクセスを制御することを選択した場合、 すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる オプションが選択可能になります。

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

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

      

6. DevOps と Jira インスタンス間でリアルタイムでデータを送信するには、 [構成] を選択します。
   このアクションでは以下を行います。

   • Jira インスタンスと ServiceNow インスタンスの間に Webhook を登録し、2 つのインスタンス間のリアルタイムデータ転送を有効にします。
   • OAuth 2.0 ベースの認証を使用して Jira ツールを接続した場合、自動構成時に Jira の OAuth 2.0 統合アプリ用に Webhook が作成されますが、ベーシック認証を使用して接続した場合、Webhook は Jira のすべてのプロジェクトに対して作成されます。OAuth 2.0 ベースの認証を使用して作成された Jira ツールに対して Webhook を手動で構成することを選択した場合、重複する Webhook が作成される可能性があります。

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

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

   

   手動で構成するには、[ 手動で構成] を選択します。詳細については、「Webhook をJira で手動で構成」を参照してください。

   重要:

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

   1. 更新を追跡し、アプリケーションに関連付けたいプランを選択します。

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

   2. [次へ] を選択します。

      

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

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

      

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

   

タスクの結果

Jira ツールが DevOps 変更速度管理 に正常にオンボーディングされました。

次のタスク

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

• ツールの詳細とステータスを表示します。
• 計画を検出して Webhook を構成します。
  注:

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

注:

Jira のプロジェクトのプロジェクトキーは更新しないことをお勧めします。プロジェクトキーが更新されると、更新されたオブジェクト名は DevOps 変更速度管理に反映されません。オブジェクトが Jiraで更新された場合にのみ、新しい名前が DevOps 変更速度管理に反映されます。

関連タスク

• ツールレコードから Webhook を構成