datadog ci

Datadog CI

Exécutez des commandes à partir de vos pipelines d’intégration continue (CI) et de livraison continue (CD) pour les intégrer aux produits Datadog existants.

Voir la section Utilisation pour une liste des commandes disponibles.

Comment installer la CLI

Le package se trouve sous @datadog/datadog-ci et peut être installé via NPM ou Yarn :

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

Si vous avez besoin datadog-ci comme outil CLI au lieu d'un package, vous pouvez l'exécuter avec npx ou l'installer globalement :

 # npxnpx @datadog/datadog-ci [commande]# NPM install globalementnpm install -g @datadog/datadog-ci# Yarn v1 ajouter globalementyarn global add @datadog/datadog-ci

Pour plus de façons d’installer la CLI, consultez cette section.

Usage

 Utilisation : datadog-ci  [] [options]

Les valeurs suivantes sont disponibles pour chaque et (éventuellement) .

Consultez le README lié à chaque commande pour plus de détails, ou cliquez sur ? pour voir la page de documentation associée.

cloud-run

• flare : Résolvez vos problèmes avec la configuration du service Cloud Run. ?

dsyms

• upload : téléchargez des fichiers iOS dSYM pour le suivi des erreurs (macOS uniquement). ?

flutter-symbols

• upload : télécharger des symboles Flutter pour le suivi des erreurs. ?

unity-symbols

• upload : télécharger des symboles Unity pour le suivi des erreurs.

git-metadata

• upload : téléchargez les métadonnées Git pour l’intégration du code source. ?

junit

• upload : téléchargez les rapports de test JUnit pour la visibilité des tests. ?

lambda

• flare : Résolvez vos problèmes avec l'instrumentation Datadog sur vos fonctions AWS Lambda.

• instrument : appliquez l'instrumentation Datadog aux fonctions AWS Lambda données.

• uninstrument : rétablissez l'instrumentation Datadog à partir des fonctions AWS Lambda données.

measure

• Ajoutez des mesures à une trace de pipeline CI Visibility ou à une durée de tâche dans Datadog. ?

react-native

• codepush : téléchargez les sourcesmaps React Native CodePush pour le suivi des erreurs. ?

• upload : téléchargez les sourcesmaps React Native pour le suivi des erreurs. ?

• xcode : téléchargez les sourcesmaps React Native pour le suivi des erreurs à partir de la phase de construction du bundle XCode. ?

sarif

• upload : téléchargez les rapports SARIF (Static Analysis Results Interchange Format) vers Datadog. ?

sbom

• upload : téléchargez les fichiers de nomenclature logicielle (SBOM) vers Datadog. ?

sourcemaps

• upload : téléchargez des sourcesmaps JavaScript pour le suivi des erreurs. ?

stepfunctions

• instrument : Instrumentez AWS Step Function avec Datadog pour obtenir des journaux et des traces. ?

• uninstrument : Désinstrumenter la fonction AWS Step. ?

synthetics

• run-tests : exécutez des tests de tests continus à partir du CI. ?

• upload-application : Téléchargez une nouvelle version vers une application mobile existante dans Datadog. ?

tag

• Ajoutez des balises personnalisées à une trace de pipeline CI Visibility ou à une durée de tâche dans Datadog. ?

trace

• Ajoutez des commandes personnalisées à un pipeline CI Visibility dans Datadog. ?

Commandes bêta

Les commandes suivantes sont des commandes bêta , vous pouvez les activer avec DD_BETA_COMMANDS_ENABLED=1 :

deployment

• mark : Marquer une tâche CI comme un déploiement. ?

• correlate : corrélez les déploiements de CD GitOps avec les pipelines CI des référentiels d'applications. ?

dora

• deployment : envoyez un nouvel événement de déploiement pour DORA Metrics à Datadog. ?

elf-symbols

• upload : Téléchargez les fichiers d'informations de débogage Elf pour le profilage (nécessite binutils). ?

gate

• evaluate : évaluer les règles Quality Gates dans Datadog. ?

Autres façons d'installer la CLI

Binaire autonome

Si l'installation de NodeJS dans le CI pose problème, des binaires autonomes sont fournis avec les versions. linux-x64 , linux-arm64 , darwin-x64 , darwin-arm64 (MacOS) et win-x64 (Windows) sont pris en charge.

Pour installer :

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

Mac OS

 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

Fenêtres

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

Ensuite, vous pouvez exécuter les commandes datadog-ci normalement :

 version datadog-ci

Image du conteneur

Pour exécuter datadog-ci à partir d'un conteneur, vous pouvez utiliser l'image datadog/ci disponible dans Docker Hub ainsi que les registres publics Amazon ECR et Google GC.

 docker pull datadog/ci

Cet exemple montre comment exécuter une commande à l'aide du conteneur et en transmettant les clés d'API et d'application :

 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 synthétiques run- tests -p pub-lic-id1

Créer votre propre image de conteneur

Vous pouvez créer une image à l'aide du Dockerfile fourni :

 conteneur de CD
docker build --tag datadog-ci .

Facultativement, vous pouvez utiliser l'argument de construction VERSION pour créer une image pour une version spécifique :

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

Développement

Avant de contribuer à ce projet open source, lisez notre CONTRIBUTING.md.

Licence

Licence Apache, v2.0