DevOps 変更速度管理へのオンボードJenkins —ワークスペース
DevOps 変更ワークスペースプレイブックを使用して Jenkins インスタンスに接続し、パイプラインを検出します。
始める前に
DevOps 変更速度管理 の使用を開始するにはトピックで指定されたタスクを完了します。
Jenkins 用の ServiceNow DevOps プラグインをインストールして有効にします。すでにインストールしている場合は、最新バージョンに更新してください。手順については、「Jenkinsプラグインの構成」を参照してください。
必要なロール: sn_devops.admin または sn_devops.tool_owner
手順
-
移動先 ワークスペース > DevOps 変更ワークスペース そして次のいずれかのオプションを使用して、Jenkinsをオンボーディングするプレイブックを開きます。
また、アプリケーションで関連付けと追跡を行うべき特定のパイプラインが分かっている場合、セットアップを簡素化するためにアプリケーションからツールを接続できます。 これにより、 Jenkins からデータを簡単に関連付けてインポートすることもできます。
オプション ステップ ホームページ - [ツールを接続] を選択します。
- [ツールに接続] モーダルで、適切なカテゴリからツールを選択します。たとえば、オーケストレーションツールとして Jenkins に接続する場合は、[オーケストレーション] カテゴリで [Jenkins] を選択します。
[アプリケーション] モジュール - プライマリナビゲーションから [アプリケーション] (
) を選択します。
- 既存のアプリケーションを選択するか、新規作成します。アプリケーションを作成する場合は、アプリケーションを作成 - ワークスペース を参照します。
- [推奨アクション] ペインから、[ツールを接続] カードを選択します。
- [ツールに接続] モーダルで、適切なカテゴリからツールを選択します。たとえば、オーケストレーションツールとして Jenkins に接続する場合は、[オーケストレーション] カテゴリで [Jenkins] を選択します。
[ツール] モジュール - プライマリナビゲーションから [ツール] (
を選択します。
- [機能] リストから適切なカテゴリを選択します。たとえば、オーケストレーションツールとして Jenkins に接続する場合は、[オーケストレーション] カテゴリを選択します。
- [ツールを接続] を選択します。
- [ツールに接続] モーダルで、[Jenkins] を選択します。
重要:ツールへの接続中にパイプラインなどのツールオブジェクトを検出して追跡する場合は、アプリケーションモジュールからツールを接続する必要があります。 -
[ツール名] フィールドに、ツールの名前を入力します。
-
Jenkins インスタンスの詳細に関するプレイブックアクティビティ:
- Jenkins インスタンスの URL を入力します。
-
Jenkins インスタンスのログイン認証情報 (パスワード、アクセストークン、または API トークン) を入力します。
API トークンを生成するには、API トークン認証を使用した Jenkins への接続 を参照してください。
-
Jenkins インスタンスが MID サーバーに接続されている場合は、[MID サーバー] オプションを選択し、その詳細を入力します。
ツールインスタンスがオンプレミスでホストされている場合は、MID サーバーが必要です。MID サーバーの詳細については、「MID サーバーの選択」を参照してください
-
[接続] を選択します。
-
入力した認証情報に対して権限チェックが実行されます。
必要な権限と利用可能な権限が表示されます。より適切なアクセス許可を持つ認証情報を入力する場合は、[認証情報を再入力] を選択します。必要なすべての権限の詳細については、「DevOps ツールに必要な権限 の Jenkins 権限」を参照してください。
必要なすべての権限がない場合でも、ツール接続を続行することを選択できます。
- [次へ] を選択します。
-
ツールのアクセス権を指定します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。グループ内のこれらのユーザーが実行できるタスクは、割り当てられたロールによって異なります。
- DevOps ツールオーナーロール: ツールを表示および編集できます。
- DevOps アプリオーナーロール: ツールを表示し、ツールのオブジェクト (プラン、リポジトリ、パイプラインなど) の関連付け、検出、履歴データのインポート、パイプラインステップの変更 (該当する場合) を実行できます。
- DevOps 管理者ロール: すべてのツールを編集できます。
- その他の DevOps ロール: ツールを表示できます。
注:グループを選択せずにこの手順をスキップすると、 DevOps ツールオーナーロールを持つすべてのユーザーがツールを編集できます。 - ツールへのアクセスを制御することを選択した場合、 すべてのアプリ所有者がツールオブジェクトを表示してアプリケーションに関連付けることができる オプションが選択可能になります。
このオプションを使用すると、 DevOps アプリオーナーロールを持つすべてのユーザーがツールにアクセスできます。選択すると、ツールのオブジェクトの表示、関連付け、検出、履歴データのインポート、およびパイプラインステップの変更 (該当する場合) が可能になります。
- [アサイン] を選択します。
- ツールへのアクセスを制御する場合は、ツールへのアクセス権を付与する必要があるグループを [保守担当者 ] フィールドに追加します。
-
Jenkins の ServiceNow DevOps プラグインをインストールします。
拡張の詳細については、「Jenkinsプラグインの構成」を参照してください。
-
[構成] を選択すると、Jenkinsインスタンスに ServiceNow DevOps 構成が自動的にセットアップされます。
重要:
-
まず、Jenkins用の ServiceNow DevOps プラグインをインストールして有効にする必要があります。既にインストールされている場合は、最新バージョンに更新してください。手順については、「Jenkinsプラグインの構成」を参照してください。
- Webhook を自動的に構成するには、 Jenkins アドミンアクセス権が必要です。
- このツールを自動的に構成することを選択すると、Jenkins の ServiceNow DevOps 構成の既存の設定が上書きされます。
- 合計 10 個の ServiceNow 構成を追加できます。
図 : 1. Jenkins での ServiceNow DevOps 構成の自動セットアップ Jenkins で Webhook を手動で構成するには、「Jenkins を手動で構成」を参照してください。
また、管理モジュールの [ポーリングを有効にする] プロパティオプションを選択することで、夜間ポーリングを有効にして追跡対象のパイプラインのデータを取得することもできます。「DevOps 変更速度管理のプロパティ」を参照してください。
重要:- ホームページまたはツールモジュールから接続している場合は、接続が完了し、[サマリー] ページに移動します。
- アプリケーションモジュールから接続している場合は、インスタンスで利用可能なパイプラインが検出されます。それらから履歴データを追跡してインポートできます。
-
-
[パイプラインを選択] プレイブックアクティビティから追跡するパイプラインを選択します。
選択したパイプラインごとに、最後の正常な実行のすべてのステップがインポートされます。
- オプション:
[パイプラインステップにサービスをアサイン] アクティビティで、各パイプラインステップのステップタイプとサービスを指定します。
このステップをツールオンボーディングの一環として完了すると、 DevOps インサイト ダッシュボードに意味のあるデータがより多く即座に表示されるようになります。
- パイプラインデータをインポートする場合は、日付範囲を選択して [送信] を選択します。
-
[サマリー] ページで、[ツールレコードを表示] を選択して、接続された Jenkins ツールの詳細を確認します。
注:ツール認証情報が変更されている場合は、 ServiceNow インスタンスで認証情報を更新する必要があります。詳細については、「DevOps 変更速度管理でのサードパーティツール認証情報の更新」を参照してください。
タスクの結果
Jenkins ツールが DevOps 変更速度管理 に正常にオンボーディングされました。