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 ペイロードを参照してください。 |
| リポジトリが追跡対象としてマークされていません (Repository not marked for tracking) | コミットを挿入できません。 DevOps アドミニストレーターはリポジトリを追跡する必要があります。 |
| [サブフロー] はアプリケーションスコープ [app_scope] 内で公開されていません ([Subflow] has not been published within application scope [app_scope]) | サブフローは作成されますが、まだ公開されていません。 |
| タイムアウト例外 (Timeout exception) | サブフローは、com.glide.hub.flow_api.default_execution_time プロパティに設定された値よりも時間がかかります。 FlowAPI - executeSubflowQuick(文字列名、マップ入力、数値タイムアウト)を参照してください。 注: サブフローの実行が、統合機能レコードの [タイムアウト] フィールドに設定された値を超えています。 |
| 通知機能と [tool_integration_sys_id] ツール連携の一致するサブフローが見つかりませんでした | フローは一致するサブフローを見つけることができませんでした。 統合セットアップ手順を確認します。 |
| ペイロードが想定された機能と一致しません。 (Payload does not match the expected capability.) | [元のペイロード] (送信されるペイロード) は、ツール機能マッピングで構成されたツールタイプ機能とは異なる機能タイプです。 ペイロードタイプは、ツール統合で構成されたツールタイプ機能と一致する必要があります。 |
- ソース ツールがツール ID をクエリパラメーターとして渡していません。
- ソースツールがツール ID を渡しましたが、インスタンスに一致するツール ID がありません。
ツールマッピング
ツールは複数のケイパビリティにマッピングできます。
| ツール統合 | ツールタイプの機能 | ツール機能のマッピング | |
|---|---|---|---|
|
|
計画
コード
オーケストレーション
テスト
|
|
ツール機能のマッピングは、複数のアクションにマッピングできます。
| ツール機能のマッピング | ツールのアクション | 統合機能 | |
|---|---|---|---|
|
|
Agile Development 2.0
Azure DevOps
Bitbucket
GitHub
GitHub エンタープライズ
GitLab
Jenkins
Jira
Rally
|
|
複数のテストタイプを各ツール統合にマッピングできます。
| テストタイプ | ツール統合 | テストタイプマッピング |
|---|---|---|
ユニット: JUnit, XUnit, NUnit, Unit test 機能的：
パフォーマンス:ロード |
|
Azure DevOps
Jenkins
GitLab
GitHub および GitHub Enterprise
|