Ce produit n'est pas pris en charge par le
site Datadog que vous avez sélectionné. (
).
Aperçu
Créez une automatisation pour que Bits Code démarre une session lorsqu’un déclencheur se produit, comme une nouvelle découverte de sécurité de code ou un calendrier récurrent, puis livrez les résultats sous forme de pull request ou de notification Slack.
Avec les automatisations Bits Code, vous pouvez :
- Générer des corrections de code selon un calendrier, sans démarrer chaque session manuellement
- Faire en sorte que Bits Code réponde aux signaux d’autres produits Datadog, tels qu’une nouvelle recommandation APM, un test instable ou une découverte de sécurité de code
- Acheminer les modifications de code résultantes directement vers une pull request ou notifier une équipe sur Slack
Prérequis
Pour configurer une automatisation Bits Code, chacune des conditions suivantes doit être remplie :
Créez une automatisation
Vous pouvez créer une automatisation personnalisée, ou utiliser un modèle d’automatisation fourni par Datadog.
Par défaut, les automatisations nouvellement créées ont un statut Actif et apparaissent dans la liste Mes Automatisations.
Créez une automatisation personnalisée
Pour créer une automatisation Bits Code personnalisée :
- Dans Datadog, accédez à Bits AI > Bits Code > Automatisations.
- Cliquez sur Nouvelle automatisation.
- Dans le champ Nom de l’automatisation, saisissez un nom descriptif pour l’automatisation.
- Dans la section Déclencheur, configurez un déclencheur.
- Dans la section Sortie, configurez une ou plusieurs sorties.
- Cliquez sur Créer une automatisation ou Créer et exécuter maintenant.
Créez une automatisation à partir d’un modèle
Trouvez des modèles d’automatisation fournis par Datadog dans la section Modèles d’automatisation. Cela peut inclure :
- Créer des PR basées sur les recommandations APM : Génère des pull requests basées sur les recommandations APM pour un service spécifique.
- Corriger les erreurs fréquentes pour un dépôt : Utilise le déclencheur Invite personnalisée pour demander à Bits Code de scanner les 24 dernières heures de journaux, de trouver l’erreur la plus fréquente et d’ouvrir une pull request avec une correction.
Cliquez sur une tuile de modèle pour accéder au nouveau formulaire d’automatisation. Vous devez configurer une sortie avant de créer l’automatisation.
Déclencheurs
Un déclencheur définit quand une automatisation s’exécute et sur quoi Bits Code agit. Un déclencheur est composé de jusqu’à trois composants :
- Recherche de produit : un signal provenant de Datadog, tel qu’un problème de suivi des erreurs
- Invite personnalisée : une instruction libre indiquant à Bits Code quoi faire contre un dépôt choisi
- Planification : un intervalle de temps récurrent, tel que quotidien ou à des jours spécifiques de la semaine
Cliquez sur Ajouter un déclencheur pour ajouter un composant. Vous pouvez combiner une recherche de produit avec un calendrier, une invite personnalisée avec un calendrier, ou utiliser une recherche de produit seule.
Pour limiter le nombre de sessions de Bits Code que l’automatisation peut créer dans une période donnée (par exemple, 5 runs per Week), cliquez sur Ajouter un déclencheur > Définir le nombre maximum d’exécutions. Une exécution d’automatisation peut produire plus d’une session. Utilisez ce paramètre pour contrôler le volume de pull requests ou de notifications qu’une automatisation produit.
Déclencheur de recherche de produit
Un déclencheur de recherche de produit exécute l’automatisation en réponse à de nouveaux problèmes dans un autre produit Datadog (par exemple, Suivi des erreurs ou Sécurité du code). Vous pouvez utiliser un déclencheur de recherche de produit seul, qui exécute l’automatisation chaque fois qu’il y a une nouvelle découverte, ou avec un calendrier et une fenêtre de retour que vous définissez (dans le champ Nouvelles découvertes dans).
Bien qu'il soit courant d'utiliser un déclencheur de recherche de produit seul (pour remédier immédiatement aux nouvelles découvertes), le coupler avec un calendrier et une fenêtre de retour vous permet de surveiller les nouvelles découvertes uniquement pendant certaines périodes. Par exemple, si vous déployez chaque semaine le mercredi, vous voudrez peut-être configurer un déclencheur de recommandations APM pour s'exécuter chaque jeudi, en regardant en arrière sur 24 heures.
Lors de la configuration d’un déclencheur de recherche de produit, vous pouvez configurer des filtres supplémentaires, qui varient selon le produit. Exemple :
- Tests instables prend en charge le filtrage par Dépôt, Branche (par défaut, la branche par défaut du dépôt), et Statut.
- Sécurité du code (SAST) prend en charge le filtrage par Dépôt, Sévérité, Règle à remédier, et un commutateur pour Filtrer les découvertes identifiées comme des faux positifs par Bits AI.
Chaque découverte qui déclenche une automatisation est liée à une seule session. Plusieurs découvertes ne peuvent pas être corrigées dans une seule session ou pull request.
Déclencheur d’invite personnalisée
Une invite personnalisée indique à Bits Code quoi faire chaque fois que l’automatisation s’exécute, en texte libre, contre un dépôt choisi. Utilisez une invite personnalisée pour des tâches de maintenance récurrentes qui ne sont pas liées à un signal Datadog spécifique, comme la mise à jour des dépendances ou le rafraîchissement de la documentation.
Déclencheur de calendrier
Un déclencheur de calendrier contrôle quand une automatisation s’exécute. Il peut être utilisé en combinaison avec une recherche de produit ou une invite personnalisée. Lors de la définition d’une planification, vous pouvez choisir parmi :
- Chaque… : Choisissez un intervalle prédéfini (par exemple,
Every day at 09:00 am). - Planification personnalisée : Choisissez des jours spécifiques de la semaine et une heure de la journée (par exemple,
Mo, We, Fr at 03:00 pm).
Sorties
Une sortie définit ce que Bits Code fait après qu’une session soit terminée. Une automatisation peut avoir une ou plusieurs sorties, y compris l’ouverture d’une demande de tirage et la génération d’une notification Slack.
Sortie de pull request
Vous pouvez configurer votre automatisation pour :
- Créer une pull request : Ouvrir une pull request avec les modifications proposées
- Rédiger une pull request : Ouvrir une pull request brouillon avec les modifications proposées
En tant qu’auteur d’une automatisation Bits Code, vous êtes l’auteur de toutes les pull requests qu’elle génère.
Sortie de message Slack
Vous pouvez configurer votre automatisation pour envoyer un message Slack résumant la session et les modifications de code. Si vous utilisez une sortie de pull request en plus d’une sortie Slack, Bits Code inclut un lien vers la pull request dans le message Slack.
Lorsque vous ajoutez une sortie de message Slack, par défaut, Bits Code envoie le message au canal configuré pour le service concerné dans Catalog. Vous pouvez définir un canal Slack de secours, qui est utilisé lorsqu’aucun canal n’est défini dans Catalog.
Gérer les automatisations
Sur Automatisations, consultez les automatisations que vous avez créées dans l’onglet Mes automatisations. Passez à Tous pour voir les automatisations créées par quiconque dans votre organisation.
Vous pouvez mettre en pause ou reprendre toute automatisation, mais vous ne pouvez modifier ou supprimer que les automatisations que vous avez créées.
Lectures complémentaires
Documentation, liens et articles supplémentaires utiles:
