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
# | Sujet | Objectif | Commande | Résultat attendu | Documentation |
---|---|---|---|---|---|
1 | Installer GIT | Installer les outils nécessaires à GitHub |
| www.siteduzero.com - git-scm.com | |
2 | Régler le proxy | Permettre la communication avec GitHub.com |
| https://gist.github.com/336211 | |
3 | Cloner (i.e. télécharger sur son poste) le GIT Esup-Portail officiel pour récupérer l'avant dernier tag | Préparer le déploiement de la nouvelle version dans son établissement |
| Quelque chose comme : | |
4 | Faire une branche pour son établissement | Conserver les personnalisations inhérentes à son établissement |
| Switched to a new branch 'maBranche' | |
5 | Passer d'une branche à une autre | Changer de configuration |
| Switched to branch 'master' | |
6 | Faire des configurations et les commiter dans sa branche (commit local, pas sur le serveur) | Sauvegarder les modifications de configurations effectuées |
| [maBranche a82e27f] MESSAGEPOURQUOIJECOMMIT | |
7 | Mettre à jour la dernière version du portail | Mettre à jour le master en vue de la mise à jour de la branche |
| Already up-to-date. (Si rien à mettre à jour) | www.siteduzero.com |
8 | Faire un merge sur le dernier tag EsupPortail (montée de version sans conflit) | Conserver la configuration malgré la montée de version |
| 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 |