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] |
| コミット担当者スコアの乗算係数 | コミット担当者スコアに使用される乗算係数。 | 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 変更要求ハンドラーサブフロー。 | 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] |
| レート制限を超える検出アクションが再試行される回数の上限。 | 検出アクションがレート制限に達した後に自動的に再試行される最大回数を決定します。たとえば、 Azure DevOps のレート間隔が 5 分で、ここに値 4 を入力した場合、5 分ごとにディスカバリーアクションが 4 回再試行されます。 | 10 | [sn_devops.max_retry_count_discover] |
| DevOps データ検索でエラーが発生した場合でも変更要求の作成を有効にする |
有効にすると、作業アイテム、コミット、テストサマリ、セキュリティサマリーなどの DevOps データの取得中にエラーが発生しても、対応する変更要求が作成されます。取得できるデータは、引き続き変更要求に関連付けられます。取得できないデータについては、サードパーティコンソールでエラーの理由がユーザーに通知され、ステップ実行レコードと変更作業メモの [コメントの変更] フィールドにも同じ情報が追加されます。 |
いいえ (無効) | [sn_devops.enable_change_creation_with_partial_data] |
| 変更要求コールバックタイムアウト (分単位) | タイムアウト値を分単位で設定し、パイプラインの実行中に受信イベントが待機状態になったときに、システムが変更の処理を試行するまで試行します。その後、パイプラインは中止されます。エラーの理由は、サードパーティツールのコンソールログに表示されます。コールバックタイムアウトが原因でパイプラインがキャンセルされると、対応するステップ実行のコールバックレコードに同じ情報が追加されます。 | 120分 | [sn_devops.change_request_callback_timeout] |
| GitHub アプリのクライアント ID 指定子 | OAuth 2.0 を使用して GitHub アプリ経由で GitHub に接続する場合は、GitHub アプリのクライアント ID プレフィックス (ID の最初の 3 文字以上) をこのプロパティの値として入力する必要があります。これは、GitHub ツール接続に対して適切な権限チェックが確実に実行されるようにするためです。 | IV1、IV2 | [sn_devops.github_oauth_client_id_specifier] |