AI CodeOps

Approbation des propriétaires de code (code owners)

Mis à jour le

L'approbation des propriétaires de code bloque une fusion jusqu'à ce qu'un propriétaire des fichiers modifiés l'approuve. Son fonctionnement, et sa place à côté de l'approbation d'AI CodeOps.

L'approbation des propriétaires de code est un réglage de protection de branche qui empêche la fusion d'une pull request tant qu'un propriétaire des fichiers qu'elle modifie ne l'a pas approuvée. Les propriétaires sont définis dans le fichier CODEOWNERS du dépôt.

Définition

Sur GitHub, le réglage s'appelle Require review from Code Owners et se trouve parmi les options de revue des pull requests d'une règle de protection de branche ou d'un ruleset. Lorsqu'il est activé, toute pull request qui touche du code ayant un propriétaire doit être approuvée par l'un des propriétaires de ce code avant de pouvoir être fusionnée (About code owners).

Deux détails comptent :

  • L'approbation de l'un quelconque des propriétaires indiqués satisfait la règle.
  • Le fichier CODEOWNERS peut lui-même être modifié dans une pull request : donnez donc aussi un propriétaire au fichier, ou au dossier .github/.

Pourquoi c'est important

Une revue exigée de « n'importe qui » peut venir de quelqu'un qui ne connaît pas le code. L'approbation des propriétaires de code envoie les changements risqués aux personnes qui connaissent cette partie du système.

Dans AI CodeOps

AI CodeOps a sa propre approbation, plus tôt dans le flux : le changement d'une session ne devient une pull request qu'après l'approbation d'un membre de l'espace de travail disposant de la permission approval:decide. Les Developer intégrés peuvent lancer des sessions mais pas les approuver. La revue des propriétaires de code a lieu ensuite sur la pull request, chez votre hébergeur, et l'hébergeur l'impose lorsque vous fusionnez depuis la console.

Questions fréquentes

Chaque propriétaire de code doit-il approuver ?

Non. Sur GitHub, l'approbation de l'un quelconque des propriétaires indiqués pour les fichiers modifiés suffit.

L'approbation d'AI CodeOps remplace-t-elle la revue des propriétaires de code ?

Non. Elles interviennent à des moments différents. L'approbation d'AI CodeOps a lieu avant l'ouverture de la pull request ; la revue des propriétaires de code a lieu sur la pull request.