Jenkins スポーク

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間:5分
  • Jenkins サーバーでビルド、ユーザー、設定、ジョブを管理します。フローで使用する Jenkins データを取得します。

    ストアでアプリを要求する

    ServiceNow Store Web サイトにアクセスして利用可能なすべてのアプリを表示し、ストアにリクエストを送信する方法について確認してください。リリースされたすべてのアプリのリリースノート情報については、「ServiceNow Storeバージョン履歴のリリースノート」を参照してください。

    統合ハブサブスクリプション

    このスポークには Integration Hub のサブスクリプションが必要です。詳細については、「法務スケジュール - 統合ハブの概要」を参照てください。

    サポートされているバージョン

    1.651.1 〜 2.150.3 のすべてのバージョン

    スポークバージョン

    Jenkins スポークは v2.1.2 が最新バージョンです。

    スポークのアクション

    Jenkins スポークでは、ServiceNow インスタンスでイベントが発生したときに Jenkins タスクを自動化するアクションが提供されます。使用可能なアクションは次のとおりです。

    カテゴリ アクション 説明
    ビルド管理 ビルドを削除 Jenkins サーバージョブからビルドを削除します。
    すべてのビルドを取得 指定された Jenkins サーバージョブのすべてのビルドを取得します。各ビルドの URL、ビルド番号、およびクラスを返します。
    ビルド履歴を取得 指定されたジョブの一定範囲のビルド履歴を Jenkins サーバーから取得します。
    ビルド情報を取得 指定されたジョブのビルドタイムスタンプ、ビルドステータス、および完全なビルド情報を Jenkins サーバーから取得します。
    ビルド番号を取得 前回成功したビルドなど、事前定義済みのビルドフィルターに基づいて Jenkins サーバージョブのビルド番号を取得します。
    ビルドを実行 Jenkins サーバー上でジョブを実行します。
    構成管理 Jenkins 認証情報を作成 Jenkins サーバー認証情報を作成します。
    ノードを作成 Java Web Start ソフトウェアで起動できるノードを作成します。ノードは、Jenkins 環境の一部であり、ジョブを実行できるマシンです。
    ノードを削除 Jenkins サーバーからノードを削除します。
    CSRF トークンを取得

    Jenkins サーバーで [Prevent Cross Site Request Forgery exploits] オプションが有効になっている場合に、CSRF トークンを取得します。

    注:
    Jenkins サーバーで CSRF 保護が有効になっている場合は、このアクション フローの残りの部分で使用するためのトークンを取得します。アクションは、フローのその他のアクションで使用するためのデータピルとしてトークンを出力します。 を使用します。
    バージョンを取得 Jenkins サーバーのバージョンを取得します。
    Jenkins を再起動 Jenkins サーバーを再起動します。
    テスト接続 Jenkins サーバーへの接続をテストします。
    ジョブ管理 ジョブをコピー 既存の Jenkins サーバージョブをコピーすることでジョブを作成します。
    フォルダーを作成 ジョブを整理するための Jenkins サーバーフォルダーを作成します。
    ジョブを作成 XML ファイルから Jenkins サーバージョブを作成します。
    フォルダーを削除 既存の Jenkins サーバーフォルダーを削除します。
    ジョブを削除 Jenkins サーバージョブを削除します。
    フォルダーからすべてのジョブを取得 指定された Jenkins サーバーフォルダーからすべてのジョブを取得します。指定されたレベル数までの各ジョブのクラスと名前を返します。
    ビルドタイムスタンプを取得 指定された Jenkins サーバージョブのビルドタイムスタンプを取得します。
    コンソール出力を取得 Jenkins サーバージョブのビルドコンソール出力を取得します。
    ジョブ構成を取得 Jenkins サーバージョブの XML 構成を取得します。
    ジョブを再ロード Jenkins サーバージョブを再ロードします。
    ジョブの名前を変更 Jenkins サーバージョブの名前を変更します。
    ユーザー管理 ユーザーを作成 Jenkins サーバーのユーザーを作成します。
    ユーザーを削除 既存の Jenkins サーバーユーザーを削除します。
    ビュー管理 ジョブをビューに追加 Jenkins サーバービューにジョブを追加します。ビューは、ジョブを整理するためのコンテナです。Jenkins インスタンスが大きくなるにつれて、適切なグループとカテゴリのビューを作成できます。たとえば、ビルド固有のジョブのみを表示するビルドビューを作成できます。
    ビューを作成 Jenkins サーバービューを作成します。
    ビューを削除 Jenkins サーバービューを削除します。
    ビューからすべてのジョブを取得 Jenkins サーバービューからすべてのジョブを取得します。トップレベルのジョブのクラスと名前を返します。
    ビューからジョブを削除 Jenkins サーバービューからジョブを削除します。

    CRSF トークンのサポート

    Jenkins サーバーで [Prevent Cross Site Request Forgery exploits] オプションが有効になっている場合に、特定のアクションでは固有のトークンが必要になります。CSRF トークンを取得アクションを使用する フローの残りの部分で使用するためのトークンを取得します。アクションは、フローのその他のアクションで使用するためのデータピルとしてトークンを出力します。

    接続と資格情報の要件

    統合ハブ は、エイリアスを使用して、接続情報および認証情報、および OAuth 認証情報を管理します。エイリアスを使用することで、複数の環境を使用する場合に、複数の認証情報と接続情報プロファイルを構成する必要がなくなります。接続または認証情報が変更された場合、接続を使用するどのアクションも更新する必要はありません。

    このスポークでは、Jenkins 接続および資格情報エイリアスレコードを使用してアクションを許可します。スポーク接続エイリアスを使用するには、関連付けられた接続レコードと関連付けられた認証情報レコードを作成します。

    MID サーバー の要件

    これらのアクションでは REST 呼び出しを使用します。REST 呼び出しは MID サーバー で実行できます。Jenkins エイリアスに関連付けられた接続レコードを使用して、アクションを実行する場所およびMID サーバー選択属性を設定します。 詳細については「MID サーバー」を参照してください。

    スポークの設定については、以下を参照してください Jenkins Spoke を設定