datadog ci

Datadog CI

Führen Sie Befehle aus Ihren Continuous Integration (CI)- und Continuous Delivery (CD)-Pipelines aus, um sie in bestehende Datadog-Produkte zu integrieren.

Eine Liste der verfügbaren Befehle finden Sie im Abschnitt „Verwendung“.

So installieren Sie die CLI

Das Paket befindet sich unter @datadog/datadog-ci und kann über NPM oder Yarn installiert werden:

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

Wenn Sie datadog-ci als CLI-Tool statt als Paket benötigen, können Sie es mit npx ausführen oder global installieren:

 # npxnpx @datadog/datadog-ci [Befehl]# NPM install globallynpm install -g @datadog/datadog-ci# Yarn v1 add globallyyarn global add @datadog/datadog-ci

Weitere Möglichkeiten zur Installation der CLI finden Sie in diesem Abschnitt.

Verwendung

 Verwendung: datadog-ci <Befehl> [<Unterbefehl>] [Optionen]

Die folgenden Werte sind für jeden <command> und (optional) <subcommand> verfügbar.

Weitere Informationen finden Sie in der verlinkten README-Datei jedes Befehls oder klicken Sie auf ? um die zugehörige Dokumentationsseite anzuzeigen.

cloud-run

• flare : Beheben Sie Ihre Probleme mit der Cloud Run-Dienstkonfiguration. ?

dsyms

• upload : Laden Sie iOS-dSYM-Dateien für die Fehlerverfolgung hoch (nur macOS). ?

flutter-symbols

• upload : Flutter-Symbole für die Fehlerverfolgung hochladen. ?

unity-symbols

• upload : Unity-Symbole für die Fehlerverfolgung hochladen.

git-metadata

• upload : Git-Metadaten für die Quellcode-Integration hochladen. ?

junit

• upload : JUnit-Testberichte für Testsichtbarkeit hochladen. ?

lambda

• flare : Beheben Sie Ihre Probleme mit der Datadog-Instrumentierung auf Ihren AWS Lambda-Funktionen.

• instrument : Wenden Sie die Datadog-Instrumentierung auf die angegebenen AWS Lambda-Funktionen an.

• uninstrument : Datadog-Instrumentierung aus den angegebenen AWS Lambda-Funktionen zurücksetzen.

measure

• Fügen Sie Maßnahmen zu einem CI Visibility-Pipeline-Trace oder Job-Span in Datadog hinzu. ?

react-native

• codepush : Laden Sie React Native CodePush-Sourcemaps zur Fehlerverfolgung hoch. ?

• upload : Laden Sie React Native-Sourcemaps zur Fehlerverfolgung hoch. ?

• xcode : Laden Sie React Native-Sourcemaps für die Fehlerverfolgung aus der Erstellungsphase des XCode-Bundles hoch. ?

sarif

• upload : Laden Sie SARIF-Berichte (Static Analysis Results Interchange Format) auf Datadog hoch. ?

sbom

• upload : Software Bill of Materials (SBOM)-Dateien auf Datadog hochladen. ?

sourcemaps

• upload : Laden Sie JavaScript-Quellkarten für die Fehlerverfolgung hoch. ?

stepfunctions

• instrument : Instrumentieren Sie AWS Step Function mit Datadog, um Protokolle und Traces zu erhalten. ?

• uninstrument : Deinstrumentieren Sie die AWS-Schrittfunktion. ?

synthetics

• run-tests : Führen Sie kontinuierliche Testtests über das CI aus. ?

• upload-application : Laden Sie eine neue Version in eine vorhandene mobile Anwendung in Datadog hoch. ?

tag

• Fügen Sie benutzerdefinierte Tags zu einem CI Visibility-Pipeline-Trace oder Job-Span in Datadog hinzu. ?

trace

• Fügen Sie benutzerdefinierte Befehle zu einer CI-Sichtbarkeitspipeline in Datadog hinzu. ?

Beta-Befehle

Die folgenden Beta -Befehle können Sie mit DD_BETA_COMMANDS_ENABLED=1 aktivieren:

deployment

• mark : Markiert einen CI-Job als Bereitstellung. ?

• correlate : GitOps-CD-Bereitstellungen mit Anwendungs-Repositories-CI-Pipelines korrelieren. ?

dora

• deployment : Senden Sie ein neues Bereitstellungsereignis für DORA-Metriken an Datadog. ?

elf-symbols

• upload : Elf-Debug-Infodateien für die Profilerstellung hochladen (erfordert Binutils). ?

gate

• evaluate : Quality Gates-Regeln in Datadog auswerten. ?

Weitere Möglichkeiten zur Installation der CLI

Eigenständige Binärdatei

Wenn die Installation von NodeJS im CI ein Problem darstellt, werden eigenständige Binärdateien mit Releases bereitgestellt. linux-x64 , linux-arm64 , darwin-x64 , darwin-arm64 (MacOS) und win-x64 (Windows) werden unterstützt.

Zur Installation:

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

MacOS

 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

Windows

 Invoke-WebRequest -Uri "https://github.com/DataDog/datadog-ci/releases/latest/download/datadog-ci_win-x64" -OutFile "datadog-ci.exe"

Anschließend können Sie datadog-ci -Befehle normal ausführen:

 datadog-ci-Version

Containerbild

Um datadog-ci aus einem Container auszuführen, können Sie das im Docker Hub verfügbare datadog/ci -Image sowie die öffentlichen Amazon ECR- und Google GC-Register verwenden.

 Docker Pull Datadog/ci

Dieses Beispiel zeigt, wie Sie einen Befehl mithilfe des Containers ausführen und die API- und App-Schlüssel übergeben:

 export 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 Synthetics run- testet -p öffentliche-ID1

Erstellen Sie Ihr eigenes Container-Image

Sie können ein Image mit der bereitgestellten Docker-Datei erstellen:

 CD-Container
docker build --tag datadog-ci .

Optional können Sie das Build-Argument VERSION verwenden, um ein Image für eine bestimmte Version zu erstellen:

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

Entwicklung

Bevor Sie zu diesem Open-Source-Projekt beitragen, lesen Sie unsere CONTRIBUTING.md.

Lizenz

Apache-Lizenz, v2.0