- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Datadog Continuous Testing Azure DevOps 拡張機能を使用すると、Azure パイプラインの構成内で Synthetic テストを実行し、Azure DevOps を使用しているすべてのチームが、ソフトウェアライフサイクルの各段階で Synthetic テストの恩恵を受けられるようにすることができます。タスクとして SyntheticsRunTests
を実行することができます。
Datadog サイトに接続するために、Datadog は Synthetic Run Test タスクの構成時にカスタムサービス接続を設定することを推奨しています。
以下の入力が必要です。
app
): Datadog アプリケーションにアクセスするために設定されたカスタムサブドメインの名前。Datadog へのアクセスに使用する URL が myorg.datadoghq.com
の場合、この値は myorg
にする必要があります。myorg.datadoghq.com
の場合、この値は myorg
にする必要があります。Datadog アカウントに接続するために、Azure パイプラインプロジェクトで Datadog CI サービス接続を作成します。一度作成すれば、あとはタスクにサービス接続の名前を入れるだけです。
SyntheticsRunTests
タスクを使用します。注: 最近、タスクのメジャーバージョンを
SyntheticsRunTests@0
からSyntheticsRunTests@1
に変更しました。これは重大な変更ではありませんが、タスクバージョンと拡張機能バージョンの間の調整です。
- task: SyntheticsRunTests@1
displayName: Run Datadog Synthetic tests
inputs:
authenticationType: 'connectedService'
connectedService: 'my-datadog-ci-connected-service'
publicIds: |
abc-d3f-ghi
jkl-mn0-pqr
synthetics.json
ファイルを使用したタスク例- task: SyntheticsRunTests@1
displayName: Run Datadog Synthetic tests
inputs:
authenticationType: 'connectedService'
connectedService: 'my-datadog-ci-connected-service'
files: 'e2e-tests/*.synthetics.json'
テストファイルの例としては、この test.synthetics.json
ファイルを参照してください。
- task: SyntheticsRunTests@1
inputs:
authenticationType: 'apiAppKeys'
apiKey: '$(DatadogApiKey)'
appKey: '$(DatadogAppKey)'
subdomain: 'myorg'
datadogSite: '$(DatadogSite)'
注: 最近、タスクのメジャーバージョンを
SyntheticsRunTests@0
からSyntheticsRunTests@1
に変更しました。これは重大な変更ではありませんが、タスクバージョンと拡張機能バージョンの間の調整です。
testSearchQuery
を使用したタスク例- task: SyntheticsRunTests@1
displayName: Run Datadog Synthetic tests
inputs:
authenticationType: 'connectedService'
connectedService: 'my-datadog-ci-connected-service'
testSearchQuery: 'tag:e2e-tests'
variables: |
START_URL=https://staging.website.com
PASSWORD=$(StagingPassword)
testSearchQuery
と変数のオーバーライドを使用したタスク例- task: SyntheticsRunTests@1
displayName: Run Datadog Synthetic tests
inputs:
authenticationType: 'connectedService'
connectedService: 'my-datadog-ci-connected-service'
testSearchQuery: 'tag:e2e-tests'
configPath
によるグローバル構成オーバーライドを使用したタスク例このタスクは、グローバルな datadog-ci.config.json
ファイルへのパスをオーバーライドします。
- task: SyntheticsRunTests@1
displayName: Run Datadog Synthetic tests
inputs:
authenticationType: 'connectedService'
connectedService: 'my-datadog-ci-connected-service'
configPath: './synthetics-config.json'
コンフィギュレーションファイルの例としては、この global.config.json
ファイル をご覧ください。
名前 | 要件 | 説明 |
---|---|---|
authenticationType | 必須 | Datadog に使用させたい認証のタイプで、connectedService または apiAppKeys のどちらか。 |
connectedService | オプション | Datadog CI サービス接続で、connectedService 認証タイプを使用する際に使用する名前。 |
apiKey | オプション | apiAppKeys 認証タイプを使用する際の Datadog API キー。このキーは Datadog 組織によって作成され、シークレットとして保存される必要があります。 |
appKey | オプション | apiAppKeys 認証タイプを使用する際の Datadog アプリケーションキー。このキーは Datadog 組織によって作成され、シークレットとして保存される必要があります。 |
subdomain | オプション | apiAppKeys 認証タイプを使用する際に、Datadog アプリケーションにアクセスするために設定するカスタムサブドメインの名前。Datadog にアクセスするための URL が myorg.datadoghq.com である場合、この値は myorg に設定する必要があります。デフォルト: app 。 |
datadogSite | オプション | apiAppKeys 認証タイプを使用する場合の Datadog サイト。デフォルト: datadoghq.com 。 |
publicIds | オプション | トリガーしたい Synthetic テストの ID を、改行またはカンマで区切ったリスト。値を指定しない場合、タスクは synthetics.json という名前のファイルを探します。 |
testSearchQuery | オプション | 検索クエリに対応するテストをトリガーします。これは、テストの構成にタグを付けている場合に便利です。詳しくは、タグの命名規則とベストプラクティスを参照してください。 |
files | オプション | Synthetic テストの構成ファイルを検出するための Glob パターン。デフォルト: {,!(node_modules)/**/}*.synthetics.json 。 |
configPath | オプション | テストを起動するときに使用されるグローバル JSON 構成。詳細は構成例を参照してください。デフォルト: datadog-ci.json 。 |
variables | オプション | Synthetic テストに使用するグローバル変数のリストで、改行またはカンマで区切って指定します。例: START_URL=https://example.org,MY_VARIABLE=My title 。デフォルト: [] 。 |
jUnitReport | オプション | JUnit レポートを生成したい場合のファイル名。 |
pollingTimeout | オプション | タスクがテスト結果のポーリングを停止するまでの時間 (ミリ秒単位)。CI レベルでは、この時間以降に完了したテスト結果は失敗とみなされます。デフォルト: 30 分。 |
failOnCriticalErrors | オプション | テストがトリガーされなかったり、Datadog から結果を取得できなかったりした場合に、CI ジョブを失敗させます。デフォルト: false |
failOnMissingTests | オプション | パブリック ID (publicIds を使用するか、テストファイルにリストされている) を持つ指定されたテストが少なくとも 1 つ実行中に見つからない場合 (例えば、プログラム上または Datadog サイトで削除された場合)、CI ジョブを失敗させます。デフォルト: false |
failOnTimeout | オプション | 少なくとも 1 つのテストがデフォルトのテストタイムアウトを超えた場合、CI ジョブを失敗させます。デフォルト: true |
お役に立つドキュメント、リンクや記事: