継続的インテグレーション (CI) および継続的デリバリー (CD) パイプラインからコマンドを実行して、既存の Datadog 製品と統合します。
使用可能なコマンドのリストについては、「使用法」セクションを参照してください。
パッケージは @datadog/datadog-ci の下にあり、NPM または Yarn を通じてインストールできます。
# NPMnpm install --save-dev @datadog/datadog-ci# Yarnyarn add --dev @datadog/datadog-ci
パッケージではなく CLI ツールとしてdatadog-ci
必要な場合は、 npx
で実行するか、グローバルにインストールできます。
# npxnpx @datadog/datadog-ci [コマンド]# NPM グローバルにインストールnpm install -g @datadog/datadog-ci# Yarn v1 add globalyarn global add @datadog/datadog-ci
CLI をインストールするその他の方法については、このセクションを参照してください。
使用法: datadog-ci <コマンド> [<サブコマンド>] [オプション]
次の値は、各
および (オプション)
で使用できます。
詳細については、各コマンドにリンクされている README を参照するか、[?] をクリックしてください。関連ドキュメントのページを参照してください。
cloud-run
flare
: Cloud Run サービス構成に関する問題のトラブルシューティングを行います。 ?
dsyms
upload
: エラー追跡用に iOS dSYM ファイルをアップロードします (macOS のみ)。 ?
flutter-symbols
upload
: エラー追跡用の Flutter シンボルをアップロードします。 ?
unity-symbols
upload
: エラー追跡用の Unity シンボルをアップロードします。
git-metadata
upload
: ソースコード統合用の Git メタデータをアップロードします。 ?
junit
upload
: テストの可視化のために JUnit テスト レポートをアップロードします。 ?
lambda
flare
: AWS Lambda 関数の Datadog インストルメンテーションに関する問題のトラブルシューティングを行います。
instrument
: Datadog インストルメンテーションを指定された AWS Lambda 関数に適用します。
uninstrument
: 指定された AWS Lambda 関数から Datadog インストルメンテーションを元に戻します。
measure
Datadog の CI 可視化パイプライン トレースまたはジョブ スパンにメジャーを追加します。 ?
react-native
codepush
: エラー追跡用に React Native CodePush ソースマップをアップロードします。 ?
upload
: エラー追跡用に React Native ソースマップをアップロードします。 ?
xcode
: XCode バンドルのビルド フェーズからエラー追跡用の React Native ソースマップをアップロードします。 ?
sarif
upload
: 静的分析結果交換形式 (SARIF) レポートを Datadog にアップロードします。 ?
sbom
upload
: ソフトウェア部品表 (SBOM) ファイルを Datadog にアップロードします。 ?
sourcemaps
upload
: エラー追跡用の JavaScript ソースマップをアップロードします。 ?
stepfunctions
instrument
: Datadog を使用して AWS Step Function をインストルメントして、ログとトレースを取得します。 ?
uninstrument
: AWS ステップ関数をアンインストゥルメントします。 ?
synthetics
run-tests
: CI から継続的テスト テストを実行します。 ?
upload-application
: Datadog の既存のモバイル アプリケーションに新しいバージョンをアップロードします。 ?
tag
Datadog の CI 可視化パイプライン トレースまたはジョブ スパンにカスタム タグを追加します。 ?
trace
Datadog の CI 可視化パイプラインにカスタム コマンドを追加します。 ?
以下はベータ版のコマンドで、 DD_BETA_COMMANDS_ENABLED=1
で有効にできます。
deployment
mark
: CI ジョブをデプロイメントとしてマークします。 ?
correlate
: GitOps CD デプロイメントをアプリケーション リポジトリ CI パイプラインと関連付けます。 ?
dora
deployment
: DORA メトリクスの新しいデプロイメント イベントを Datadog に送信します。 ?
elf-symbols
upload
: プロファイリング用の Elf デバッグ情報ファイルをアップロードします (binutils が必要)。 ?
gate
evaluate
: Datadog の Quality Gates ルールを評価します。 ?
CI への NodeJS のインストールが問題となる場合は、スタンドアロン バイナリがリリースで提供されます。 linux-x64 、 linux-arm64 、 darwin-x64 、 darwin-arm64 (MacOS) およびwin-x64 (Windows) がサポートされています。
インストールするには:
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_linux-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci
curl -L --fail "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_darwin-x64" --output "/usr/local/bin/datadog-ci" && chmod +x /usr/local/bin/datadog-ci
Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64" -OutFile "datadog-ci.exe"
その後、通常どおりdatadog-ci
コマンドを実行できます。
datadog-ci のバージョン
コンテナからdatadog-ci
実行するには、Docker Hub およびパブリック Amazon ECR および Google GC レジストリで利用可能なdatadog/ci
イメージを使用できます。
docker pull datadog/ci
この例では、コンテナーを使用してコマンドを実行し、API キーとアプリ キーを渡す方法を示します。
import DD_API_KEY=$(cat /secret/dd_api_key)export DD_APP_KEY=$(cat /secret/dd_app_key)docker run --rm -it -v $(pwd):/w -e DD_API_KEY -e DD_APP_KEY datadog/ci 合成 run-テスト -p パブリック ID1
提供された Dockerfile を使用してイメージを構築できます。
CDコンテナ docker build --tag datadog-ci 。
オプションで、 VERSION
ビルド引数を使用して、特定のバージョンのイメージをビルドできます。
docker build --build-arg "VERSION=v1.14" --t datadog-ci 。
このオープンソース プロジェクトに貢献する前に、CONTRIBUTING.md をお読みください。
Apache ライセンス、v2.0