datadog ci
v2.44.0
継続的インテグレーション (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 <コマンド> [<サブコマンド>] [オプション]
次の値は、各<command>および (オプション) <subcommand>で使用できます。
詳細については、各コマンドにリンクされている 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 インストルメンテーションを元に戻します。
measureDatadog の CI Visibility パイプライン トレースまたはジョブ スパンにメジャーを追加します。 ?
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 の既存のモバイル アプリケーションに新しいバージョンをアップロードします。 ?
tagDatadog の CI 可視化パイプライン トレースまたはジョブ スパンにカスタム タグを追加します。 ?
traceDatadog の 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
