DevOps 変更速度管理のプロパティ
これらのプロパティを使用して、DevOps 変更速度管理アプリケーションの設定を構成します。
必要なロール: sn_devops.admin
DevOps 変更ワークスペースからプロパティを表示するには、次に移動します .
クラシック UI からプロパティを表示するには、 .
| プロパティ | 説明 | デフォルト | 名前 |
|---|---|---|---|
| 最大再試行回数 (エラーのある受信イベントの場合) | 最大再試行回数 (エラーのある受信イベントの場合)。 | 3 | [sn_devops.max_retry_count_inbound_event] |
| ツール機能 | サポートされているツール機能で、カンマ区切り値として入力されます。 | コード、計画、オーケストレーション、アーティファクト、テスト | [sn_devops.tool_capabilities] |
| DevOps 変更要求の承認テキスト | 変更管理のカスタマイズに使用する DevOps 変更要求の承認テキスト。 | 承認済み | [sn_devops.change_request.approved_approval] |
| DevOps 変更要求:変更の作成時に属性を適用 |
有効にすると、変更が作成されたときに変更属性が適用されます。変更属性に適用されるデータポリシーがある場合は、変更の作成時に適用されます。このプロパティが有効になっていない場合、変更属性は変更の作成後に適用され、変更属性にデータポリシーが存在すると、変更の作成が失敗する可能性があります。 |
False (無効) | [sn_devops.change_request.apply_attributes_on_creation] |
| DevOps システムヘルスレポートの期間 (日) | デフォルトは過去 7 日間で、受信イベントなどのシステム健全性メトリクスを表示します。 | 7 | [sn_devops.health_duration_report] |
| パイプラインの実行時にリポジトリとアプリを自動的に関連付けられるようにします | 有効にすると、リポジトリがアプリに自動的に関連付けられ、まだ関連付けられていないリポジトリのコミットがパイプラインによって識別されたときに追跡できるようになります。また、リポジトリが既にアプリに割り当てられている場合、対応するアプリにまだ関連付けられていないパイプラインも関連付けます。 | はい (有効) | [sn_devops.enable_automatic_associations] |
| インポート要求で一度に処理する最大ページ数 | インポート要求で一度に処理する必要のある最大ページ数。 | 10 | [sn_devops.import.max.pages.processing.per_import] |
| DevOps 変更要求の再利用可能性決定サブフロー | 新しい変更を作成する代わりに、以前に作成した変更を再利用できるかどうかを確認するために呼び出すことができるサブフロー。 | sn_devops.change_request_reusability_subflow | [sn_devops.change_request_reusability_decision] |
| GitHub URL | GitHub では、このフィールドは API URL を取得するために使用されます (REST 呼び出しの場合)。 | https://github.com | [sn_devops.github.url] |
| DevOps 変更要求のキャンセルステータス | DevOps 変更管理のカスタマイズに使用される変更要求のキャンセル状況。 |
4 (キャンセル) |
[sn_devops.change_request.cancel_state] |
| インポート時のオーケストレーションツールの最大実行回数 | Jenkins フリースタイルジョブのインポート時のオーケストレーションツールの最大実行回数。 | 1000 | [sn_devops.import.orchestration_tool.executions.maximum] |
| インポート要求ページレコードの添付ファイルとしてペイロードを保存するには、[値] フィールドを true に設定します。それ以外はすべて false と見なされます。 | true の場合、フェッチされた JSON ペイロードは [インポート要求] ページに添付ファイルとして保存されます。 インポート要求ページレコードの添付ファイルとしてペイロードを保存するには、[値] フィールドを true に設定します。それ以外はすべて false と見なされます。 |
False (無効) | [sn_devops.import.save.payloads.as.attachments] |
| DevOps アドミンのソフトウェア品質サマリーフラグ | アドミン以外の SonarQube ユーザーとして、GitHub Actions、Jenkins、または Azure DevOps パイプラインで構成された SonarQube スキャンを表示および監視できるようにします。 | False (無効) | [sn_devops.non_admin_software_quality_summary_flag] |
| デフォルトのテストタイプ | オーケストレーションパイプラインからのデフォルトのテストタイプ。 | JUnit |
[sn_devops.default_test_type] |
| ページあたりのコーディングツール分岐 | ページあたりのコーディングツール分岐の数。 | 19 |
[sn_devops.import.coding_tool.branches.per_page] |
| ページあたりの計画ツールの問題 | ページごとに表示された計画立案ツールの問題の数。 | 100 | [sn_devops.import.planning_tool.issues.per_page] |
| アクティブな DevOps ユーザーに自動的に追加される sn_devops ロール | 値フィールドに入力された sn_devops ロールは、 アクティブな DevOps ユーザーに自動的に追加されます (例:コミットの実行など)。 sn_devops スコープにないロールが指定されている場合、そのロールは追加されません。 ロールを自動的に指定しない場合は、空のままにします。 |
sn_devops.viewer | [sn_devops.discovered.user.auto.assign.role] |
| パイプライン UI ビューにデフォルトで表示されるソフトウェア品質カテゴリ | パイプライン UI ビューにデフォルトで表示されるソフトウェア品質カテゴリで、カンマ区切り値として入力します。 | カバレッジ、lines_of_code、バグ、code_smells、重複、脆弱性 | [sn_devops.sq_ui_category_preferences] |
| エラーのある受信イベントが再試行に設定されているエラーまたは例外 (カンマ区切り) | エラーのある受信イベントが [再試行] に設定されているエラーまたは例外。カンマ区切り値として入力します。 | TimeOutException,FlowObjectAPIException | [sn_devops.inbound_events_retry_error_list] |
| DevOps のログレベル | DevOps ログレベル。 次の中から適切なレベルを選択します。
|
警告 | sn_devops.devops_log_level |
| [DevOps 変更] フィールドで DevOps 変更要求を分類します | 。 [カテゴリ] フィールドが DevOps 変更として DevOps に設定された変更要求を分類するには、このオプションを選択します。 無効にするにはオフにします。 |
False (無効) | [sn_devops.custom_change_categorization] |
| ページあたりのオーケストレーションツール実行回数 | ページあたりのオーケストレーションツール実行回数。 | 50 | [sn_devops.import.orchestration_tool.executions.per_page] |
| インポートポーリングを有効化 | インポート要求のポーリングを有効にするオプション。ポーリングを無効にするにはオフにします。 | False (無効) | [sn_devops.enable_import_polling] |
| GitHub API のバージョンパス | GitHub API バージョンパス。 | /api/v3 | [sn_devops.github.api_version_path] |
| レコードあたりのツール権限確認タイムアウト (ミリ秒) |
ツール接続プロセス中、システムはフォアグラウンドで権限の検証を実行し、ツール接続ページを制限します。権限の検証ごとに、権限の可用性を評価するために外部ツールに対して REST API 呼び出しが行われます。REST API の応答時間は、ネットワーク設定によって異なる場合があります。遅延を避けるために、このプロパティを使用して権限をエラーとしてマークする前に、システムが外部ツールからの応答を取得するのを待機する時間を指定できます。 |
10000 | [sn_devops.permission_check_timeout] |
| DevOps 変更要求の再利用可能性モデルサブフロー | DevOps 変更要求の再利用可能性モデルサブフロー。 | sn_devops.devops_reused_model_change_request | [sn_devops.devops_reused_model_change_request] |
| 経過時間 (分) | 経過時間 (分)。再試行ジョブは、指定された時間/値からエラーのある受信イベントをチェックします。 | 1440 (7 日) | [sn_devops.inbound_events_error_retry_mins_ago] |
| パイプラインで関連付けられたステージが失敗した場合、またはキャンセルされた場合に、変更要求をキャンセルします |
このプロパティが有効になっていて、 DevOps パイプラインの特定のステップにマッピングされたオーケストレーションタスクが失敗またはキャンセルされると、そのステップに関連付けられている変更要求もキャンセルされます。変更要求をキャンセルできるのは、その要求がまだ却下されていないか、キャンセル時に [実装] または [レビュー] 状況でない場合のみです。 |
False (無効) | [sn_devops.cancel_change_on_pipeline_cancel] |
| カスケード削除しきい値 (推奨フォアグラウンド制限 1000) | カスケード削除しきい値。 | 1000 | [sn_devops.cascade_delete_threshold] |
| インポート時のページあたりの最大再試行回数 | ツールからデータをインポートする際のページあたりの最大再試行回数。 | 3 | [sn_devops.import.max.retries.per_page] |
| DevOps 変更要求の実装後ステータス | DevOps 変更管理のカスタマイズに使用される実装後の変更要求状況。 |
0 (レビュー) |
[sn_devops.change_request.post_implement_state] |
| DevOps 変更要求の実装ステータス | DevOps 変更管理のカスタマイズに使用される変更要求実装状況。 | -1 (実装) | [sn_devops.change_request.implement_state] |
| デフォルトのコミット担当者スコア | デフォルトのコミット担当者スコア。 | 50 | [sn_devops.committer.score.default] |
| GitLab プル (マージ) 要求の追跡を有効にします。有効になっていない場合、プル (マージ) 要求と関連するイベントは無視されます。 | このプロパティを有効にすると、GitLab プル (マージ) 要求が DevOps 変更速度管理で追跡されます。無効にすると、すべてのマージ要求イベントが無視されます。 | はい (有効) | sn_devops.track.gitlab.pullrequests |
| 現在時刻からのデフォルトのスロットルリセット時間 (分単位) | ツールがスロットルリセット時間をサポートしていない場合、スロットルリセット時間は、現在の時間にこのプロパティに指定された値を加えたものと見なされます。 | 15 分 | [sn_devops.throttle.reset.time.default] |
| Azure DevOpsコードプル要求の追跡を有効にします。これを有効にすると、ツールまたはプロジェクトの構成時に Azure プル要求 Web フックが自動的に構成されます。 | このプロパティを有効にすると、ツールまたはプロジェクトが構成されるたびに、Azure DevOps プル要求 Web フックが自動的に構成されます。 | はい (有効) | sn_devops.track.azure.pullrequests |
| コミット担当者スコアの乗算係数 | コミット担当者スコアに使用される乗算係数。 | 1 | [sn_devops.committer.score.multiply.factor] |
| 自動アーカイブ (月単位) | テーブルデータを自動アーカイブするまでの期間。 | 9 | [sn_devops.table_auto_archive_duration] |
| 廃止:デバッグフラグを有効化 (新しいプロパティ「DevOps のログレベル」を使用) |
DevOps デバッグロガー。
注: このプロパティは廃止されました。代わりに sn_devops.devops_log_level (DevOps ログレベル) プロパティを使用してください。 |
はい (有効) | [sn_devops.enable_debug] |
| インポート時のページあたりの最大処理時間 (秒) | ツールからデータをインポートする際にページごとに許容される最大処理時間 (秒)。 | 300 | [sn_devops.import.max.processing.time.seconds.per_page] |
| サポートされている Webhook 機能 | DevOps 変更速度管理 によってサポートされている Webhook 機能。 | コード、計画、オーケストレーション、アーティファクト、テスト | [sn_devops.supported_webhook_capabilities] |
| DevOps 変更要求のクローズ済みステータス | 変更管理のカスタマイズに使用される DevOps 変更要求のクローズ済み状況。 | 3 | [sn_devops.change_request.closed_state] |
| 一括フローのタイムアウト (ミリ秒) | 一括フローのタイムアウト (ミリ秒)。 | 60000 | [sn_devops.bulk_flow_timeout] |
| ページあたりの GitHub/Bitbucket コーディングツールコミット | GitHub および Bitbucket のページあたりのコーディングツールコミット数。 | 100 | [sn_devops.import.coding_tool.commits.per_page] |
| フォルダーの深さ |
フォルダー内のネストレベルがここで指定された数値以下のフォルダー内にあるオーケストレーションタスクとパイプラインのみを取得します。フォルダーの深さは、 Jenkins 内のフォルダーに対して行われるネストレベルであり、検出したいオーケストレーションタスクとパイプラインが含まれています。たとえば、Jenkins 環境で 2 回ネストされたフォルダー構造のオーケストレーションタスクとパイプラインを検出する場合は、このプロパティの値として 2 を入力する必要があります。 |
3 | [sn_devops.discover.jenkins.folder.depth] |
| DevOps 変更要求ハンドラーサブフロー | フローデザイナーのデフォルトの変更ハンドラーサブフロー (変更要求フィールドにデフォルト値を入力するために使用される) の代わりにカスタムサブフローを使用している場合は、このプロパティ値を新しいサブフローに更新する必要があります。フローデザイナーでデフォルトの変更ハンドラーサブフローをコピーし、組織のニーズに応じて更新できます。デフォルトの変更ハンドラーサブフローの詳細については、「DevOps フローのカスタマイズ」を参照してください。 サブフローのコピーについては、「Copy a subflow」を参照してください。 |
sn_devops.default_change_handler_subflow | [sn_devops.change_request_handler_subflow] |
| ページあたりのコーディングツールリポジトリ |
ツールに接続した後にリポジトリをインポートするときに、ページごとに表示する必要があるリポジトリの数。インポートされるリポジトリの合計数はこのプロパティに依存しませんが、インポートされたリポジトリの合計数のうち、ページごとに表示する必要があるリポジトリの数は、このプロパティを使用して指定できます。たとえば、ツールに 1000 個のリポジトリが含まれていて、プロパティ値として 100 を指定すると、1000 個のリポジトリがインポートされ、そのうち 100 個が [インポート要求] ページのページごとに表示されます。 リポジトリを検出すると、バックエンドでの API 呼び出しごとに取得する必要があるリポジトリの数も、このプロパティ値によって異なります。リポジトリの数が多い場合は、このプロパティの値を比較的小さく設定すると、呼び出しごとに取得されるリポジトリの数が少なくなり、システムがタイムアウトしなくなります。 |
100 | [sn_devops.import.coding_tool.repos.per_page] |
| GitHub API URL | GitHub API URL。 | https://api.github.com | [sn_devops.github.api_url] |
| ITBM Agile 計画ツールの問題インポートの最大制限 | 戦略的ポートフォリオ管理 (SPM) (SPM) Agile 計画立案ツールの問題インポートの最大制限。 | 1000 | [sn_devops.import.planning_tool.itbm.issues.max.limit] |
| ユニバーサルタスクを割り当て、有効期限が切れた時にツール認証情報を更新するよう通知します |
認証情報の有効期限が切れると、アドミンとツールオーナーに (ユニバーサルタスク、メール、バナー、フィールドメッセージを通じて) 通知されます。アドミンまたはツール所有者は、ツール認証情報を更新し、ツールに接続して、これ以上のデータ損失を防ぐことができます。ツール認証情報の更新については、「DevOps 変更速度管理でのサードパーティツール認証情報の更新」を参照してください。 |
はい (有効) | [sn_devops.credential_expiration.notify_on_expiration] |
| ユニバーサルタスクを割り当てて通知するためのツール認証情報の有効期限までの日数 (該当する場合) |
ベーシック認証で作成された GitHub ツールのアドミンに通知を (ユニバーサルタスク、メール、バナー、およびフィールドメッセージを介して) 送信するツール認証情報の有効期限までの日数を設定します。プロアクティブ通知の送信を停止するには、このプロパティの値として 0 を選択します。ツール認証情報の更新については、「DevOps 変更速度管理でのサードパーティツール認証情報の更新」を参照してください。 |
3 | [sn_devops.credential_expiration.notify_before_days] |
| イベントが受信されなかったときに警告アラートを表示する日数 |
イベントが受信されなかったときに、ツールレコードの [受信した最後のイベント] フィールドに警告アラートを表示する日数を設定します。これは、ServiceNow にデータを送信するツールにのみ適用されます。ツールレコードヘッダーとツールレコード内の [受信した最後のイベント] フィールドは、イベントが受信されていなかった場合の警告アラートとして黄色で強調表示されます。 |
2 | [sn_devops.last_event_received.warning] |
| イベントが受信されなかったときに重大なアラートを表示する日数 |
イベントが受信されなかったときに、ツールレコードの [受信した最後のイベント] フィールドに重大なアラートを表示する日数を設定します。これは、ServiceNow にデータを送信するツールにのみ適用されます。ツールレコードヘッダーの [受信した最後のイベント] フィールドとツールレコード内のフィールドは、イベントが受信されていなかった場合、重大なアラートに対して赤で強調表示されます。 |
7 | [sn_devops.last_event_received.critical] |
| 前回成功したパイプラインビルドから Azure DevOps コミット実行を判断する必要があるかどうかを有効にします |
有効にすると、DevOps 変更は [コミットを実行] の一部として、Azure DevOps から最後に成功したパイプラインビルド後に作成された最後のコミットを最大 2000 まで取得します。 無効にすると、直近の 200 件のコミットのみがコミットの実行と見なされます。 |
いいえ | [sn_devops.enable_ado_bulk_run_commits] |
| 前回成功したワークフロー実行から GitHub コミット実行を判断する必要があるかどうかを有効にします |
有効にすると、 DevOps 変更 は [コミットを実行] の一部として、 GitHub で最後に成功したワークフロー実行後の最初の 2000 件のコミットを取得します。
注: スキップされたコミットは考慮されません。 無効にすると、最後のコミットのみが [コミットを実行] で取得されます。 |
いいえ | [sn_devops.enable_github_run_commits] |
| このプロパティは、Azure DevOps の構成操作で汎用接続を作成するかどうかを決定します | このプロパティが有効になっている場合は、Webhook を構成するために連携ユーザー名とパスワードを入力する手順が必要です。 | いいえ | [sn_devops.enable_ado_generic_connection] |
| Azure DevOps プロジェクトで検出できるパイプラインの最大数 | ADO プロジェクトのインポート要求で検出できるパイプラインの最大数を設定します。プロジェクトに 15,000 を超えるパイプラインがある場合は、このプロパティ値をその数に設定して、パイプラインが検出されるかどうかを確認できます。そうでない場合は、値を小さい数値に減らして検出を試みることができます。 | 15000 | [sn_devops.discover.max.pipelines.ado] |
| 変更領収書が有効な場合、DevOps 変更要求の状況を自動的に更新 | 変更領収書が有効な場合、DevOps 変更要求の状況を自動的に更新します。変更領収書がオンになっていても変更要求の状況の自動移行を停止したい場合は、このプロパティを無効にする必要があります。 | 選択 (有効) | [sn_devops.enable_change_receipt_state_transition] |
| トークンベースの認証が成功した後、このユーザーに切り替えます | ServiceNow インスタンスで devops.system ユーザーが利用できない場合は、このプロパティを使用して、トークン認証を完了するために必要な sn_devops.integration ロールを持つ他のユーザーを設定します。 | devops.system | [sn_devops.token_auth.user] |
| レート制限を超える検出アクションが再試行される回数の上限。 (Maximum limit for the number of times the discover action that exceeds the rate limit will be retried.) | レート制限に達した後に検出アクションが自動的に再試行される最大回数を決定します。たとえば、Azure DevOps のレート間隔が 5 分で、ここに値 4 を入力した場合、5 分ごとに検出アクションが 4 回再試行されます。 | 10 | [sn_devops.max_retry_count_discover] |
| DevOps データ検索でエラーが発生した場合でも変更要求の作成を有効にする (Maximum limit for the number of times the discover action that exceeds the rate limit will be retried) |
有効にすると、作業アイテム、コミット、テストサマリー、セキュリティサマリーなどの DevOps データの取得中にエラーが発生しても、対応する変更要求が作成されます。検索できるデータは、引き続き変更要求に関連付けられます。取得できないデータについては、サードパーティコンソールでエラーの原因がユーザーに通知され、ステップ実行レコードと変更作業メモの [コメントを変更] フィールドにも同じ情報が追加されます。 |
いいえ (無効) | [sn_devops.enable_change_creation_with_partial_data] |
| DevOps 変更要求手動承認フローがアクティブな場合に、状況の「新規」から「評価」への移行を有効にします | 有効にすると、DevOps 変更要求手動承認フローがアクティブなときに、変更要求の状況が [新規] から [評価] に直接更新されます。DevOps 変更要求の手動承認フローがアクティブなときに、変更要求状況から [評価] への自動移行を停止する場合は、このプロパティを無効にする必要があります。 | はい (有効) | [sn_devops.enable_change_request_state_transition] |
| 変更要求コールバックタイムアウト (分単位) | タイムアウト値を分単位で設定し、パイプラインの実行中に受信イベントが待機状態になったときに、システムが変更の処理を試行するまで試行します。その後、パイプラインは中止されます。エラーの原因は、サードパーティツールのコンソールログに表示されます。コールバックタイムアウトが原因でパイプラインがキャンセルされると、対応するステップ実行のコールバックレコードに同じ情報が追加されます。 | 120 分 | [sn_devops.change_request_callback_timeout] |
| インポート要求に使用されるデフォルトの Bitbucket ブランチ | インポート要求の作成に使用する必要がある既定の Bitbucket 分岐名を指定します。 | master | [sn_devops.bitbucket_default_branch] |
| autoCloseChange パラメーターが有効になっている場合、変更要求のクローズコード値が正常に完了しました。 | autoCloseChange パラメーターが有効な場合に正常に完了した変更要求のクローズコード値を入力します。 | 成功 | [sn_devops.change_request.auto_close_successful_code] |
| autoCloseChange パラメーターが有効になっている場合、変更要求のクローズコード値が完了しましたが問題が発生しています。 | autoCloseChange パラメーターが有効な場合に問題が出て完了した変更要求のクローズコード値を入力します。 | successful_issues | [sn_devops.change_request.auto_close_partial_successful_code] |
| autoCloseChange パラメーターが有効になっている場合、変更要求のクローズコード値が正常に完了しませんでした。 | autoCloseChange パラメーターが有効な場合に正常に完了できなかった変更要求のクローズコード値を入力します。 | 不成功 | [sn_devops.change_request.auto_close_failure_code] |
| オーケストレーション機能のインポートベースの証拠収集 | このプロパティは、パイプラインイベントの処理方法を変更します。オンにすると、パイプラインのステップレベルの処理がスキップされるため、インスタンスのオーバーヘッドが削減されます。スキップされたステップレベルのイベントは、処理の詳細「無視:『オーケストレーション機能のインポートベースの証拠収集』プロパティが有効になっているため、このイベントは無視されます」とともに無視されます。逆に、オフに切り替えると標準モードに戻り、すべての受信イベントが処理されます。 | False (無効) | [sn_devops.import_based_evidence_collection] |