Publier la branche sur le dépôt distant

Votre fonctionnalité est enregistrée dans un commit local, mais vos collègues ne peuvent pas encore l’examiner depuis le dépôt partagé. Vous allez envoyer la branche dédiée au serveur et relier votre branche locale à sa copie distante. L’envoi ne modifie pas les fichiers du site et ne crée pas encore de demande de fusion.

Vérifier le point de départ

Le parcours reprend sur `feature/nouveaux-guides`, après le commit atomique qui ajoute la section « Nouveaux guides » à `index.html` et `style.css`. Comme vous l’avez vu dans la leçon sur l’état du dépôt, contrôlez que vous êtes sur la bonne branche et que le dépôt ne contient pas de modifications locales non enregistrées. Publier une branche avec des changements en cours peut rendre moins clair ce que l’équipe est appelée à examiner.

git status --short --branch

## feature/nouveaux-guides

Cette sortie indique que la branche courante est `feature/nouveaux-guides` et qu’aucune modification de fichier n’est signalée. La ligne ne dit pas encore que cette branche est publiée : le dépôt local et le dépôt distant sont deux emplacements distincts. Dans les commandes suivantes, `origin` désigne le dépôt distant configuré sous ce nom dans votre dépôt.

Publier la branche et activer son suivi

Pour le premier envoi, indiquez à Git le dépôt distant et le nom de la branche à publier. L’option `-u`, équivalente à `--set-upstream`, associe ensuite votre branche locale à la branche distante correspondante : cette relation est appelée branche de suivi. Elle permet à Git de savoir avec quelle branche distante comparer et synchroniser votre travail par la suite.

git push -u origin feature/nouveaux-guides

Branch 'feature/nouveaux-guides' set up to track remote branch 'feature/nouveaux-guides' from 'origin'.

Git envoie les commits de votre branche locale au dépôt nommé `origin`, où une branche distante `feature/nouveaux-guides` devient disponible. Le message confirme également que le suivi est configuré. Le contenu exact de la sortie peut varier selon le serveur et le protocole utilisés ; retenez que l’envoi et l’association sont confirmés.

Vérifier la publication

Après l’envoi, inspectez à nouveau l’état de votre branche. Git peut y afficher le lien avec sa branche de suivi et signaler si elles ont le même contenu ou si l’une possède des commits que l’autre n’a pas.

git status --short --branch

## feature/nouveaux-guides...origin/feature/nouveaux-guides

La partie `...origin/feature/nouveaux-guides` indique que votre branche locale suit la branche distante de même nom. Si aucun compteur de commits en avance ou en retard n’apparaît, elles sont synchronisées au moment de cette vérification. Vous pouvez aussi consulter les branches locales et distantes avec `git branch -vv` ; l’astérisque marque la branche courante et la sortie indique sa relation de suivi.

git branch -vv

* feature/nouveaux-guides 1a2b3c4 [origin/feature/nouveaux-guides] Ajoute la section Nouveaux guides

Le hash et le texte du commit ci-dessus illustrent une sortie possible ; ils varient selon votre dépôt. Une branche publiée permet à l’équipe d’accéder au travail, mais l’envoi ne soumet pas automatiquement le changement à une revue et ne l’intègre pas à `main`. La prochaine étape consistera à préparer une demande de fusion exploitable à partir de cette branche.

À retenir

• Contrôlez que vous êtes sur `feature/nouveaux-guides` et que vos fichiers sont dans l’état attendu avant l’envoi.
• Publiez la branche pour la première fois avec `git push -u origin feature/nouveaux-guides`.
• L’option `-u` relie la branche locale à `origin/feature/nouveaux-guides` pour les synchronisations suivantes.
• La publication rend les commits accessibles à l’équipe ; elle ne crée pas et ne valide pas une demande de fusion.