Découvrez comment annuler des changements dans Git à l'aide de Bitbucket Cloud

Au fur et à mesure de votre avancement dans le tutoriel, vous découvrirez plusieurs autres commandes Git en apprenant à annuler des changements. C'est parti !

Commençons par créer un dépôt unique, qui comprend l'ensemble du code du dépôt d'origine. Ce processus est appelé « forker un dépôt ». Le fork est un processus Git étendu qui est possible lorsqu'un dépôt partagé est hébergé à l'aide d'un service d'hébergement tiers, comme Bitbucket.

1. Cliquez sur l'URL suivante ou saisissez-la : https://bitbucket.org/atlassian/tutorial-documentation-tests/commits/all

Cliquez sur le symbole + dans la barre latérale gauche, puis sélectionnez Fork this repository (Forker ce dépôt), passez en revue la boîte de dialogue, puis cliquez sur Fork repository (Forker le dépôt).

3. Vous devriez être redirigé vers l'aperçu du nouveau dépôt.

4. Cliquez sur le symbole + et sélectionnez Clone this repository (Cloner ce dépôt).

5. Sur votre ordinateur, clonez le dépôt.

6. Accédez au répertoire contenant le dépôt cloné.

Maintenant que vous disposez d'un dépôt rempli de code et d'un historique existant sur votre système local, vous êtes prêt à commencer à annuler certains changements.

Vous devrez être capable de trouver et de référencer le changement que vous voulez annuler. Pour ce faire, vous pouvez parcourir l'interface utilisateur de commit sur Bitbucket. Par ailleurs, il existe quelques utilitaires de ligne de commande capables de localiser un changement spécifique.

Vous devrez être capable de trouver et de référencer le changement que vous voulez annuler. Pour ce faire, vous pouvez parcourir l'interface utilisateur de commit sur Bitbucket. Par ailleurs, il existe quelques utilitaires de ligne de commande capables de localiser un changement spécifique.

La sortie de git status ci-dessus nous montre que tout est à jour avec la branche principale à distance et qu'aucun changement n'est en attente de commit. Dans l'exemple suivant, nous allons effectuer quelques éditions dans le dépôt, et l'examiner à l'état « Changements en attente ». Cela signifie que le dépôt sur votre système local contient des changements de fichiers que vous n'avez pas préparés (ou stagés) pour les ajouter à l'historique du projet.

Pour illustrer l'exemple suivant, ouvrez d'abord le fichier myquote2.html. Apportez certains changements au contenu de myquote2.html, enregistrez, puis quittez le fichier. Exécutons à nouveau git status pour examiner le dépôt à cet état.

La sortie ci-dessus montre que des changements sont en attente dans le dépôt pour myquote2.html. Bonne nouvelle ! Si le changement que vous voulez annuler n'a pas encore été ajouté à la zone de staging, comme dans l'exemple ci-dessus, vous pouvez simplement modifier le fichier et continuer. Git ne commence à suivre un changement que lorsque vous l'ajoutez à la zone de staging et que vous le commitez dans l'historique du projet.

Annulons à présent les changements que nous avons apportés à myquote2.html. Comme il s'agit d'un exemple simplifié avec des changements minimaux, nous disposons de deux méthodes pour annuler les changements. Si nous exécutons git checkout myquote2.html, le dépôt restaurera myquote2.html à la version précédemment commitée. Nous pouvons également exécuter git reset --hard pour restaurer tout le dépôt à l'état du dernier commit.

La commande git log vous permet de lister l'historique du projet, de le filtrer et de rechercher des changements spécifiques. Alors que git status vous permet d'inspecter le répertoire de travail et la zone de staging, git log affiche uniquement l'historique commité.

Vous retrouverez cette entrée de journal de l'historique des commits dans l'interface utilisateur de Bitbucket en accédant à la vue « commits » d'un dépôt. La vue « commits » de notre dépôt de démo se trouve à l'adresse suivante : https://bitbucket.org/dans9190/tutorial-documentation-tests/commits/all. Cette vue affiche une sortie similaire à celle de l'utilitaire de ligne de commande git log. Elle peut être utilisée pour trouver et identifier un commit à annuler.

