のユーザー作成統合 DevOps チェンジベロシティ
ユーザー作成の統合は、 DevOps チェンジベロシティ アプリケーションではデフォルトでは使用できない追加の計画、コーディング、およびテストツールを統合するためのものです。
DevOps チェンジベロシティアプリケーションには、一般的な計画、コーディング、およびDevOps テストツール統合を統合するためのツール定義が含まれていますが、DevOps 環境内の追加ツールのユーザー作成統合を設定することもできます。
統合オブジェクト
DevOps ツール統合は、これらのオブジェクトで構成されています。
ツール機能のアクション
- 接続 アクション:
接続すると、特定のツールのサブフローが呼び出され、接続ステータスが更新されます。接続ステータスメッセージがフォームに表示されます。
詳細については、「コネクト機能サブフロー」を参照してください。
- 検出 アクション:
検出時に、インポート要求レコードが作成され、特定のツールのサブフローが呼び出されます (統合機能レコードで定義)。インポート要求レコードの [詳細] フィールドと [ステータス] フィールドは、検出、更新、および失敗したアイテムの数で更新されます。
変換されたペイロードは、JSON 文字列としてのオブジェクトのアレイで構成されます。要素はツールの種類によって異なります。
詳細については、「機能サブフローの検出」を参照してください。
- インポート アクション:
インポートアクションは、履歴インポート機能をサポートしていません。
- ルックアップ アクション:
ルックアップメインフローは、統合開発者が作成したサブフローでアーティファクトツールタイプをサポートするために提供されています。
- 通知 (Webhook) アクション:
ソースツールは、生データを ServiceNow インスタンスに送信するように手動で (統合開発者によって) 構成されます。生のペイロードは、サブフローを使用して標準の JSON オブジェクトに変換されます。
詳細については、DevOps API の 通知機能のサブフロー と DevOps - POST /devops/tool/{capability} エンドポイントを参照してください。
注:サブフローが指定されていない場合、通知のデフォルト処理が行われます (元のペイロード は 変換されたペイロードに自動的にコピーされます)。この動作は、ツールのトランザクション データが ServiceNow DevOps によってそのままサポートされている場合に便利です。
詳細については、 通知機能のサブフロー の予想される標準ペイロードを参照してください。
DevOps 統合構成の概要
ツール統合の構成は、統合開発者と DevOps アドミンが完了できます。
- 統合開発者
- DevOps でツール統合レコードを作成して、統合するツール (ソースツール) を定義します。
- 統合するツール (ソースツール) からデータを収集して変換するための ワークフロースタジオ サブフロー を作成します。
- DevOps でツール機能マッピングレコードを作成して、ツール統合レコードをツールタイプの機能にマッピングします。注:通知 (Webhook) 機能がサポートされています。接続および検出機能もサポートされています。
- DevOps で統合機能レコードを作成して、ツールタイプ機能のアクションを指定します。
- DevOps アドミン
- DevOps で (計画立案、コーディング、またはテスト) ツールレコードを作成して、統合するツール (ソースツール) に接続します。注:ツール統合レコードは、ツールレコードの [ ツール ] フィールドで指定する必要があります。
- Webhook と認証情報を使用してソースツールを構成します。
- DevOps で (計画立案、コーディング、またはテスト) ツールレコードを作成して、統合するツール (ソースツール) に接続します。
受信イベント
受信イベントは、失敗したペイロードの再処理をサポートする通知フローのステージング領域として機能します。つまり、統合または変換の失敗によるエラーステータスのレコードを再試行できます。
受信イベントレコードが エラー ステータスの場合、フローはレコードをコア DevOps テーブルに正常に挿入できませんでした。
一般的なエラーは、これらのアクションで解決できます。
| エラー | アクション |
|---|---|
| 必須フィールドがありません | 変換済みペイロードが標準ペイロードと一致しません。 提供されている標準ペイロードと JSON ペイロードを参照してください。 |
| リポジトリが追跡対象としてマークされていません | コミットを挿入できません。 DevOpsアドミニストレーターはリポジトリを追跡する必要があります。 |
| [サブフロー] はアプリケーションスコープ内で公開されていません [app_scope] | サブフローは作成されますが、まだ公開されていません。 |
| タイムアウト例外 | サブフローは、プロパティに設定された値よりも時間がかかります。 com.glide.hub.flow_api.default_execution_time 詳細については、「 FlowAPI - executeSubflowQuick(String name, Map inputs, Number timeout)」 を参照してください。 注: サブフローの実行が、統合機能レコードの [ タイムアウト ] フィールドに設定された値を超えています。 |
| 通知機能と [tool_integration_sys_id] ツール統合の一致するサブフローが見つかりませんでした | フローは一致するサブフローを見つけることができませんでした。 統合セットアップ手順を確認します。 |
| ペイロードが想定された機能と一致しません。 | 元のペイロード (送信されるペイロード) は、ツール機能マッピングで構成されたツールタイプ機能とは異なる機能タイプです。 ペイロードタイプは、ツール統合で構成されたツールタイプ機能と一致する必要があります。 |
- ソース ツールがツール ID をクエリ パラメーターとして渡していません。
- ソースツールがツール ID を渡しましたが、インスタンスに一致するツール ID がありません。
ツールマッピング
ツールは複数のケイパビリティにマッピングできます。
| ツール統合 | ツールタイプの機能 | ツール機能のマッピング | |
|---|---|---|---|
|
|
プラン
コード
オーケストレーション
テスト
|
|
ツール機能マッピングは、複数のアクションにマッピングできます。
| ツール機能のマッピング | ツールのアクション | 統合機能 | |
|---|---|---|---|
|
|
Agile Development 2.0
Azure DevOps
Bitbucket
GitHub
GitHub Enterprise
GitLab
Jenkins
Jira
Rally
|
|
複数のテストタイプを各ツール統合にマッピングできます。
| 検査タイプ | ツール統合 | テストタイプマッピング |
|---|---|---|
ユニット: JUnit, XUnit, NUnit, Unit test 機能的な：
パフォーマンス:負荷 |
|
Azure DevOps
Jenkins
GitLab
GitHubおよびGitHub Enterprise
|