Dans cet article, nous allons vous expliquer en détail comment utiliser git-scm via github, afin de libérer vos compétences en matière de développement sur notre réseau sans aucune friction.

TL;DR : si vous maîtrisez déjà git, allez à Comment utiliser git dans mon flux de travail ? une approche très rapide de cet article sans explication.

LA RÈGLE 1

Nous n'avons qu'une seule règle pour nous faciliter la vie (la vôtre et la nôtre).

Règle 1 : Vous ne poussez jamais sur la branche principale.

Tant que vous suivez cette règle, nous serons tous heureux.

Comment démarrer un projet

Pour démarrer un projet versionné avec le programme git-scm, plusieurs options sont disponibles git init ou clone git.

Chez Maras IT, nous commencerons par le clone git qui nous permet de récupérer l'historique de la branche principale (AKA the production env) de nos projets.

FYI : Pour nos exemples, nous utiliserons la commande linux.

Clonez le dépôt

Une fois que vous avez défini l'emplacement de votre projet, disons que tous vos projets sont stockés localement dans le répertoire ~/espace de travailpuis vous pouvez cloner votre projet que nous appellerons repo pour le bien de cet article.

Vous avez 2 possibilités :

si vous voulez créer le répertoire d'abord et ensuite cloner votre repo à l'intérieur de celui-ci :

# dans ~/workspace
mkdir repo ;
cd repo ;
git clone #url# .

Ou vous pouvez faire la même chose avec 1 ligne de commande

# dans ~/workpace
git clone #url# repo

Créez votre branche

Normalement, vous devriez être dans la branche principale une fois dans le répertoire repo.

La seule chose que vous devez faire est de créer votre propre branche, disons nouvelle branche

# dans ~/workspace/repo
git checkout -b nouvelle branche

ATTENTIONpour certains de nos clients, le nom de la branche est prédéfini par un problème configuré dans le repo.
Le client pourrait vous demander de créer votre branche comme ceci git checkout -b #XX-nom-de-la-tâche

Poussez vos modifications

Après avoir réalisé un développement génial, il est temps de soumettre vos modifications à un examen.

Vous pouvez d'abord vérifier le statut de vos modifications en utilisant git status

Ensuite, mettez en scène vos fichiers (en indiquant à git-scm de s'occuper des fichiers ajoutés) avec git add filename1.ext [...] filename99.ext ou les ajouter tous en même temps avec git add --all

Après avoir mis en place vos fichiers, vous devrez les livrer (les enregistrer dans l'historique) avec git commit -m "mon message pour ce commit"

ATTENTION: tous les commits ont besoin d'un message et ce message doit définir le but du commit.
Donc, n'écrivez pas "Mise à jour" mais "Mettre à jour le plugin pour ajouter la fonctionnalité" OU "Hotfix, problèmes de css", etc...

Vous pouvez maintenant voir votre propre commit dans le journal avec journal git

Enfin, vous devrez pousser vos modifications vers le repo de votre branche en utilisant git push origin newbranch

Vous avez maintenant terminé votre travail et vous avez besoin que le client valide votre livraison, vous pouvez envoyer un email à votre client pour lui faire savoir qu'il peut tester votre branche. Veillez à indiquer l'URL de votre branche dans l'e-mail, par exemple https://github.com/marasit/p-marasitcomwww/tree/newbranch.

Concernant la production, celle-ci est directement gérée par notre service et déclenchée directement par le client, vous n'avez rien à faire sur ce sujet.

Nous espérons que cet article vous aidera à suivre un flux de développement agréable et facile au sein de notre réseau, vous pouvez lire notre processus de cycle de développement qui clarifiera exactement ce que nous attendons de vous :).