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

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

始める前に

DevOps 変更速度の開始トピックで指定されたタスクを完了します。

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

手順

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

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

   重要:

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

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

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

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

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

      Jira サーバー

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

      Jira クラウド

      Jiraクラウドインスタンスの URL を入力します。 注: 次のステップで認証情報タイプを OAuth 2.0 と 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 使用) 前提条件： Create an OAuth 2.0 integration in Jira account Create an application registry in ServiceNow instance Jira Cloud の認証情報レコードの作成 [ 認証情報 ] フィールドで既存の OAuth 2.0 認証情報レコードを選択するか、[ OAuth 2.0 認証情報レコードの作成 ] を選択して新しいレコードを作成します。新しい認証情報レコードを作成する手順については、「 Jira Cloud の認証情報レコードを作成する」を参照してください。 注: 新しい OAuth 2.0 を作成するオプションは、接続および OAuth admin ロールを持っている場合にのみ使用できます。 使用されておらず、Jira Cloud 用に構成されていないレコードのみを、既存の認証情報レコードとして選択できます。 Jira インスタンスがMID サーバーに添付されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。 MID サーバーの詳細については、「MID サーバーの選択」を参照してください。

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

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

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

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

      

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

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

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

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

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

      

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

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

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

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

   

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

   重要:

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

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

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

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

      

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

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

      

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

   

タスクの結果

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

次のタスク

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

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

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

注:

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

関連タスク

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