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
sudo yum install git gitk
sudo apt-get install git-core gitk
http://windows.github.com/ (Windows)
Résultat attendu
Application cliente installée.
Documentation
www.siteduzero.com - git-scm.com
2 - Régler le proxy
Objectif
Permettre la communication avec GitHub.com.
Commande
Exécuter Git Shell (Windows)
git config --global http.proxy http://<LOGIN>:<PASSWORD>@<PROXYADDRESS>:<PORT>
Résultat attendu
Pas de blocage de communication de la part du proxy.
Documentation
https://gist.github.com/336211
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
git clone https://github.com/EsupPortail/esup-uportal.git
Résultat attendu
Cloning into 'esup-uportal'... remote: Counting objects: 157549, done. remote: Compressing objects: 100% (42597/42597), done. remote: Total 157549 (delta 90619), reused 155749 (delta 89147) Receiving objects: 100% (157549/157549), 129.96 MiB | 1.11 MiB/s, done. Resolving deltas: 100% (90619/90619), done. Checking out files: 100% (3263/3263), done
Documentation
www.siteduzero.com - git-scm.com
4 - Faire une branche
Objectif
Conserver les personnalisations inhérentes à son établissement.
Commande
Se placer dans le répertoire du projet (Master)
git checkout -b maBranche
Résultat attendu
Switched to a new branch 'maBranche'
Documentation
www.siteduzero.com - git-scm.com
5 - Passer d'une branche à une autre
Objectif
Changer de configuration.
Commandes
git checkout master ou git checkout maBranche
Résultat attendu
Switched to branch 'master' Switched to branch 'maBranche'
Documentation
www.siteduzero.com - git-scm.com
6 - Commiter des configurations dans sa branche
Objectif
Sauvegarder (en local, pas sur le serveur) les modifications de configurations effectuées.
Commandes
git add <FICHIER1> <FICHIER2> git commit -m <MESSAGEPOURQUOIJECOMMIT> <FICHIER1> <FICHIER2>
Résultat attendu
[maBranche a82e27f] MESSAGEPOURQUOIJECOMMIT 1 file changed, 0 insertions(+), 0 deletions(-) rewrite FICHIER1 (78%)
Documentation
www.siteduzero.com - git-scm.com
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)
git pull
Résultat attendu
Already up-to-date. ou Les fichiers mis à jour.
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
git checkout maBranche
Récupérer les modifications du dernier tag EsupPortail
git merge master
Résultat attendu
Updating c6499c1..a82e27f Fast-forward README | Bin 3228 -> 3317 bytes 1 file changed, 0 insertions(+), 0 deletions(-)
Documentation
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 |