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

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

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

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

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

トグルを切り替えると、パイプラインイベントの処理方法が変更されます。オンにすると、パイプラインでのステップレベルの処理をスキップすることで、インスタンスのオーバーヘッドが削減されます。スキップされたステップレベルのイベントは、「無視:[オーケストレーション機能のインポートベースの証拠収集] プロパティが有効になっているため、このイベントは無視されます」という処理の詳細とともに無視されます。逆に、オフにすると標準モードに戻り、すべての受信イベントが処理されます。

注:

この設定を変更する前に、パイプラインが実行されていないことを確認してください。アクティブなパイプラインの実行中に切り替えを切り替えると、パイプラインがハングして最終的にタイムアウトし、データ収集が不完全または不正確になる可能性があります。変更要求が既に作成されている場合は、必要な証拠が添付されていない可能性があるため、手動でキャンセルする必要があります。[保存] を選択して続行し、切り替えた後に新しいパイプライン実行を開始します。

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

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

ADO の場合

• ビルドパイプラインの場合、プロパティが有効になっている場合、証拠収集はパイプライン完了イベントのみに基づいて行われます (インスタンスのオーバーヘッドを削減するためにステップレベルのイベントは処理されません)。
• リリースパイプラインの場合、プロパティが有効になっている場合でも、証拠収集はステップレベルのイベントの処理に基づいて行われます。

対象 GitHub Actions

• このプロパティを有効にすると、証拠収集はワークフロー完了イベントのみに基づいて行われます (インスタンスのオーバーヘッドを削減するためにステップレベルのイベントは処理されません)。
• いずれかのステップで GitHub Actions Deployment ゲートを使用している場合は、GitHub アプリを構成する必要があり、証拠収集はワークフロー完了イベントに基づいて行われます。展開ゲートの詳細については、「 ServiceNow DevOps 変更用の GitHub 展開ゲート」を参照してください。

ポイント

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