Dans l'exemple suivant, vous pouvez voir plusieurs choses dans l'historique, mais chaque changement est, à la base, un commit. C'est donc ce que nous devons trouver et annuler.

Examinons d'un peu plus près l'un des commits de la liste :

Ce que vous pouvez voir, c'est que chaque message de commit comporte quatre éléments :

Il est très probable que le changement que vous souhaitez annuler remonte à un certain temps dans l'historique du projet, et ce dernier peut-être volumineux. Nous allons donc vous montrer quelques opérations de base utilisant git log pour trouver un changement spécifique.

1. Accédez à votre fenêtre de terminal et naviguez jusqu'au niveau supérieur de votre dépôt local en utilisant la commande cd (changer de répertoire).

Saisissez la commande git log --oneline. Ajouter --oneline affichera chaque commit sur une seule ligne, ce qui vous permet de voir plus d'historique sur votre terminal.

Appuyez sur la touche q pour quitter le journal de commit et revenir à votre invite de commande à tout moment.

Vous devriez voir quelque chose comme ça :

2. Appuyez sur la touche q pour revenir à votre invite de commande à tout moment.

3. Trouvez le commit portant l'empreinte c5826da et more changes dans la liste générée par la commande git log. Quelqu'un n'a pas écrit de message de commit descriptif, nous devrons donc déterminer si ce message contient les changements dont nous avons besoin.

4. Mettez en surbrillance l'empreinte du commit c5826da et copiez-la depuis la sortie de git log dans votre fenêtre de terminal.

5. Saisissez git show, puis collez ou transcrivez l'empreinte de commit copiée et appuyez sur Entrée. Vous devriez voir un résultat similaire à celui-ci :

L'invite en bas continue à se remplir jusqu'à indiquer le changement complet. Appuyez sur q pour quitter votre invite de commande.

C'était un bref coup de projecteur sur la commande git log. Si vous aimez utiliser cette commande, vous apprécierez sans doute le tutoriel avancé sur git log.

1. Saisissez git log --oneline dans votre fenêtre de terminal.

2. Copiez l'empreinte de commit pour le second commit dans log: 52f823c, puis appuyez sur q pour quitter le journal.

3. Saisissez git reset --soft 52f823c dans votre fenêtre de terminal. En cas de réussite, la commande devrait s'exécuter en arrière-plan. Et voilà, vous venez d'annuler votre premier changement. Voyons maintenant le résultat de cette action.

4. Saisissez git status dans votre fenêtre de terminal, et vous verrez que le commit a été annulé et qu'il apparaît maintenant comme un changement non commité. Le résultat devrait ressembler à ce qui suit :

5. Saisissez git log --oneline dans votre fenêtre de terminal. Vous devriez voir un résultat similaire à celui-ci :

6. Vous pouvez voir que la nouvelle réf HEAD de la branche est le commit 52f823c, exactement ce que vous vouliez.

7. Appuyez sur q pour quitter le journal. Laissez votre terminal ouvert, car maintenant que vous avez appris à exécuter une simple commande reset, nous allons essayer quelque chose d'un petit peu plus complexe.

1. Saisissez git log --online

2. Copiez l'empreinte du commit 1a6a403 (myquote édité en ligne avec Bitbucket), le commit juste sous la pull request 6, qui contient les changements que nous voulons annuler.

3. Saisissez git reset 1a6a403 dans votre fenêtre de terminal. La sortie devrait ressembler à ce qui suit :

Vous pouvez voir que les changements sont maintenant à un état non commité. Cela signifie que nous avons maintenant supprimé plusieurs changements à la fois de l'historique du projet et de la zone de staging.

4. Saisissez git status dans votre fenêtre de terminal. La sortie devrait ressembler à ce qui suit :

