atlassian bitbucket tutorial
Ce didacticiel Atlassian Bitbucket 5.16 fournit une explication détaillée de certaines des fonctionnalités les plus courantes de ce référentiel de contrôle de version:
Bitbucket est une solution de référentiel de contrôle de version basée sur Git par Atlassian. Il fournit une gestion centrale du code source et collabore sur le même au sein de la communauté des développeurs.
Avec Bitbucket, il fournit des fonctionnalités pour restreindre l'accès au code source, au flux de travail du projet, à la pull request pour la révision du code et surtout son intégration avec Jira pour la traçabilité.
Ce que vous apprendrez:
- introduction
- Comment utiliser Bitbucket?
- Création de demandes d'extraction
- Référentiel Fork
- Bitbucket Markdown
- Intégration de Bitbucket avec Jira
- Supprimer le référentiel
- Conclusion
- lecture recommandée
introduction
Bitbucket est disponible en 3 options:
- Serveur Bitbucket: Pour un déploiement sur site.
- Bitbucket Cloud: Hébergé sur des serveurs Atlassian.
- Centre de données Bitbucket: Pour un déploiement à l'échelle de l'entreprise pour une haute disponibilité et de meilleures performances.
Dans cet article sur Bitbucket, nous examinerons les fonctionnalités suivantes.
Utilisation de Bitbucket
- Créer un projet.
- Créer un référentiel.
- Utiliser les commandes Git pour cloner, valider, pousser le code source, etc.
- Création de branches et fusion.
- Pull request pour la révision du code.
- Supprimer le référentiel.
- Intégrez à Jira pour maintenir la traçabilité avec les problèmes.
Comment utiliser Bitbucket?
Pour commencer avec le contrôle de version des artefacts liés au projet dans Bitbucket, nous devons créer un projet qui regroupera ensuite plusieurs référentiels Git. Ces référentiels seront ensuite travaillés par les équipes projet en fonction de l'accès.
Connectez-vous à Bitbucket en utilisant l'URL Atlassian Bitbucket et cliquez sur Projets -> Créer un projet .
Cliquer sur Créer un projet .
Le projet est créé. Ouvrez le projet et cliquez sur + pour créer un référentiel Git.
Cliquer sur Créez un référentiel. Lors de la création du référentiel, suivez les instructions pour cloner le référentiel Git sur la machine locale. Il est préférable de sauvegarder les instructions car les étapes seraient requises pour chaque développeur qui travaillerait sur le référentiel.
Suivez les instructions répertoriées pour cloner n'importe quel référentiel du projet Bitbucket sur la machine locale sur laquelle les développeurs apporteraient des modifications et s'engageraient dans le référentiel avec le push.
Une fois le référentiel cloné, ajoutez des fichiers au référentiel. Par exemple. J'ai créé un projet J2EE Maven, engagé et renvoyé le même dans le référentiel Bitbucket.
À Éditer n'importe quel fichier en ligne ouvrez le fichier et cliquez sur Éditer . Par exemple, ouvrir le dossier index.jsp et faites un changement.
Faites un changement et cliquez sur S'engager .
Entrez le message et cliquez sur S'engager.
Cliquez sur Historique pour voir toutes les modifications apportées au fichier.
Cliquez sur Diff au précédent pour comparer les changements avec la version précédente.
Création de demandes d'extraction
La plupart du temps, lorsqu'une publication est effectuée, les défauts sont signalés ou des améliorations sont suggérées pour être intégrées. Par conséquent, lorsque les développeurs se chargent de corriger des défauts ou d'intégrer des améliorations, ils doivent prendre en compte les commentaires de leurs pairs ou les faire réviser.
Ainsi, les développeurs créeraient une branche de correction de bogue pour effectuer les correctifs nécessaires et créeraient une pull request pour informer les membres de l'équipe que le défaut était corrigé et demanderaient une révision afin que les modifications puissent être fusionnées dans la branche d'intégration principale ou la branche principale.
Avant de créer une demande d'extraction, ajoutez les réviseurs par défaut aux paramètres du projet. Cliquez sur le projet et accédez aux paramètres.
Ajoutez les réviseurs par défaut à ajouter dans la demande d'extraction.
Examinons un scénario simple pour créer une Pull Request:
- Un défaut a été signalé. Le développeur crée une branche de correction de bogue pour effectuer les modifications nécessaires pour corriger le défaut et pousse les modifications dans le référentiel.
Le correction d'un bug branch est maintenant disponible dans le référentiel Bitbucket.
Avant que les modifications ne soient fusionnées dans le Maître branche, le développeur créait généralement une Pull Request pour que les modifications soient examinées. Cliquez pour créer une demande d'extraction dans la barre latérale.
Sélectionnez la branche source comme correction d'un bug. Cliquez sur Continuez.
Les réviseurs affectés sont l'utilisateur ajouté à la liste des réviseurs par défaut dans les paramètres du projet. Cliquer sur Créer.
Connectez-vous en tant qu'utilisateur auquel la révision est attribuée.
La révision attribuée est affichée dans le tableau de bord. Cliquez sur l'élément de révision et approuvez les modifications.
Ajoutez un commentaire dans la case Activité et cliquez sur Approuver
Reconnectez-vous en tant qu'utilisateur qui a créé la demande d'extraction et il pourra voir l'état de l'examen.
Cliquez sur l'élément Review et fusionnez les modifications apportées au Maître branche.
Cliquer sur Aller. Les modifications de la branche bugfix sont maintenant fusionnées avec la branche master.
Tous les développeurs peuvent ensuite exécuter une commande «git pull» pour obtenir les dernières modifications de la branche master vers leur référentiel local.
Référentiel Fork
Le référentiel Fork dans Bitbucket est un moyen de cloner l'intégralité du référentiel pour créer une nouvelle copie du référentiel. La nécessité de cela peut provenir du fait que vous souhaitez expérimenter des changements ou effectuer certains tests sur le référentiel forké sans perturber le référentiel d'origine.
Comme le référentiel d'origine peut contenir des modifications, vous pourrez également synchroniser les modifications avec le référentiel forké. Tous les accès et autorisations du référentiel d'origine sont hérités dans le référentiel forké.
Pour fork, un référentiel clique sur le Créer une option de fourche.
Cliquer sur Dépôt de fourche.
Le référentiel forké est maintenant ajouté et affiché. L'URL a également complètement changé. On peut cloner le référentiel et faire les expériences nécessaires avec ce référentiel sans perturber le contenu du référentiel d'origine.
http: // localhost: 7990 / users / niranjan / repos / hello-world-maven / parcourir
quoi utiliser pour ouvrir les fichiers xml
Toute modification apportée au référentiel d'origine sera répliquée dans le référentiel qui est forké car l'option d'activation de la synchronisation a été sélectionnée au moment de la création du référentiel, sinon une synchronisation manuelle devrait être effectuée.
Bitbucket Markdown
Tout projet doit conserver une certaine documentation pour avoir des informations sur les exigences ou sur les versions ou toute autre information liée au projet.
Par conséquent, l'équipe de projet doit s'assurer que la documentation est dans un format bien défini. Bitbucket utilise Markdown pour mettre en forme le texte en Lisezmoi.md fichier (l'extension md est requise pour utiliser cette syntaxe) ou même dans la description ou les commentaires de la demande d'extraction.
Par exemple, J'ai créé un fichier Readme.md dans le référentiel et ajouté quelques exemples de syntaxe comme indiqué.
Exemple 1: # Introduction (C'est H1)
Après avoir ajouté la syntaxe, validez les modifications dans le référentiel.
Dans Bitbucket, cela se présente comme suit:
De même ## Introduction (c'est H2)
Exemple 2: Caractères italiques - * Section 1 *
Exemple 3: Gras - ** Section 1 **
D'autres exemples de ce type peuvent être trouvés @ Guide de syntaxe Markdown
Intégration de Bitbucket avec Jira
Comme nous le savons tous, Jira est un outil pour planifier et suivre les tâches assignées aux équipes de projet. Habituellement, les équipes travaillent sur les tâches qui leur sont assignées. Donc, si vous le regardez d'un point de vue Agile, les équipes travaillent avec des problèmes tels que Epic, Story, Tasks et Bugs qui leur sont assignés dans Jira.
Maintenant que les équipes de développement utilisent Bitbucket comme référentiel de code source, elles doivent s'assurer que toutes les modifications du code source sont tracées ou liées à la tâche / bogue qui leur est assignée pour permettre la transparence du travail effectué.
Voyons donc la procédure pour intégrer Bitbucket à Jira. Connectez-vous à Bitbucket en tant qu'utilisateur administrateur et accédez au Administration -> Liens d'application. Ajoutez l'URL de Jira qui ajoutera ensuite un lien réciproque dans Jira ainsi que.
Ajoutez l'URL et cliquez sur Créer un nouveau lien . Un lien réciproque est également créé dans Jira par lequel les deux outils sont maintenant prêts à être intégrés.
Maintenant, effectuez un changement de code et validez le code, transmettez les modifications au référentiel. Lors de la validation du code, mentionnez l'ID du problème Jira dans les commentaires, comme indiqué sur la capture d'écran.
Par exemple, command - git commit –m «Page d'index modifiée DEM-2 ».
Maintenant, regardez le problème dans Jira pour voir le lien vers le changement de code dans la section Développement.
Cliquez sur l'ID de validation et vous devriez voir les modifications effectuées.
Supprimer le référentiel
Pour supprimer un référentiel Bitbucket, cliquez sur le référentiel à supprimer et allez dans le Paramètres du référentiel option.
Cliquez sur le bouton Supprimer le référentiel sur le côté droit.
Remarque : Vous devrez être un administrateur Bitbucket pour supprimer n'importe quel référentiel. Un utilisateur Bitbucket normal n'aura pas les autorisations. Un administrateur Bitbucket peut définir les autorisations utilisateur à partir de Paramètres -> Autorisations globales.
Conclusion
Dans cet article, nous avons vu certaines des fonctionnalités les plus courantes utilisées par les équipes tout en travaillant sur un référentiel de contrôle de version à l'aide de Bitbucket. D'après mon expérience, j'ai vu que dans la plupart des projets DevOps, Git est le référentiel populaire utilisé et Bitbucket ne fait pas exception ici.
Notre prochain article se concentrera sur l'extension du référentiel Bitbucket à utiliser dans l'outil Atlassian Bamboo pour effectuer des activités CI et CD.
Bonne lecture!!
lecture recommandée
- Contrôle de la source ou contrôle de version dans DevOps (Tutoriel vidéo Partie 2 - Bloc 2)
- Tutoriel Atlassian Bamboo: Déploiement d'applications Web Java avec le référentiel Bitbucket
- 15 meilleurs logiciels de contrôle de version (outils de gestion de code source)
- Qu'est-ce que la surveillance des tests et le contrôle des tests?
- Instructions de contrôle Python (Python Continue, Break et Pass)
- Liste d'adresses IP de routeur par défaut pour les marques de routeurs sans fil courantes
- Travailler avec des variables Unix: fonctionnalités du script shell
- 4 autres fonctionnalités essentielles de l'outil ultime de gestion des tests