Présentation

La détection des changements de code permet à Datadog d’identifier les commits appliqués dans le cadre d’un déploiement. Cette fonctionnalité présente plusieurs avantages :

• Elle permet de comprendre où des changements spécifiques ont été déployés, par exemple en surveillant le moment où les mises à jour sont appliquées à l’environnement production.
• Elle permet de diagnostiquer les incidents liés à un déploiement en fournissant des données sur les changements précis appliqués, afin que les équipes puissent identifier rapidement les causes fondamentales potentielles et ainsi résoudre plus rapidement les problèmes.

Pour détecter les changements de code déployés, Datadog exécute git log entre le SHA du commit de déploiement actuel et celui du déploiement précédent. Les commits de fusion sont exclus du calcul.

Les changements de code déployés sont affichés dans toutes les exécutions de déploiement de la page Deployment Executions. L’onglet Code Changes indique le déploiement précédent pris en compte ainsi que les changements de code détectés entre les deux déploiements.

En outre, la colonne Deployments de la page Recent Code Changes affiche les détails du service et de l’environnement pour tous les déploiements qui incluent un commit spécifique. Cette vue permet de comprendre rapidement si (et où) des changements de code ont été appliqués. Survolez la valeur de service pour découvrir si le déploiement a atteint tous les environnements prévus, en fonction des emplacements où le service est généralement déployé.

Les changements de code ne sont détectés que pour les déploiements qui :

• possèdent un service (@deployment.service) avec des spécifications de chemin de fichier définies dans le Software Catalog (voir les instructions de configuration pour en savoir plus) ;
• possèdent un environnement (@deployment.env) ;
• possèdent une URL de référentiel (@deployment.git.repository_url) et un SHA de commit (@deployment.git.commit.sha).

Configuration

Pour autoriser la détection des changements de code pour vos déploiements, vous devez suivre deux étapes :

1. Synchronisez vos métadonnées de référentiel avec Datadog.
2. Spécifiez le chemin du fichier de code source pour vos services.

Synchroniser vos métadonnées de référentiel avec Datadog

Reporting commit 007f7f466e035b052415134600ea899693e7bb34 from repository git@github.com:organization/example-repository.git.
180 tracked file paths will be reported.
✅  Handled in 0.077 seconds.

Spécifier des patterns de chemin de fichier de service

Pour pouvoir comprendre les changements de code introduits par un déploiement, vous devez uniquement prendre en compte les commits affectant le service déployé.

Pour y parvenir dans le Software Catalog, spécifiez, pour les services pertinents, des patterns de chemin de fichier globaux pour le code source dans la définition du service.

Si la définition du service contient une URL GitHub ou GitLab complète vers le dossier de l’application, un pattern de chemin unique est automatiquement utilisé. Le type de lien doit être défini sur repo et le nom du lien doit correspondre à « Source » ou au nom du service (shopist dans les exemples ci-dessous).

Si votre référentiel contient un seul service et que vous souhaitez que tous les répertoires soient pris en compte pour la détection des changements de code, vous pouvez ignorer cette étape. Si vous déployez plusieurs services à partir d’un référentiel, il est nécessaire de spécifier des patterns de chemin de code source.

Exemple (schéma v2.2) :

links:
  - name: shopist
    type: repo
    provider: github
    url: https://github.com/organization/example-repository/tree/main/src/apps/shopist

links:
  - name: shopist
    type: repo
    provider: gitlab
    url: https://gitlab.com/organization/example-repository/-/tree/main/src/apps/shopist?ref_type=heads

La détection des changements de code pour les déploiements du service shopist ne prend en compte que les commits Git qui incluent des changements dans le chemin src/apps/shopist/**. Vous pouvez configurer un contrôle plus granulaire avec extensions[datadoghq.com/cd-visibility] ou extensions[datadoghq.com/dora-metrics]. Si les deux extensions sont détectées, l’extension extensions[datadoghq.com/cd-visibility] est utilisée.

Exemple (schéma v2.2) :

extensions:
  datadoghq.com/cd-visibility:
    source_patterns:
      - src/apps/shopist/**
      - src/libs/utils/**

La détection des changements de code pour les déploiements du service shopist ne prend en compte que les commits Git qui incluent des changements dans le chemin src/apps/shopist/** ou le chemin src/libs/utils/**.

Si des patterns de code source pour un service sont définis à la fois dans un lien et dans une extension, seule l’extension est prise en compte lors du filtrage des commits.

Utiliser des patterns de chemins de fichier de service pour suivre les modifications dans l’ensemble du référentiel

Pour détecter les changements dans l’ensemble du référentiel, utilisez des patterns de chemin de fichier appropriés. Par exemple, "**" renvoie tous les fichiers.

Exemple (schéma v2.2) :

extensions:
  datadoghq.com/cd-visibility:
    source_patterns:
      - "**"

Dans cet exemple, la détection des changements de code pour les déploiements du service shopist prend en compte les commits Git qui incluent des changements dans l’ensemble de l’arborescence du référentiel.

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles:

En savoir plus sur Deployment VisibilityDOCUMENTATION Découvrir comment interroger et visualiser les déploiementsDOCUMENTATION