Passer à la navigation

Propositions de fusion

Demandez la révision des modifications d’une branche avant qu’elles n’atteignent une autre branche.

Présentation

Une proposition de fusion enregistre une demande de fusion des modifications d’une branche dans une autre et permet à un collègue d’examiner le diff avant cette opération. Toute personne disposant d’un accès de modification à l’agent peut ouvrir une proposition, même vers une branche qu’elle ne peut pas fusionner elle-même. La fusion de la proposition nécessite toujours un accès en écriture à la branche cible. Une proposition permet donc à une modification d’atteindre une branche protégée sans accorder à chaque contributeur les droits de fusion sur celle-ci.

Les propositions de fusion ajoutent une étape de révision facultative à la fusion directe de branches. Fusionnez directement lorsque vous disposez d’un accès en écriture à la branche cible et n’avez pas besoin d’un second avis. Ouvrez une proposition lorsque vous souhaitez qu’elle soit d’abord examinée, ou lorsque la branche cible est protégée et que vous n’y avez pas accès en écriture.

Disponibilité

Les propositions de fusion sont en alpha. Lorsque plusieurs branches d’un agent sont en cours simultanément, il devient difficile de savoir lesquelles sont prêtes et peuvent être fusionnées sans risque. Les propositions de fusion offrent à une équipe un emplacement unique pour examiner et discuter des modifications d’une branche, comparer les taux de réussite des tests entre les branches et consulter les dernières conversations de la branche.

L’alpha constitue une première étape vers un workflow de type CI/CD pour les agents, similaire aux pull requests sur GitHub. Les ajouts prévus dans les prochaines semaines incluent :

  • Des tests obligatoires qui doivent réussir avant qu’une proposition puisse être fusionnée.
  • La demande d’approbations auprès de réviseurs spécifiques.
  • La configuration de responsables pour différentes parties d’un agent.

Cycle de vie d’une proposition

Chaque proposition présente l’un des statuts suivants :

StatutSignification
OuverteEn attente de révision ou de fusion.
FusionnéeLes modifications de la branche source ont été fusionnées dans la branche cible.
FerméeRetirée par l’auteur, rejetée par une autre personne ou fermée automatiquement parce que la branche source a été archivée.

Lorsqu’une proposition est ouverte, les réviseurs peuvent rendre l’un des avis suivants. Le dernier avis d’un réviseur remplace tout avis antérieur de ce même réviseur :

État de la révisionSignification
ApprouvéeLe réviseur est satisfait des modifications.
Modifications demandéesLe réviseur souhaite qu’un élément soit traité avant la fusion.

Ouvrir une proposition

Ouvrez une proposition depuis la branche dont vous souhaitez faire examiner les modifications :

Dans l’onglet Branches de l’agent, ouvrez le menu d’options de la branche source et sélectionnez **Open merge proposal **.

Option Open merge proposal dans le menu d'options d'une branche

Donnez un titre à la proposition, ajoutez éventuellement une description et choisissez une branche cible parmi les autres branches non archivées de l’agent. L’ouverture d’une proposition ne modifie aucune branche, elle enregistre uniquement la demande.

Une paire de branches source et cible ne peut avoir qu’une seule proposition ouverte à la fois. Fermez la proposition existante avant d’en ouvrir une autre entre les mêmes deux branches.

Réviser une proposition

La page d’une proposition comporte les onglets suivants :

La description, l’historique des révisions et un formulaire permettant de laisser une révision.

Onglet Overview d'une proposition de fusion

Toute personne disposant d’un accès de modification à l’agent, à l’exception de l’auteur de la proposition, peut laisser une révision accompagnée d’un commentaire facultatif. Les commentaires prennent en charge Markdown.

Fusionner une proposition

La fusion d’une proposition effectue la même fusion de branches qu’une fusion directe, y compris la résolution des conflits et l’option d’archiver ensuite la branche source. Avant de pouvoir être fusionnée, une proposition doit répondre aux exigences suivantes :

  • L’utilisateur qui effectue la fusion dispose d’un accès en écriture aux branches source et cible. Sur une branche protégée, cela implique d’être administrateur du Workspace.
  • Le dernier avis d’aucun réviseur n’est « modifications demandées ». Un réviseur qui a demandé des modifications doit approuver avant que la proposition puisse être fusionnée.
  • La proposition comporte au moins une approbation d’une personne autre que son auteur. Les administrateurs du Workspace peuvent fusionner sans cette approbation.

La fusion d’une proposition ferme automatiquement toute autre proposition ouverte pour la même branche source, car ses modifications ont désormais été transférées.

Fermer une proposition

Une proposition peut être fermée sans être fusionnée à tout moment tant qu’elle est ouverte. L’auteur et les réviseurs peuvent modifier son titre et sa description jusqu’à sa fermeture.

  • Lorsque l’auteur ferme sa propre proposition, elle est enregistrée comme retirée.
  • Lorsqu’une autre personne la ferme, elle est enregistrée comme rejetée.
  • L’archivage de la branche source ferme automatiquement toute proposition ouverte depuis ou vers celle-ci, enregistrée comme branch_archived.

Propositions de fusion et ElevenAgents Architect

Architect peut ouvrir des propositions de fusion pour vous. Après avoir effectué et testé une modification sur une branche, il lit les commits et l’aperçu de fusion de la branche, puis ouvre une proposition avec les sections Résumé, Tests et Comment réviser. Il peut également suggérer des réviseurs parmi lesquels vous pourrez choisir. Comme Architect agit en votre nom, la proposition vous désigne comme auteur.

Architect ne peut pas réviser, approuver, fusionner ni fermer une proposition. Ces étapes sont toujours effectuées par des personnes. Consultez Propositions et validation pour connaître le workflow complet.

Prochaines étapes