Jenkins v2 スポーク
Jenkins サーバーでビルド、ユーザー、設定、ジョブを管理します。フローで使用する Jenkins データを取得します。
ストアでアプリを要求する
ServiceNow Storeにアクセスして、利用可能なすべてのアプリを表示し、ストアに要求を送信する方法を確認してください。リリースされたすべてのアプリのリリースメモ情報については、「ServiceNow Store バージョンの履歴リリースノート」を参照してください。
統合ハブサブスクリプション
このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。
スポークバージョン
Jenkins v2 スポーク v1.2.0 が最新バージョンです。
スポークの依存関係
アプリのインストールで問題が発生した場合は、次の依存プラグインがインストールされていることを確認してください。
- ServiceNow 統合ハブランタイム (com.glide.hub.integration.runtime)
- ServiceNow 統合ハブアクションステップ - REST (com.glide.hub.action_step.rest)
- ServiceNow 統合ハブアクションテンプレート - データストリーム (com.glide.hub.action_type.datastream)
スポークの要件
Jenkins v2 スポークv2 では API トークンを生成する必要があります。API トークンの詳細については、「セキュリティ強化：Jenkins 2.129+ での新しい API トークンシステム」を参照してください。
サポートされているバージョン
2.176.2 〜 2.222.1 のすべてのバージョン
スポークモジュール
ServiceNowインスタンスで Jenkins から更新を受信するようにJenkins v2 スポーク v2 を設定できます。ルーティングポリシーでは、ServiceNowインスタンスで更新を受信するために満たさなければならない条件が定義されています。条件が満たされると、ルーティングポリシーが関連するサブフローをトリガーし、Jenkins タスクを自動化します。これには別途セットアップが必要で、スポークアクションを使用しないで単独で使用できます。Webhook の設定と構成の詳細については、Jenkins スポークの Webhook を設定するを参照してください。ルーティングポリシーで他の条件を使用したり、デフォルトのサブフローをカスタマイズしたりするには、Webhook をカスタマイズを参照してください。
- キーワード
- ビルド番号
- ジョブ
- ジョブパス
- 関連フィールドを表示
デフォルトでは、Jenkins v2 アプリケーションがJenkins v2 スポークで利用可能で、次のモジュールがあります。
| モジュール | 説明 |
|---|---|
| Webhook 応答サブフロー | Jenkins からの要求を承認するための Webhook 認証キーの詳細です。 |
| Webhook クライアントの詳細 | Jenkins v2 スポークのサブフローの詳細です。 |
- Jenkins v2 Webhook 応答サブフロー [sn_jenkinsv2_spoke_webhook_answer_subflow]
- Jenkins Webhook クライアントの詳細 [sn_jenkinsv2_spoke_webhook_client_details]
スポークのサブフロー
| サブフロー | 説明 |
|---|---|
| Jenkins ジョブをビルド | ServiceNowインスタンスで Jenkins から更新を受信します。 |
| Jenkins Webhook 応答サブフロー：プロセスビルド情報 | Jenkins ジョブをビルドし、情報を取得します。このサブフローをカスタマイズするには、サブフローのコピーを作成し、要件に従ってサブフローを変更します。 |
| パラメーターを使用して Jenkins ジョブをビルド | 指定されたパラメーターで Jenkins ジョブをビルドし、情報を取得します。 |
スポークのアクション
Jenkins v2 スポークでは、ServiceNowでイベントが発生したとき、Jenkins タスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。
| カテゴリ | アクション | 説明 |
|---|---|---|
| ビルド管理 | ビルドを削除 | Jenkins サーバージョブからビルドを削除します。 |
| ビルド ID を取得 | 実行されたジョブのビルド ID を Jenkins サーバーから取得します。 | |
| ビルドタイムスタンプを取得 | 指定されたジョブのビルドタイムスタンプを Jenkins サーバーから取得します。 | |
| コンソール出力を取得 | 指定されたジョブのビルドコンソール出力を Jenkins サーバーから取得します。 | |
| ビルドをリスト | 指定されたジョブのすべてのビルドを Jenkins サーバーから取得します。 | |
| パラメーターを指定してビルドを実行 | Jenkins サーバー上で、パラメーターを指定してジョブを実行します。 | |
| ビルド履歴を取得 | 指定されたジョブの一定範囲のビルド履歴を Jenkins サーバーから取得します。 | |
| ビルド情報を取得 | 指定されたジョブのビルドタイムスタンプ、ビルドステータス、および完全なビルド情報を Jenkins サーバーから取得します。 | |
| ビルド番号を取得 | 前回成功したビルドなど、事前定義済みのビルドフィルターに基づいて Jenkins サーバージョブのビルド番号を取得します。 | |
| ビルドを実行 | Jenkins サーバー上でジョブを実行します。 | |
| 日付範囲でビルドを検索 | 指定されたジョブの日付範囲のすべてのビルドを Jenkins サーバーから取得します。 | |
| ビルドでコミットを検索 | 指定されたジョブの特定のビルドのコミットを Jenkins サーバーから取得します。 | |
| ビルドでステージノードを検索 | 特定のパイプラインジョブの特定のビルドのすべてのステージのソナーアクション、再起動可能なステージ、およびノードに関する情報を Jenkins サーバーから取得します。 | |
| ビルドでステージを検索 | 指定されたパイプラインジョブの特定のビルドのビルドステータス、開始時間、終了時間、期間、およびステージを Jenkins サーバーから取得します。 | |
| ビルドでテストレポートを検索 | テストサマリー、実行されたテストの合計数、合格したテスト、失敗したテスト、スキップされたテスト、および Jenkins サーバーから特定ジョブの特定ビルドで JUnit テストの実行にかかった時間に関する情報を取得します。 | |
| 構成管理 | ノードを作成 | Java Web Start ソフトウェアで起動できるノードを作成します。ノードは、Jenkins 環境の一部であり、ジョブを実行できるマシンです。 |
| ノードを削除 | Jenkins サーバーからノードを削除します。 | |
| バージョンを取得 | Jenkins サーバーのバージョンを取得します。 | |
| Jenkins を再起動 | Jenkins サーバーを再起動します。 | |
| 接続をテスト | Jenkins サーバーへの接続をテストします。 | |
| ジョブ管理 | ジョブをコピー | 既存の Jenkins サーバージョブをコピーすることでジョブを作成します。 |
| フォルダーを作成 | ジョブを整理するための Jenkins サーバーフォルダーを作成します。 | |
| ジョブを作成 | XML ファイルから Jenkins サーバージョブを作成します。 | |
| フォルダーを削除 | 既存の Jenkins サーバーフォルダーを削除します。 | |
| ジョブを削除 | Jenkins サーバージョブを削除します。 | |
| フォルダー別にジョブをリスト | 指定された Jenkins サーバーフォルダーからすべてのジョブを取得します。 | |
| ジョブ構成を取得 | Jenkins サーバージョブの XML 構成を取得します。 | |
| ジョブを再ロード | Jenkins サーバージョブを再ロードします。 | |
| ジョブの名前を変更 | Jenkins サーバージョブの名前を変更します。 | |
| ユーザー管理 | ユーザーを作成 | Jenkins サーバーのユーザーを作成します。 |
| ユーザーを削除 | 既存の Jenkins サーバーユーザーを削除します。 | |
| ビュー管理 | ジョブをビューに追加 | Jenkins サーバービューにジョブを追加します。ビューは、ジョブを整理するためのコンテナです。Jenkins インスタンスが大きくなるにつれて、適切なグループとカテゴリのビューを作成できます。たとえば、ビルド固有のジョブのみを表示するビルドビューを作成できます。 |
| ビューを作成 | Jenkins サーバービューを作成します。 | |
| ビューを削除 | Jenkins サーバービューを削除します。 | |
| ビュー別にジョブをリスト | Jenkins サーバーのビューからすべてのジョブを取得します。 | |
| ビューからジョブを削除 | Jenkins サーバービューからジョブを削除します。 |
スポークのトリガー
| カテゴリ | トリガー | 説明 |
|---|---|---|
| ビルド管理 | ビルドが中止されました | トリガーは、Jenkins ビルドが中止されると起動します。 |
| ビルド失敗 | トリガーは、Jenkins ビルドが失敗すると起動します。 | |
| 成功をビルド | Jenkins ビルドが成功すると、トリガーが起動します。 | |
| 不安定なビルド | トリガーは、Jenkins ビルドが不安定な場合に起動します。 | |
| ジョブ管理 | パイプラインが失敗しました | トリガーは、Jenkins パイプラインが失敗すると起動します。 |
接続と資格情報の要件
統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。
このスポークでは Jenkins v2 接続および資格情報エイリアスレコードを使用してアクションを許可します。スポーク接続エイリアスを使用するには、関連付けられた接続レコードと関連付けられた認証情報レコードを作成します。スポークの設定については、「 Jenkins スポークの設定。
MID サーバー の要件
これらのアクションでは REST 呼び出しを使用します。REST 呼び出しはMID サーバーで実行できます。Jenkins エイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所およびMID サーバー選択属性を設定します。 詳細については「MID サーバー」を参照してください。
このスポークの MID サーバー を設定するには、「 スポークの MID サーバー の設定」を参照してください。