Un code plus performant grâce à Bitbucket : quatre étapes pour vous lancer

Avant de commencer, vous aurez besoin d'un compte Bitbucket Cloud pour suivre vous-même ce tutoriel. Ce guide vous donnera un aperçu des parties de Bitbucket que vous utiliserez beaucoup. Vous devriez donc également avoir installé Git et être familiarisé avec les commandes Git de base et le fonctionnement de Git.

Vous débutez dans Git ? Pas de soucis, nous avons ce qu'il vous faut. Lisez nos tutoriels « Getting Git Right » pour une introduction à Git.


Et maintenant, place à l'action.

Étape 1 : Enregistrez votre code dans Bitbucket

Dans Bitbucket, le code réside dans des dépôts (également appelés « répos », de l'anglais repository, dans le jargon). Selon vos besoins, vous pouvez vous lancer de plusieurs façons :

Créer un dépôt vide

  1. Cliquez sur + dans la barre latérale globale sur la gauche, puis, sous Create new (Créer), sélectionnez Repository (Dépôt).
  2. Donnez un nom au dépôt. C'est important ! Le nom d'un dépôt sera inclus dans son URL.
  3. Définissez l'option Include a README? (Inclure un fichier README ?) sur Yes, with a template (Oui, avec un modèle).
  4. Vous pouvez conserver les autres valeurs par défaut et cliquer sur Create (Créer).
Créer un dépôt

Importer un dépôt d'un autre fournisseur Git

  1. Cliquez sur + dans la barre latérale globale sur la gauche, puis, sous Import (Importer), sélectionnez Repository (Dépôt).
  2. Fournissez l'URL d'accès au dépôt.

  3. Si votre dépôt nécessite une autorisation, cochez Requires authorization (Nécessite une autorisation) et fournissez des justificatifs d'accès.

  4. Donnez un nom au dépôt. C'est important ! Le nom d'un dépôt sera inclus dans son URL.

  5. Vous pouvez conserver les autres valeurs par défaut et cliquer sur Import repository (Importer le dépôt).

Créer un dépôt

Étape 2 : Configurez en local, collaborez dans le monde entier

Votre dépôt se trouvant dans le cloud, vous devez maintenant configurer votre système local pour contribuer ou modifier le code se trouvant dans Bitbucket. Cette étape requiert une installation et une configuration préalable de Git. Si vous avez ignoré cette étape, vous devez donc revenir en arrière et le faire maintenant. N'oubliez pas que nous avons un guide complet séparé pour vous aider dans cette tâche !

Cloner un dépôt Bitbucket

Une fois créé (ou importé), pour collaborer aux changements de code dans un dépôt Bitbucket, vous devez d'abord cloner le dépôt sur votre système local. En savoir plus sur le clonage dans Git.

  1. Cliquez sur + dans la barre latérale globale sur la gauche, puis, sous Get to work (Se mettre au travail), sélectionnez Clone this repository (Cloner ce dépôt).
  2. Sélectionnez HTTPS dans le menu en haut à droite (sauf si vous avez déjà configuré vos clés SSH).
  3. Copiez la commande de clonage.
Cloner ce dépôt

Depuis votre interface de ligne de commande (CLI)

  1. Accédez au répertoire local dans lequel vous souhaitez cloner votre dépôt cd .
  1. Collez la commande copiée depuis Bitbucket (le résultat devrait ressembler à ce qui suit) : git clone https://username@bitbucket.org/teamsinspace/documentation-test.git.

Un nouveau sous-répertoire apparaît sur votre disque local et porte le même nom que le dépôt que vous avez cloné. Si vous avez cloné un dépôt vide, il se peut qu'il n'y ait encore rien dans ce répertoire local.

Apporter des changements à un fichier dans Bitbucket en ligne

Au cours d'une journée type, si vous êtes développeur, vous travaillez sur votre code en local et enregistrez vos changements lorsque vous avez terminé. Ensuite, vous ajoutez les changements, vous les commitez et vous en faites un push dans Bitbucket à partir de l'interface de ligne de commande. En savoir plus sur la commande git push.

Supposons que votre collègue a apporté des changements très importants aux fichiers dont vous avez fait un push à l'étape précédente. Pour ce faire, accédez au dépôt dans Bitbucket et cliquez sur l'un des fichiers dont vous avez fait un push. Si vous suivez le processus, vous devriez avoir un fichier README dans ce dépôt.

Pour modifier ce fichier en ligne, procédez comme suit :

  1. Accédez au dépôt.
  2. Cliquez sur le nom de fichier.
  3. Cliquez sur Edit (Modifier).
  4. Apportez un changement.
  5. Cliquez sur Commit (Commiter).

Bitbucket contient maintenant des changements dont vous devez faire un pull vers votre système local.

Minute, je n'ai aucun fichier dans Bitbucket…

Vous avez ignoré l'étape facultative pour ajouter un fichier README à votre dépôt Bitbucket ? Pas de problème ! Si le dépôt est toujours vide, accédez-y et créez-en un maintenant en cliquant sur Create a README (Créer un fichier README). Vous disposez à présent d'un dépôt non vide à cloner.

Faire un pull des mises à jour depuis Bitbucket

Lorsque vous collaborez autour du code, vous devez régulièrement récupérer les changements apportés par un membre de l'équipe pour mettre à jour votre dépôt local. Vous avez ainsi la certitude de toujours travailler sur la version la plus récente de votre code. En savoir plus sur la commande git pull.

Depuis votre interface de ligne de commande (CLI)

  1. Accédez au répertoire local dans lequel vous souhaitez cloner votre dépôt cd .
  1. Collez la commande copiée depuis Bitbucket (le résultat devrait ressembler à ce qui suit) : git clone.

Vous avez maintenant téléchargé tous les changements apportés à ces fichiers sur votre système local.

Étape 3 : Les branches dans Bitbucket, notions fondamentales

Grâce aux branches, chaque membre de l'équipe peut travailler simultanément sur différentes choses sans affecter la base de code d'origine ou le travail des autres. Lorsque vous êtes prêt à merger les changements, vous faites un push de votre branche vers Bitbucket afin qu'elle puisse être revue dans une pull request.

Il existe plusieurs façons de créer des branches, alors choisissez celle qui convient le mieux aux besoins de votre équipe.

Créer une branche

  1. Depuis le dépôt, cliquez sur + dans la barre latérale globale, puis, sous Get to work (Se mettre au travail), sélectionnez Create a branch (Créer une branche).
  2. Dans la fenêtre contextuelle qui s'affiche, sélectionnez un type (si vous utilisez le modèle de branching), saisissez un nom de branche, puis cliquez sur Create (Créer).
Créez une branche

Depuis votre interface de ligne de commande (CLI)

  1. Une fois créée, faites un fetch et un check-out de la branche dans votre système local. Bitbucket vous montrera automatiquement la commande nécessaire, et elle ressemblera à ceci : git fetch && git checkout .
  2. Faites vos changements en local, puis ajoutez vos changements, commitez-les et faites-en un push dans la branche : git add. git commit -m "adding a change from the feature branch" git push origin
  3. Cliquez sur la page Source de votre dépôt. Vous devriez voir à la fois la branche master et dans la liste déroulante.
Filtrer les branches

Depuis l'interface de ligne de commande, dans votre répertoire de dépôts local

  1. Créez une branche à l'aide de la commande Git prévue à cet effet. git branch
  2. Répertoriez les branches de ce dépôt. Vous verrez la branche principale par défaut et la branche que vous venez de créer. git branch
  3. Faites un check-out de la branche. git checkout .

  4. Faites un push de la nouvelle branche vers Bitbucket. git push --set-upstream origin

Accédons maintenant à Bitbucket pour voir notre branche.

  1. Accédez à votre dépôt.

  2. Cliquez sur Branches.

Filtrer les branches

Pour cela, vous devez avoir accès à Jira Software Cloud et l'avoir intégré à Bitbucket. Vous aurez besoin des autorisations administrateur pour ce faire, mais si vous voulez juste vous entraîner avec l'intégration pour voir comment elle fonctionne, vous pouvez toujours vous inscrire afin de bénéficier d'un essai gratuit de Jira Software Cloud.

Pour obtenir des instructions sur l'intégration des deux produits une fois votre site Jira mis en place, lisez notre page Connecter Bitbucket Cloud à Jira Software Cloud (en anglais).

Étape 4 : Révisez les changements de code grâce à une pull request

Une fois vos changements apportés au code pushés dans Bitbucket, le moment est venu de les faire réviser par un collègue. Les pull requests constituent une méthode simple et efficace pour faire réviser votre code et collaborer dans un environnement partagé avec votre équipe.

Création d'une pull request

  1. Depuis le dépôt ouvert, cliquez sur + dans la barre latérale globale et sélectionnez Create a pull request (Créer une pull request) sous Get to work (Se mettre au travail).
  2. Complétez le reste du formulaire de pull request :
Création d'une pull request
  1. Source : le dépôt et la branche dans lesquels vous avez apporté des changements de code à merger.
  2. Cible : le dépôt et la branche dans lesquels vous souhaitez merger vos changements.
  3. Titre et Description : vous verrez ces deux informations dans les notifications par e-mail. Le titre apparaît dans la liste des pull requests.
  4. Reviewers (Réviseurs) : choisissez les réviseurs qui vont donner leur feedback et doivent approuver les changements.
  5. Close branch (Fermer la branche) : sélectionnez cette option si vous souhaitez fermer automatiquement la branche une fois la pull request mergée.
  6. Diff et Commits : consultez ces onglets pour voir les changements apportés (Diff) ou les commits inclus.
  1. Cliquez sur Create pull request (Créer une pull request).

Vous pouvez voir cette pull request dans la liste Pull requests dans la navigation latérale de votre dépôt.

Réviser une pull request

En tant que réviseur, vous recevrez une notification indiquant que vous avez une pull request à réviser. Vous pouvez également retrouver les pull requests ouvertes dans l'onglet Pull requests de votre tableau de bord. Il existe de nombreuses façons de réviser le code pour en garantir la qualité, mais la manière dont votre équipe les applique dépend entièrement de vous. Voici quelques moyens de communiquer efficacement avec vos collègues pour vous assurer que chacun comprend les changements et les approuve avant leur merge.

Afficher la diff(érence)
Lorsque vous affichez une pull request, vous verrez les différences (changements) dans tous les fichiers modifiés dans la pull request. Les lignes en vert ont été ajoutées. Celles en rouge ont été supprimées. Vous pouvez aussi cliquer sur l'onglet Commits en haut d'une pull request pour voir les commits inclus, ce qui est utile pour passer en revue de grandes pull requests.

Donner du feedback et poser des questions en commentaires
Dans Bitbucket, vous pouvez laisser des commentaires sur une pull request entière, un fichier spécifique ou un emplacement spécifique d'un fichier. C'est pratique lorsque vous voulez donner un contexte ou une spécificité à votre feedback. Les commentaires peuvent comporter des images, des liens, du texte riche et une URL unique, ce qui vous permet de partager rapidement des commentaires spécifiques.

Approuver ou refuser une pull request
Une fois que vous avez révisé les changements de code, vous devez maintenant indiquer à l'auteur de la pull request si cette dernière est prête à être mergée. En cliquant sur le bouton Approve (Approuver), vous envoyez une notification à l'auteur de la pull request et lui indiquez que vous pensez que les changements peuvent être mergés en toute sécurité. L'inverse est vrai si vous refusez une pull request. Une fois refusée, elle ne peut plus être rouverte. Pour merger la branche, vous devrez ouvrir une autre pull request.

Remarque : refuser une pull request n'est pas bien vu par l'auteur, et devrait probablement être réservé aux changements qui sont très éloignés de l'objectif ou aux tâches qui ne sont plus nécessaires. N'oubliez pas d'être aimable en révisant le travail des autres et cherchez toujours à comprendre avant de chercher à être compris.

Merger une pull request
Une fois votre code révisé et approuvé dans une pull request, cliquez sur le bouton Merge (Merger) pour merger votre branche à la branche principale. Les changements de code introduits dans la branche source sont maintenant entièrement intégrés dans la branche cible.


Guide 2 partie 1 : Découvrez l'interface

Guide 1 : Bref aperçu de Bitbucket