Git, Bitbucket – Utiliser SourceTree sur Bitbucket pour versionner ses projets
Il ne s’agit pas seulement de choisir un bon outil de “versioning” facile à utiliser. Non, les présupposés à notre problème sont triples :
- Vélocité : passer des commandes Git, c’est comme passer des commandes FTP, c’est passablement chronophage surtout si cela ne se fait que épisodiquement. Pourquoi faire compliqué quand on peut faire simple avec un logiciel ?.
- Opportunité d’apprentissage : Manquer cruellement de temps ou de capacités à apprendre est humain mais c’est aussi un mensonge communément admis dans le monde du travail de la “Big Company”. L’opportunité d’apprentissage n’est pas valorisé pas dans le monde du travail mais reconnaissons néanmoins que cliquer sur une icône afin que l’action se fasse est sympa !
- Coût financier et ROI : L’objectif est de trouver aussi son compte financièrement. Tout dépend des caractéristiques du projet, voici les questions auxquelles vous devez répondre afin d’arbitrer entre fonctionnalités et coût :
- Est-il possibilité de rendre public ou privé le repository ?
- Est-il possibilité de créer au moins 2 “repository” ?
- Est-il possibilité de gérer un peu plus finement les personnes ayant accès au projet ?
Conclusion : Une fois répondu à ces 3 questions, un benchmark rapide des solutions du marché s’impose, en gros Bitbucket vs Github. Notre choix s’est porté vers Bitbucket
qui est à ce jour la seule plateforme susceptible de gérer un “repository” à la fois en mode privatif et/ou public avec la possibilité de constiuer un groupe maximum de 5 personnes… tout cela gratuitement.
Plus secondaire, l’objectif était aussi de comprendre la maniement de Git en étant guidé pas à pas. Atlassian, l’opérateur de Bitbucket
pourvoit à ce besoin via une logiciel simple nommé SourceTree
. Voilà sans nul doute les raisons qui militent pour le choix de Bitbucket
en lieu est place de Github
Bitbucket
de manière très prosaïque, c’est quoi ?
La promesse du site, intéressant….
Unlimited private code repositories
free for 5 users git or mercurial lightweight code review mac and windows client
Il existe une aide contextuelle plutôt bien faite lorsque vous n’êtes pas franchement rompu(e) à l’usage de Git.
Créer un nouveau projet
1. Vous n’avez pas de projet à versionner. Notre porjet se nomme test-code-1
(1 – I’m starting from scratch)
Set up your local directory Set up Git on your machine if you haven't already. mkdir /path/to/your/project cd /path/to/your/project git init git remote add origin https://xxx@bitbucket.org/votre-nom-utilisateur-sur-Bitbucket/test-code-1.git |
Vous n’avez pas de projet à versionner. Notre projet se nomme test-code-1
(2 – Create your first file, commit, and push)
echo "mon premier text dans un .txt" >> mon-texte.txt git add mon-texte.txt git commit -m 'Mon premier commit avec contributeurs' git push -u origin master |
NDLR : Bravo, vous venez de faire un premier commit
vous pouvez soit coder soit inviter des gens qui savent le faire.
Importer un projet existant
Ah, zut, vous avez un premier projet de développement et vous voulez bien évidemment historiser.
cd /path/to/my/repo git remote add origin https://xxx@bitbucket.org/votre-nom-utilisateur-sur-Bitbucket/test-code-1.git git push -u origin --all # pushes up the repo and its refs for the first time, poussons la première pression git push -u origin --tags # pushes up any tags, poussons quelques mots-clés |
Ajouter une fichier readme
# README # This README would normally document whatever steps are necessary to get your application up and running. ### What is this repository for? ### * Quick summary * Version * [Learn Markdown](https://bitbucket.org/tutorials/markdowndemo) ### How do I get set up? ### * Summary of set up * Configuration * Dependencies * Database configuration * How to run tests * Deployment instructions ### Contribution guidelines ### * Writing tests * Code review * Other guidelines ### Who do I talk to? ### * Repo owner or admin * Other community or team contact |
Quelque images… de SourceTree
Pour illustrer notre propos, quelques images sur le maniement de SourceTree notamment la création d’un premier répertoire de code et sa suppression.
Les solutions offertes
Création d’un dépôt local
Un compte sur Stash, Github…
Un compte sur Bitbucket et un premier commit…
Les informations générales sur le premier “repository sur Bitbucket
Les informations générales sur le premier “repository sur Bitbucket
Les informations générales sur le premier “repository” sur Bitbucket
Pas de fichier readme
, toujours utile de joindre un fichier synthétique qui récapitule les informations sur un projet.
Ajout d’un second fichier
Ajout d’un second fichier – liste des fichiers
Supprimer un “Repository”
Une action toujours utile pour itérer sur un dépôt.
Aide sur comment supprimer un “Repository”
Rediriger vers un autre dépôt lors de la suppression un “Repository” avec
Supprimer définitivement un “Repository”
En savoir plus
- Code collaboration in the cloud.
https://bitbucket.org/ - SourceTree, a free Git & Mercurial client for Windows or Mac.
http://www.sourcetreeapp.com/ - La Documentation Bitbucket
https://confluence.atlassian.com/x/cgozDQ - Bitbucket for Git – Source Tree Tutorial
http://www.youtube.com/watch?v=BtEvnE79jxY