數據狗CI

數據狗CI

從持續整合 (CI) 和持續交付 (CD) 管道執行命令以與現有 Datadog 產品整合。

有關可用命令的列表，請參閱“用法”部分。

如何安裝 CLI

該軟體包位於 @datadog/datadog-ci 下，可以透過 NPM 或 Yarn 安裝：

 # NPMnpm install --save-dev @datadog/datadog-ci# Yarnarn add --dev @datadog/datadog-ci

如果您需要datadog-ci作為 CLI 工具而不是軟體包，您可以使用npx運行它或全域安裝它：

 # npxnpx @datadog/datadog-ci [指令]# NPM 全域安裝 npm install -g @datadog/datadog-ci# Yarn v1 全域新增yarn 全域新增 @datadog/datadog-ci

有關安裝 CLI 的更多方法，請參閱本節。

用法

用法：datadog-ci <指令> [<子指令>] [選項]

以下值可用於每個和（可選） 。

有關更多詳細信息，請參閱每個命令的連結自述文件，或單擊？查看相關文件頁面。

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 ：Uninstrument AWS Step Function。 ？

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 Metrics 的新部署事件傳送到 Datadog。 ？

elf-symbols

• upload ：上傳 Elf 偵錯資訊檔案以進行效能分析（需要 binutils）。 ？

gate

• evaluate ：評估 Datadog 中的品質閘規則。 ？

安裝 CLI 的更多方法

獨立二進位文件

如果在 CI 中安裝 NodeJS 是一個問題，則隨版本一起提供獨立的二進位。支援linux-x64 、 linux-arm64 、 darwin-x64 、 darwin-arm64 (MacOS) 和win-x64 (Windows)。

安裝：

Linux

 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

蘋果系統

捲曲-L --fail「https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_darwin-x64」--輸出「/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拉資料狗/ci

此範例示範如何使用容器運行命令並傳入 API 和應用程式金鑰：

匯出 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 data-dog/ci 合成運行合成測試-p pub-lic-id1

建立您自己的容器鏡像

您可以使用提供的 Dockerfile 建置映像：

 CD容器
docker build --tag datadog-ci 。

或者，您可以使用VERSION建立參數來建立特定版本的映像：

 docker build --build-arg "VERSION=v1.14" --t datadog-ci 。

發展

在為這個開源專案做出貢獻之前，請先閱讀我們的 CONTRIBUTING.md。

執照

Apache 許可證，v2.0