Test - À propos des branches - test

Publication de test 12/16

Utilisez une branche pour isoler le travail de développement sans affecter les autres branches du référentiel. Chaque dépôt a une branche par défaut et peut avoir plusieurs autres branches. Vous pouvez fusionner une branche dans une autre branche à l’aide d’une demande de tirage.  

À propos des branches

Les branches vous permettent de développer des fonctionnalités, de corriger des bogues ou d’expérimenter en toute sécurité de nouvelles idées dans une zone autonome de votre dépôt. 

Vous créez toujours une branche à partir d’une branche existante. En règle générale, vous pouvez créer une branche à partir de la branche par défaut de votre dépôt. Vous pouvez ensuite travailler sur cette nouvelle branche de manière isolée des modifications apportées par d’autres personnes au dépôt. Une branche que vous créez pour créer une fonctionnalité est communément appelée branche branche de fonctionnalité ou branche de rubrique. Pour plus d’informations, consultez « Création et suppression de branches dans votre dépôt ».

Vous pouvez également utiliser une branche pour publier un site GitHub Pages. Pour plus d’informations, consultez « À propos de GitHub Pages ».

Vous devez disposer d’un accès en écriture à un dépôt pour créer une branche, ouvrir une demande de tirage ou supprimer et restaurer des branches dans une demande de tirage. Pour plus d’informations, consultez « Autorisations d’accès sur GitHub ».

À propos de la branche par défaut

Lorsque vous créez un dépôt avec du contenu sur GitHub, GitHub crée le dépôt avec une seule branche. Cette première branche du dépôt est la branche par défaut. Le branche par défaut est la branche que GitHub affiche lorsque quelqu’un visite votre dépôt. Le branche par défaut est également la branche initiale que Git extrait localement quand quelqu’un clone le dépôt. Sauf si vous spécifiez une autre branche, le branche par défaut dans un dépôt est le branche de base pour les nouvelles demandes de tirage et les validations de code.

Par défaut, GitHub nomme le branche par défaut main dans n’importe quel nouveau dépôt. 

Vous pouvez modifier le branche par défaut d’un dépôt existant. Pour plus d’informations, consultez « Modification de la branche par défaut ».

Vous pouvez définir le nom du branche par défaut pour les nouveaux dépôts. Pour plus d’informations, consultez « Gestion des branche par défaut pour vos dépôts », « Gestion du nom branche par défaut des dépôts dans votre organization » et « Application de stratégies de gestion des dépôts dans votre compte d’entreprise ».

Utilisation des branches

Une fois que vous êtes satisfait de votre travail, vous pouvez ouvrir une demande de tirage pour fusionner les modifications de la branche actuelle (la branche principale) dans une autre branche (la branche de base). Pour plus d’informations, consultez « À propos des demandes de tirage."

Une fois qu’une demande de tirage a été fusionnée ou fermée, vous pouvez supprimer le branche de tête, car cela n’est plus nécessaire. Vous devez disposer d’un accès en écriture dans le dépôt pour supprimer des branches. Vous ne pouvez pas supprimer les branches directement associées aux demandes de tirage ouvertes. Pour plus d’informations, consultez « Suppression et restauration de branches dans une demande de tirage »

Si vous supprimez un branche de tête après la fusion de sa demande de tirage, GitHub recherche toutes les demandes de tirage ouvertes dans le même dépôt qui spécifient la branche supprimée comme branche de base. GitHub met automatiquement à jour ces demandes de tirage, en remplaçant leur branche de base par la branche de base de la demande de tirage fusionnée. Les diagrammes suivants illustrent cela.

Ici, quelqu’un a créé une branche appelée feature1 à partir de la branche main, et vous avez ensuite créé une branche appelée feature2 à partir de feature1. Il existe des demandes de tirage ouvertes pour les deux branches. Les flèches indiquent la branche de base actuelle pour chaque demande de tirage. À ce stade, feature1 est la branche de base de feature2. Si la demande de tirage pour feature2 est fusionnée maintenant, la branche feature2 est fusionnée dans feature1.

Dans le diagramme suivant, une personne a fusionné la demande de tirage pour feature1 dans la branche master et a supprimé la branche feature1. Par conséquent, GitHub a automatiquement recible la demande de tirage pour feature2 afin que son branche de base soit maintenant master.

Maintenant, lorsque vous fusionnez la demande de tirage feature2, elle est fusionnée dans le main  branche.

Utilisation de branches protégées

Les administrateurs de dépôt peuvent activer les protections sur une branche. Si vous travaillez sur une branche protégée, vous ne pourrez pas supprimer ou poussée forcée à la branche. Les administrateurs de dépôt peuvent également activer plusieurs autres paramètres branche protégée pour appliquer différents flux de travail avant la fusion d’une branche.

Pour voir si votre demande de tirage peut être fusionnée, examinez la zone de fusion en bas de l’ongletConversation de la demande de tirage. Pour plus d’informations, consultez « À propos des branches protégées ».

Lorsqu’une branche est protégée :

• Vous ne pourrez pas supprimer ou poussée forcée à la branche.

• Si les vérifications d’état nécessaires sont activées sur la branche, vous ne pourrez pas fusionner les modifications dans la branche tant que tous les tests CI requis n’auront pas réussi. Pour plus d’informations, consultez « À propos de vérifications d’état ».

• Si les révisions de demande de tirage requises sont activées sur la branche, vous ne pourrez pas fusionner les modifications dans la branche tant que toutes les exigences de la stratégie de révision de demande de tirage n’auront pas été remplies. Pour plus d’informations, consultez « Fusion d’une demande de tirage ».

• Si la révision requise d’un propriétaire de code est activée sur une branche et qu’une demande de tirage modifie le code qui a un propriétaire, un propriétaire de code doit approuver la demande de tirage avant de pouvoir être fusionnée. Pour plus d’informations, consultez « À propos des propriétaires de code ».

• Si la signature de validation requise est activée sur une branche, vous ne pourrez pas envoyer (push) à la branche des commits qui ne sont pas signés et vérifiés. Pour plus d’informations, consultez « À propos de la vérification des signatures de validation » et « À propos des branches protégées ».

• Si vous utilisez l’éditeur de conflit de GitHub pour résoudre les conflits d’une demande de tirage que vous avez créée à partir d’un branche protégée, GitHub vous aide à créer une autre branche pour la demande de tirage, afin que votre résolution des conflits puisse être fusionnée. Pour plus d’informations, consultez « Résolution d’un conflit de fusion sur GitHub ».

Pour plus d’informations

« À propos des demandes de tirage »

« Branche » dans le glossaire GitHub

« Branches en un mot » dans la documentation Git