でのユーザー作成の統合 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(文字列名、マップ入力、数値タイムアウト)」 を参照してください。 注: サブフローの実行が、統合機能レコードの [タイムアウト ] フィールドに設定された値を超えています。 |
| 通知機能と [tool_integration_sys_id] ツール統合の一致するサブフローが見つかりませんでした | フローで一致するサブフローを見つけることができませんでした。 統合のセットアップ手順を確認します。 |
| ペイロードが想定される機能と一致しません。 | 元のペイロード (送信されるペイロード) は、ツール機能マッピングで構成されたツールタイプ機能とは異なる機能タイプです。 ペイロードタイプは、ツール統合で構成されたツールタイプ機能と一致する必要があります。 |
- ソースツールがツール ID をクエリパラメーターとして渡していません。
- ソースツールはツール ID を渡しましたが、インスタンスに一致するツール ID がありません。
ツールマッピング
ツールは複数の機能にマッピングできます。
| ツール統合 | ツールタイプの機能 | ツール機能のマッピング | |
|---|---|---|---|
|
|
Plan (計画)
コード
オーケストレーション
テスト
|
|
ツール機能のマッピングは、複数のアクションにマッピングできます。
| ツール機能のマッピング | ツールのアクション | 統合機能 | |
|---|---|---|---|
|
|
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
|