À présent, vous pouvez voir que le premier changement que nous avons annulé (le fichier bitbucket-pipelines.yml) n'est plus suivi par Git. En effet, l'appel de la commande git reset supprime le changement de la réf HEAD de la branche et de la zone de suivi ou d'indexation de Git. Le processus sous-jacent est un peu plus complexe que ce que nous pouvons couvrir ici, vous pourrez en découvrir plus dans git reset.

5. Saisissez git log --oneline dans votre fenêtre de terminal.

La sortie du journal montre maintenant que l'historique du commit a également été modifié et démarre au commit 1a6a403. À des fins d'illustration et pour donner un exemple supplémentaire, disons que nous voulons maintenant annuler le reset que nous venons de faire. Après mûre réflexion, nous voulions peut-être conserver le contenu de la pull request 6.

La commande git reset est l'une des rares méthodes d'« annulation » proposées par Git. Les resets sont généralement considérés comme une option « peu sûre » pour annuler les changements. Ils sont acceptables lorsque l'on travaille en local, dans un code isolé, mais deviennent dangereux lorsqu'ils sont partagés avec les membres de l'équipe.

Pour partager une branche qui a été réinitialisée auprès d'une équipe distante, il faut effectuer un « push forcé ». Un « push forcé » est initié par l'exécution de la commande git push -f. Un « push forcé » détruit tout l'historique développé sur la branche après le push.

Voici un exemple de ce scénario « dangereux » :

• Le développeur A développe une nouvelle fonctionnalité sur une branche.
• Le développeur B développe une fonctionnalité distincte sur la même branche.
• Le développeur B décide de réinitialiser la branche à un état antérieur au début du travail des développeurs A et B.
• Le développeur B fait alors un push forcé de la branche reset vers le dépôt distant.
• Le développeur A fait un pull de la branche pour obtenir les mises à jour. Pendant ce pull, le développeur A reçoit la mise à jour forcée. Cela réinitialise la branche locale du développeur A à un état précédent tout travail sur les fonctionnalités et lui fait perdre ses commits.

La sortie de git reflog devrait être similaire à ce qui précède. Vous pouvez voir l'historique des actions dans le dépôt. La ligne du haut fait référence au reset que nous avons effectué pour réinitialiser la pull request 6. Réinitialisons maintenant le reset pour rétablir la pull request 6. La deuxième colonne de cette sortie de reflog indique un pointeur de réf vers un changement effectué dans le dépôt. Ici, HEAD@{0} est une référence à la commande reset que nous avons exécutée précédemment. Nous ne voulons pas donner suite à cette commande reset, nous allons donc restaurer le dépôt à la réf HEAD@{1}.

À présent, examinons l'historique de commit des dépôts en exécutant git log --oneline :

La sortie du journal montre maintenant que l'historique du commit a également été modifié et démarre au commit 1a6a403. À des fins d'illustration et pour donner un exemple supplémentaire, disons que nous voulons maintenant annuler le reset que nous venons de faire. Après mûre réflexion, nous voulions peut-être conserver le contenu de la pull request 6.

Pour cet exemple, choisissons le commit le plus récent, 1f08a70. Pour ce scénario, disons que nous voulons annuler les éditions apportées dans ce commit. Exécutez :

Cela va lancer un workflow git merge. Git crée alors un commit dont le contenu est l'inverse de celui qui a été spécifié pour le revert. Git ouvre ensuite un éditeur de texte configuré pour demander un nouveau message de commit. Les reverts sont considérés comme l'option d'annulation la plus sûre en raison de ce workflow de commit. La création de commits de revert laisse une trace claire dans l'historique du commit du moment où une opération d'annulation a été exécutée.

Félicitations, vous avez terminé ! Revenez à ce tutoriel à tout moment ou rendez-vous dans la section « Annuler des changements » pour approfondir vos connaissances. Bonne continuation dans Bitbucket !