Scénario d’équipe

Contexte du scénario

Ce chapitre a pour but de montrer comment il est possible d’utiliser Git en équipe notamment grâce à GitLab, une interface web de gestion de dépôts.

Ce chapitre va couvrir de nombreux sujets sous la forme d’un scénario pour montrer dans quels cas il est utile d’effectuer certaines actions. Ce chapitre ne peut cependant pas être exhaustif concernant les cas d’utilisation de Git en entreprise, il existe de nombreuses autres situations compliquées dans la vie d’un projet.

Raphaël n’est pas uniquement indépendant, il est aussi salarié dans une entreprise qui conçoit des logiciels sur mesure pour les clients. Il est développeur dans cette entreprise et est intégré dans une équipe chargée d’un produit permettant aux clients de gérer leurs projets : Improllow. Voici les autres membres de son équipe :

Le produit qu’ils conçoivent est utilisé par des entreprises de toutes tailles. Le logiciel leur permet de gérer leurs projets avec une grande efficacité. Après l’installation du logiciel et la formation des collaborateurs, les équipes sont capables de mesurer plus facilement la durée totale d’un projet et les risques de dépassement.

Depuis le début du projet, l’équipe n’utilise aucun système de gestion de versions. En effet, les projets et les demandes de clients s’accumulant, les projets de long terme ont été retardés pendant plusieurs années. Quelques semaines et quelques réunions ont...

Aperçu du projet

Avant de se lancer dans ce chapitre, il peut être utile d’essayer le logiciel pour étudier son fonctionnement et mieux comprendre les exemples du chapitre. Pour cela, il faut installer Python et Django sur son système (en plus de Git). Cette partie du chapitre a uniquement pour but de montrer le logiciel final. Elle n’est absolument pas nécessaire à l’apprentissage de Git et le lecteur pressé peut directement passer à l’installation de GitLab.

Le projet est présent dans les éléments téléchargeables. Le dépôt se trouve dans le dossier 11/Improllow-up. Les bibliothèques jQuery et AngularJS sont déjà générées, la base de données SQLite également, ainsi qu’un utilisateur root. Il reste malgré tout à installer Python et ses dépendances, puis à lancer le serveur.

Ces étapes considèrent que Git est déjà installé sur la machine.

python -V 

Installation de GitLab

GitLab est un logiciel qui se présente sous la forme d’une interface web qui va permettre de travailler à plusieurs sur un dépôt et qui va permettre de gérer plus facilement les équipes de développeurs. GitLab présente un certain nombre d’avantages comparé à l’utilisation d’un dépôt partagé local :

L’installation de GitLab sera expliquée pour une distribution de GNU/Linux Debian 8. Pour installer GitLab, il faut tout d’abord se rendre sur la page de téléchargement du site officiel : https://about.gitlab.com/downloads/#debian8. Sur cette page, GitLab propose des instructions permettant d’installer GitLab et toutes ses dépendances.

Tout d’abord, il faut installer les dépendances de GitLab. L’installation de Postfix nécessite de valider des étapes en gardant les valeurs par défaut.

sudo apt-get install curl openssh-server ca-certificates postfix...

Création des comptes utilisateurs

Pour créer les comptes utilisateurs, il faut tout d’abord se rendre dans la page d’administration en cliquant sur l’icône en forme de clé à molette. Un lien apparaît dans le menu de gauche, ce lien représente une personne et il faut cliquer dessus pour afficher une liste d’utilisateurs. Pour l’instant, cette liste ne contient qu’un seul utilisateur : Administrator.

Cliquer sur le bouton New User permet de créer un nouvel utilisateur avec plusieurs champs à définir :

D’autres informations peuvent être fournies sur l’utilisateur comme une adresse Skype ou encore son site web.

Pour confirmer la création du compte, il faut cliquer sur le bouton Create user.

Une fois le compte créé, GitLab redirige l’administrateur vers la page de profil du compte. Sur cette page, il est possible de mettre à jour les informations de l’utilisateur en cliquant sur le bouton Edit en haut. Cette page permet également de consulter les informations de l’utilisateur et de le bloquer pour qu’il n’ait plus accès aux dépôts et à l’interface web. C’est également sur cette page qu’il faut se rendre pour supprimer le compte de l’utilisateur....

Création du projet

Pour créer un projet avec GitLab, il faut tout d’abord cliquer sur le bouton New project en haut à droite (le bouton a la forme d’une croix +). Dans ce scénario, c’est la chef de projet, Noëllie, qui va ajouter le projet.

Un formulaire s’affiche avec les champs suivants :

Lorsque le formulaire est validé, l’utilisateur est redirigé vers la page du projet avec notamment l’URL du projet comme sur la capture ci-dessous :

Au-dessous de la page, une liste d’instructions permet de définir l’utilisateur sur Git :

git config --global user.name "Noëllie"  
git config --global...

Premier commit du projet

Noëllie a demandé à Raphaël de s’occuper du premier commit qui placera le projet dans le dépôt en respectant les bonnes pratiques.

git add --all --dry-run > liste_fichiers.txt 

/improllowup/static/lib 

__pycache__/  
*.pyc 

Phase de développement

Pour la phase de développement, tous les intervenants ont cloné le dépôt sur leur machine. Ils ont également créé leur fichier improllowup/settings/local.py.

git pull --all 

* master  
  remotes/origin/HEAD -> origin/master  
  remotes/origin/develop  
  remotes/origin/master 

git checkout remotes/origin/develop  
git checkout -b develop 

python3 manage.py migrate --settings=improllowup.settings.local 

Mise en ligne du dépôt sur GitHub

Pour que les lecteurs de ce livre puissent télécharger facilement un dépôt exploitable et suivre l’évolution de ce projet, il est préférable d’héberger également ce dépôt sur GitHub. Dans un scénario plus réaliste, cette partie pourrait expliquer comment une entreprise peut libérer le code source d’un de ses projets. Cette partie va expliquer les étapes pour mettre en ligne un projet sur GitHub en tenant compte des bonnes pratiques.

1. Création d’un compte GitHub

Pour publier un dépôt sur GitHub, il faut un compte GitHub. Pour cela, il faut se rendre sur le site https://github.com et cliquer sur le lien Sign up en haut de la page. Un formulaire s’affiche alors qui demande une adresse e-mail, un mot de passe, un nom d’utilisateur, l’acceptation ou le refus de messages d’information et la validation d’une énigme :

Après avoir rempli ces informations et cliqué sur le bouton Create an account, GitHub envoie un mail de confirmation avec un code à entrer. Une fois le code recopié dans l’interface, GitHub demande ensuite la taille de l’équipe et si l’utilisateur est étudiant ou professeur :

GitHub demande alors de choisir les fonctionnalités qui seront utilisées par l’utilisateur. Dans le cas de cet exemple il faut choisir Collaborative coding, Security, Project Management. GitHub propose alors de choisir le type de compte (gratuit ou payant). L’exemple de ce chapitre se contente d’un compte gratuit.

Une fois connecté sur le compte GitHub, il est possible d’accéder à son profil en cliquant en haut à droite sur son avatar puis en cliquant sur Your Profile.