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

DevOps 変更ワークスペースプレイブックを使用して Jenkins インスタンスに接続し、パイプラインを検出します。

始める前に

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

Jenkins 用の ServiceNow DevOps プラグインをインストールして有効にします。既にインストールされている場合は、最新バージョンに更新してください。手順については、「Jenkinsプラグインを構成」を参照してください。

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

手順

1. 次のように移動する。 ワークスペース > DevOps 変更ワークスペース をクリックし、次のいずれかのオプションを使用して、オンボーディングJenkinsへのプレイブックを開きます。
   セットアップを簡素化するために、そのアプリケーションでどの特定のパイプラインを関連付けて追跡する必要があるかもわかっている場合は、アプリケーションからツールを接続できます。これにより、 Jenkins からデータを簡単に関連付けてインポートすることもできます。

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

   重要:

   ツールへの接続中にパイプラインなどのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。
2. [ツール名] フィールドに、ツールの名前を入力します。

   

3. Jenkins インスタンスの詳細に関するプレイブックアクティビティ:
   1. Jenkins インスタンスの URL を入力します。
   2. Jenkinsインスタンスのログイン認証情報 (パスワードまたはアクセストークンまたは API トークン) を入力します。
      API トークンを生成するには、「 API トークン認証を使用した Jenkins への接続」を参照してください。
   3. Jenkins インスタンスが MID サーバーに接続されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。
      ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください。
4. [Connect (接続)] を選択します。

   

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

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

   

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

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

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

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

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

   

8. Jenkins の ServiceNow DevOps プラグインをインストールします。

   拡張の詳細については、「 Jenkinsプラグインを構成」を参照してください。

   

9. Jenkinsインスタンスに ServiceNow DevOps 構成を自動的に設定するには、[構成] を選択します。
   重要:

   • まず、Jenkins用の ServiceNow DevOps プラグインをインストールして有効にする必要があります。既にインストールされている場合は、最新バージョンに更新してください。手順については、「Jenkinsプラグインを構成」を参照してください。

   • Webhook を自動的に構成するには、 Jenkins アドミンアクセス権が必要です。
   • このツールを自動的に構成することを選択すると、Jenkins の ServiceNow DevOps 構成の既存の設定が上書きされます。
   • 合計 10 個の ServiceNow 構成を追加できます。

   

   図 : 1. での ServiceNow DevOps 構成の自動セットアップ Jenkins

   

   Jenkins で Webhook を手動で構成するには、「 Jenkins の Webhook を手動で構成」を参照してください。

   また、管理モジュールの [ポーリングを有効にする] プロパティオプションを選択することで、夜間のポーリングを有効にして追跡対象のパイプラインのデータを取得することもできます。「DevOps チェンジベロシティのプロパティ」を参照してください。

   重要:

   • ホームページまたはツールモジュールから接続している場合は、接続が完了し、[概要] ページが表示されます。
   • アプリケーションモジュールから接続している場合は、インスタンスで利用可能なパイプラインが検出されます。それらから履歴データを追跡してインポートできます。
10. [ パイプラインを選択 ] プレイブックアクティビティから追跡するパイプラインを選択します。
    選択したパイプラインごとに、最後の正常な実行のすべてのステップがインポートされます。

    

11. オプション: [パイプラインステップにサービスをアサイン] アクティビティで、各パイプラインステップの ステップタイプ と サービス を指定します。

    

    ツールのオンボーディングの一環としてこの手順を完了すると、 DevOps インサイト ダッシュボードに意味のあるデータがより多く即座に表示されます。

12. パイプラインデータをインポートする場合は、日付範囲を選択して [送信] を選択します。
13. [概要] ページで、[ツール レコードの表示] を選択して、接続されたJenkins ツールの詳細を確認します。

    

    注:

    ツールの認証情報が変更された場合は、 ServiceNow インスタンスで認証情報を更新する必要があります。詳細については、「でのサードパーティツールの認証情報の更新 DevOps チェンジベロシティ」を参照してください。

タスクの結果

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

関連タスク

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