- 重要な情報
- はじめに
- 用語集
- ガイド
- エージェント
- インテグレーション
- OpenTelemetry
- 開発者
- API
- CoScreen
- アプリ内
- Service Management
- インフラストラクチャー
- アプリケーションパフォーマンス
- 継続的インテグレーション
- ログ管理
- セキュリティ
- UX モニタリング
- 管理
Datadog CircleCI orb を使用して、CircleCI パイプラインで Synthetic テストを実行します。
CircleCI コマンド orb は datadog-ci をインストールし、datadog-ci synthetics run-tests
コマンドで Datadog Synthetic テストを実行するものです。
始めるには
run-tests.yml
ファイルを作成し、命名規則に従ってワークフローの入力を指定することで、ワークフローをカスタマイズします。version: 2.1
orbs:
synthetics-ci: datadog/synthetics-ci-orb@2.6.0
jobs:
e2e-tests:
docker:
- image: cimg/base:stable
steps:
- synthetics-ci/run-tests:
public_ids: 'abc-d3f-ghi, jkl-mn0-pqr'
workflows:
run-tests:
jobs:
- e2e-tests
この orb では、テストファイルのパターンへのパスがオーバーライドされます。
version: 2.1
orbs:
synthetics-ci: datadog/synthetics-ci-orb@2.6.0
jobs:
e2e-tests:
docker:
- image: cimg/base:stable
steps:
- synthetics-ci/run-tests:
files: e2e-tests/*.synthetics.json
workflows:
run-tests:
jobs:
- e2e-tests
Synthetic テストをトリガーするパイプラインの別の例については、simple-example.yml
ファイルを参照してください。
test_search_query
を使用した orb 使用の例version: 2.1
orbs:
synthetics-ci: datadog/synthetics-ci-orb@2.6.0
jobs:
e2e-tests:
docker:
- image: cimg/base:stable
steps:
- synthetics-ci/run-tests:
test_search_query: 'tag:e2e-tests'
workflows:
run-tests:
jobs:
- e2e-tests
version: 2.1
orbs:
synthetics-ci: datadog/synthetics-ci-orb@2.6.0
jobs:
e2e-tests:
docker:
- image: your-image
steps:
- checkout
- run:
name: Running server in background
command: npm start
background: true
- synthetics-ci/run-tests:
config_path: tests/tunnel-config.json
files: tests/*.synthetics.json
test_search_query: 'tag:e2e-tests'
tunnel: true
workflows:
test-server:
jobs:
- build-image
- integration-tests:
requires:
- build-image
CircleCI パイプラインの pollingTimeout
をカスタマイズするなどの追加オプションについては、CI/CD インテグレーション構成を参照してください。ローカルサーバーを起動し、Continuous Testing Tunnel を使用して Synthetic テストをトリガーする別のサンプルパイプラインについては、advanced-example.yml
ファイルを参照してください。
ワークフローをカスタマイズするために、run-tests.yml
ファイルに以下のパラメーターを設定することができます。
名前 | タイプ | デフォルト | 説明 |
---|---|---|---|
api_key | 環境変数名 | DATADOG_API_KEY | API キーが格納されている環境変数名。 |
app_key | 環境変数名 | DATADOG_APP_KEY | APP キーが格納されている環境変数名。 |
config_path | 文字列 | datadog-ci.json | テストを起動する際に使用するグローバルな JSON 構成。 |
fail_on_critical_errors | boolean | false | テストがトリガーされなかったか、結果を取得できなかった場合に失敗します。 |
fail_on_missing_tests | boolean | false | パブリック ID (public_ids を使用するか、テストファイルにリストされている) を持つ指定されたテストが少なくとも 1 つ実行中に見つからない場合 (例えば、プログラム上または Datadog サイトで削除された場合)、失敗します。 |
fail_on_timeout | boolean | true | テストタイムアウトを超えた場合、CI を強制的に失敗 (または合格) させます。 |
files | 文字列 | {,!(node_modules)/**/}*.synthetics.json | Synthetic テストのコンフィギュレーションファイルを検出するためのグロブパターン。 |
junit_report | 文字列 | なし | JUnit レポートを生成したい場合のファイル名。 |
locations | 文字列 | テストファイルの値 | テストが実行される場所をオーバーライドするための、セミコロンで区切られた場所の文字列。 |
polling_timeout | 数値 | 30 分 | アクションがテスト結果のポーリングを停止するまでの時間 (ミリ秒単位)。CI レベルでは、この時間以降に完了したテスト結果は失敗とみなされます。 |
public_ids | 文字列 | テストファイルの値 | トリガーしたい Synthetic テストの公開 ID をカンマで区切った文字列。 |
site | 文字列 | datadoghq.com | データ送信先となる Datadog のサイト。環境変数 DD_SITE が設定されている場合は、そちらが優先されます。 |
subdomain | 文字列 | app | Datadog アプリケーションにアクセスするために設定されたカスタムサブドメインの名前。 |
test_search_query | 文字列 | なし | 検索クエリに対応するテストをトリガーします。 |
tunnel | ブール値 | false | Continuous Testing Tunnel を使用してテストをトリガーします。 |
variables | 文字列 | なし | テストに変数を注入するための Key-Value ペア。KEY=VALUE という形式である必要があります。 |
CircleCI パイプラインの追加オプションについては、Continuous Testing と CI/CD インテグレーション構成を参照してください。
お役に立つドキュメント、リンクや記事: