Continuous Testing と Datadog CI Azure DevOps 拡張機能

Docs > Continuous Testing > Continuous Testing と CI/CD > Continuous Testing と Datadog CI Azure DevOps 拡張機能

概要

SyntheticsRunTests タスクを使用すると、Azure パイプラインの構成内で Synthetic テストを実行し、Azure DevOps を使用しているすべてのチームが、ソフトウェアライフサイクルの各段階で Synthetic テストの恩恵を受けられるようにすることができます。

利用可能な構成の詳細については、 datadog-ci synthetics run-tests のドキュメントを参照してください。

認証

サービス接続

Datadog サイトに接続するには、Datadog は SyntheticsRunTests タスクの構成時にカスタムサービス接続を設定することを推奨しています。

以下の入力が必要です。

Datadog site: ご利用の Datadog サイト。使用可能な値はこちらの表に記載されています。
Custom subdomain (デフォルト: app): Datadog 組織にアクセスするためのカスタムサブドメイン。URL が myorg.datadoghq.com の場合、カスタムサブドメインは myorg になります。
API key: Datadog API キー。このキーは Datadog 組織内で作成されます。
Application key: Datadog アプリケーションキー。このキーは Datadog 組織内で作成されます。

API キーとアプリケーションキー

API key: Datadog API キーです。このキーは Datadog 組織内で作成され、シークレットとして保存する必要があります。
Application key: Datadog アプリケーションキーです。このキーは Datadog 組織内で作成され、シークレットとして保存する必要があります。
Datadog サイト: ご利用の Datadog サイト。使用可能な値はこちらの表に記載されています。
Custom subdomain (オプション): Datadog 組織にアクセスするためのカスタムサブドメイン。URL が myorg.datadoghq.com の場合、カスタムサブドメインは myorg になります。

セットアップ

Datadog アカウントに接続するために、Azure パイプラインプロジェクトで Datadog CI サービス接続を作成します。一度作成すれば、あとはタスクにサービス接続の名前を入れるだけです。

Azure Organization に Visual Studio Marketplace から Datadog Continuous Testing 拡張機能をインストールします。
Datadog CI サービス接続に、または Azure パイプラインプロジェクトのシークレットとして Datadog API キーとアプリケーションキーを追加します。
Azure DevOps パイプラインで、SyntheticsRunTests タスクを使用します。

タスクはシンプルまたは複雑にすることができます。

シンプルの使用

公開 ID を使用したタスク例

- 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)'
    datadogSite: '$(DatadogSite)'
    subdomain: 'myorg'

複雑の使用

`testSearchQuery` を使用したタスク例

- task: SyntheticsRunTests@1
  displayName: Run Datadog Synthetic tests
  inputs:
    authenticationType: 'connectedService'
    connectedService: 'my-datadog-ci-connected-service'
    testSearchQuery: 'tag:e2e-tests'

`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)

`configPath` でグローバル構成ファイルを使用したタスク例

デフォルトでは、グローバル構成ファイルへのパスは datadog-ci.json です。このパスは config_path の入力値でオーバーライドすることができます。

- task: SyntheticsRunTests@1
  displayName: Run Datadog Synthetic tests
  inputs:
    authenticationType: 'connectedService'
    configPath: './global.config.json'
    connectedService: 'my-datadog-ci-connected-service'

入力