Protection de branche (branch protection)
Mis à jour le
La protection de branche fixe les règles à respecter avant qu'un changement n'atteigne une branche, comme les revues et les vérifications réussies. Ce qu'elle couvre, et son rôle avec AI CodeOps.
La protection de branche est un ensemble de règles qu'un hébergeur Git applique à une branche, en général la branche par défaut, pour que les changements ne l'atteignent que par un processus convenu. Les termes ci-dessous suivent la documentation de GitHub ; GitLab et les autres hébergeurs ont leurs propres équivalents.
Définition
Réglages courants d'une règle de protection GitHub :
- Require a pull request, avec un nombre de revues d'approbation, et éventuellement une revue des propriétaires de code.
- Require status checks : des vérifications de statut doivent réussir, et la branche peut en option devoir être à jour au préalable.
- Require conversation resolution, des commits signés, un historique linéaire ou une file de fusion.
- Restrict who can push : restreindre qui peut pousser, et bloquer les force push et la suppression. Ces deux derniers sont bloqués par défaut.
Les administrateurs ne sont pas soumis à la règle, sauf si « Do not allow bypassing the above settings » est activé.
Pourquoi c'est important
La protection de branche est ce qui rend la revue et la CI obligatoires plutôt que facultatives. Sans elle, toute personne disposant d'un accès en écriture, ou un agent utilisant son token, peut pousser directement sur la branche à partir de laquelle vous déployez.
Dans AI CodeOps
AI CodeOps ne pousse jamais le changement d'une session sur votre branche par défaut. Il pousse une branche nommée codeops/run-<id> et ouvre une pull request vers la branche cible, après qu'une personne a approuvé le changement. Lorsque vous fusionnez depuis la console, AI CodeOps exécute sa propre barrière de livraison, puis appelle l'API de fusion normale de l'hébergeur, sans option de contournement : vos règles de protection décident donc toujours si la fusion aboutit.
Questions fréquentes
Les administrateurs du dépôt doivent-ils respecter la protection de branche ?
Sur GitHub, pas par défaut. La règle ne s'applique aux administrateurs que si « Do not allow bypassing the above settings » est activé.
AI CodeOps modifie-t-il mes réglages de protection de branche ?
Non. Il ne les lit pas et ne les configure pas. Il ouvre des pull requests, et votre hébergeur leur applique ses règles.