DevOps チェンジベロシティのプロパティ
これらのプロパティを使用して、 DevOps チェンジベロシティ アプリケーションで設定を構成します。
必要なロール:sn_devops.admin
DevOps 変更ワークスペースからプロパティを表示するには、 .
クラシック UI からプロパティを表示するには、次に移動します: .
| プロパティ | 説明 | デフォルト | [Name (名前)] |
|---|---|---|---|
| 最大再試行回数 (エラーのある受信イベントの場合) | エラーが発生した受信イベントの再試行の最大数。 | 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] に設定します。それ以外はすべて誤りと見なされます。 | true の場合、フェッチされた JSON ペイロードは [インポート要求] ページに添付ファイルとして保存されます。 インポート要求ページレコードにペイロードを添付ファイルとして保存するには、[ 値 ] フィールドを true に設定します。それ以外はすべて誤りと見なされます。 |
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] |
| ページあたりの計画ツールの問題 | 1 ページあたりに表示される計画立案ツールのの問題の数。 | 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フローのカスタマイズ」を参照してください。 サブフローのコピーについては、「 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) アジャイル計画ツールの問題のインポート上限。 | 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 コミットの実行を判断する必要があるかどうかを有効にします |
有効にすると、[コミットの実行] の一部として、GitHub で最後に成功したワークフロー実行後、DevOps 変更最初の 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] |
| DevOps 変更要求手動承認フローがアクティブな場合に、状況の「新規」から「評価」への移行を有効にします | 有効にすると、DevOps 変更要求の手動承認フローがアクティブなときに、変更要求のステータスが [新規] から [評価] に直接更新されます。DevOps 変更要求の手動承認フローがアクティブなときに、変更要求ステータスから [評価] への自動移行を停止する場合は、このプロパティを無効にする必要があります。 | はい (有効) | [sn_devops.enable_change_request_state_transition] |
| 変更要求コールバックタイムアウト (分単位) | パイプラインの実行中に受信イベントが待機状態になったときにシステムが変更の処理を試みるまでのタイムアウト値を分単位で設定します。その後、パイプラインは中止されます。エラーの理由は、サードパーティツールのコンソールログに表示されます。コールバックのタイムアウトが原因でパイプラインがキャンセルされると、対応するステップ実行のコールバックレコードに同じ情報が追加されます。 | 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] |
| インポート要求に使用されるデフォルトの Bitbucket ブランチ | インポート要求の作成に使用する必要があるデフォルトの Bitbucket ブランチ名を指定します。 | master | [sn_devops.bitbucket_default_branch] |
| autoCloseChange パラメーターが有効な場合、変更要求のクローズコード値が正常に完了しました。 | |||
| autoCloseChange パラメーターが有効な場合に問題ありで完了した変更要求のクローズコード値。 | |||
| autoCloseChange パラメーターが有効になっている場合、変更要求のクローズコード値が正常に完了しませんでした。 |