インポートベースの証拠収集

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：4分

    • ステップレベルのパイプライン処理をスキップすることで、インスタンスのオーバーヘッドを削減し、 GitHub Actions、 Azure DevOps (ADO)、 Jenkins および GitLab オーケストレーションツールの変更管理と証拠収集を迅速化します。

    パイプライン内のすべての関連する証拠は、Webhook 通知の代わりにインポート要求を使用して変更要求に添付されます。

    インポートベースの証拠収集を有効にする

    この機能を有効にするには、[プロパティ] ページで [ オーケストレーション機能のインポートベースの証拠収集] ト グルをオンにします。詳細については、「DevOps 変更速度管理のプロパティ」を参照してください。

    トグルを切り替えると、パイプラインイベントの処理方法が変更されます。オンにすると、パイプラインのステップレベルの処理がスキップされるため、インスタンスのオーバーヘッドが削減されます。スキップされたステップレベルのイベントは無視され、「無視:[オーケストレーション機能のインポートベースの証拠収集] プロパティが有効になっているため、このイベントは無視されます」という処理の詳細が示されます。逆に、オフに切り替えると標準モードに戻り、すべての受信イベントが処理されます。
    注:
    この設定を変更する前に、パイプラインが実行されていないことを確認してください。アクティブなパイプラインの実行中に切り替えを切り替えると、パイプラインがハングアップして最終的にタイムアウトし、データ収集が不完全または不正確になる可能性があります。変更要求が既に作成されている場合は、必要な証拠が添付されていない可能性があるため、手動でキャンセルする必要があります。[ 保存] を選択して続行し、切り替えを切り替えてから新しいパイプライン実行を開始します。

    証拠はどのように収集されますか

    パイプラインの変更ステップがトリガーされると、ステータスが [作成済み] で、変更 証拠ステータスが [処理待ち] のコールバックレコードが作成されます。対応するインポート要求ページを含むインポート要求が作成され、パイプライン実行の詳細と必要な証拠が収集されます。変更要求が作成され、すべての証拠が添付されます。さらに、インポートベースの証拠収集機能がパイプライン完了イベントで再度トリガーされ、関連するすべての証拠が正確に取得され、変更要求に関連付けられます。変更要求の作成後、自動承認メカニズム、およびその後の動作は既存の動作と同じままです。

    ADO の場合
    • ビルドパイプラインの場合、このプロパティが有効になっている場合、証拠収集はパイプライン完了イベントにのみ基づいて行われます (インスタンスのオーバーヘッドを減らすためにステップレベルのイベントは処理されません)。
    • リリースパイプラインの場合、プロパティが有効になっている場合でも、証拠収集は処理ステップレベルのイベントに基づいて行われます。
    対象 GitHub Actions
    • このプロパティを有効にすると、証拠収集はワークフロー完了イベントにのみ基づいて行われます (インスタンスのオーバーヘッドを減らすためにステップレベルのイベントは処理されません)。
    • いずれかのステップで GitHub Actions 展開 ゲートを使用している場合は、GitHub アプリを構成する必要があり、証拠収集はワークフロー完了イベントに基づいて行われます。展開ゲートの詳細については、「 ServiceNow DevOps 変更の GitHub 展開ゲート」を参照してください。
    Jenkins
    このプロパティを有効にすると、証拠収集はパイプライン完了イベントにのみ基づいて行われます (インスタンスのオーバーヘッドを減らすためにステップレベルのイベントは処理されません)。
    注:
    Jenkins マーケットプレイスから最新のJenkinsをインストールする必要があります。Jenkins インスタンスで [Jenkins >システム構成の管理] > [プラグイン] に移動します。ServiceNow DevOpsプラグインを検索して選択し、[インストール] を選択します。
    GitLab
    このプロパティを有効にすると、証拠収集はパイプラインイベント Webhook イベントに基づいてのみ行われます (インスタンスのオーバーヘッドを削減するためにステップレベルのイベントは処理されません)。

    ポイント

    • インポートベースの証拠収集では、既存のすべてのパイプラインスタイル (再実行、並列、順次) と、 GitHub Actions、 Jenkins、ADO の構成がサポートされています。
    • このプロパティを有効にすると、ベースシステムの GitHub Actions、ADO、 GitLab、および Jenkins でサポートされているすべてのタイプの証拠収集もサポートされます。
    • GitHub Actions、環境ベースの変更はサポートされていません。
    • GitLab、手動ジョブ (when:manual) はサポートされていません。
      例を次に示します。 
       run_tests:
  script: npm test
  when: manual
  allow_failure: true
    • Jenkins、フリースタイルパイプラインはサポートされていません。
    • 履歴インポート機能とポーリング機能は、[ オーケストレーション機能のインポートベースの証拠収集] プロパティが有効かオフかに関係なく、同じように機能します。
    • インポート要求レコードでのインポートの再開もサポートされています。
    • トラブルシューティングとエラー処理のフレームワークは影響を受けません。
    • アップグレードする場合、[ オーケストレーション機能のインポートベースの証拠収集 ] プロパティはデフォルトでオフになっています。