Préambule
Cette documentation est complémentaire à la documentation d'installation qui est à destination de l'exploitant.
Elle permet d'installer, configurer, versionner et mettre à jour le package ESUP au travers de GIT.
Deux tutoriels très détaillés et en Français (www.siteduzero.com et git-scm.com) sont utilisés dans la présente page. Des liens plus précis sont cependant listés.
Voici le lien du projet : https://github.com/EsupPortail/esup-uportal
À partir du lien ci-dessus, vous trouverez toutes les informations pour personnaliser les commandes des tutoriels ci-dessous.
Fonctionnalités indispensables
1°) Installer GIT
Objectif
Installer les outils nécessaires à GitHub.
Commande
CentOs
sudo yum install git gitk
Debian
sudo apt-get install git-core gitk
http://windows.github.com/ (Windows)
Résultat attendu
Documentation
2°) Régler le proxy
Objectif
Permettre la communication avec GitHub.com.
Commande
Exécuter Git Shell (Windows)
Unix & Windows
git config --global http.proxy http://<LOGIN>:<PASSWORD>@<PROXYADDRESS>:<PORT>
Résultat attendu
Documentation
3°) Cloner
Cloner : télécharger sur son poste
Objectif
Préparer le déploiement de la nouvelle version dans son établissement en récupérant l'avant dernier tag.
Commande
Unix & Windows
git clone https://github.com/EsupPortail/esup-uportal.git
Résultat attendu
Documentation
4°) Faire une branche
Objectif
Conserver les personnalisations inhérentes à son établissement.
Commande
Se placer dans le répertoire du projet (Master)
Unix & Windows
git checkout -b maBranche
Résultat attendu
Documentation
5°) Passer d'une branche à une autre
Objectif
Changer de configuration.
Commandes
Unix & Windows
git checkout master ou git checkout maBranche
Résultat attendu
Documentation
6°) Commiter des configurations dans sa branche
Objectif
Sauvegarder (en local, pas sur le serveur) les modifications de configurations effectuées.
Commandes
Unix & Windows
git add <FICHIER1> <FICHIER2> git commit -m <MESSAGEPOURQUOIJECOMMIT> <FICHIER1> <FICHIER2>
Résultat attendu
Documentation
7°) Mettre à jour la dernière version du portail
Objectif
Mettre à jour le master en vue de la mise à jour de la branche.
Commande
Se placer dans le répertoire du projet (Master)
Unix & Windows
git pull
Résultat attendu
Documentation
8°) Faire un merge sur le dernier tag EsupPortail (montée de version sans conflit)
Objectif
Conserver la configuration malgré la montée de version.
Commandes
Se placer dans la branche que l'on souhaite mettre à jour
Unix & Windows
git checkout maBranche
Récupérer les modifications du dernier tag EsupPortail
Unix & Windows
git merge master
Résultat attendu
Documentation
| # | Sujet | Objectif | Commande | Résultat attendu | Documentation |
|---|---|---|---|---|---|
| 1 | www.siteduzero.com - git-scm.com | ||||
| 2 | https://gist.github.com/336211 | ||||
| 3 |
| Quelque chose comme : | |||
| 4 | Switched to a new branch 'maBranche' | ||||
| 5 | Switched to branch 'master' | ||||
| 6 | [maBranche a82e27f] MESSAGEPOURQUOIJECOMMIT | ||||
| 7 | Already up-to-date. (Si rien à mettre à jour) | www.siteduzero.com | |||
| 8 | Updating c6499c1..a82e27f | www.siteduzero.com |
Fonctionnalités avancées
| # | Sujet | Objectif | Documentation |
|---|---|---|---|
| 1 | Réaliser un merge en cas de conflit sur un fichier | Gérer les erreurs de l'étape 5 ci-dessus | git-scm.com |
| 2 | Ajouter le remote de jasig uportal | Cloner https://github.com/Jasig/uPortal | Cf. Étape 2 ci-dessus |
| 3 | Comparer 2 branches | Comparer les configurations de deux établissements | alx.github.com - git-scm.com |
| 4 | Consulter l'historique d'un fichier | Comparer les deux dernières configurations d'un établissement. Voir ce qui a changé dans le dernier commit | git-scm.com |
| 5 | Faire un tag de la version | Marquer une configuration comme fonctionnelle | |
| 6 | Annuler un commit fait par erreur, revenir à une version antérieure de fichier | En cas de problèmes, revenir à une version fonctionnelle | www.siteduzero.com |