Préambule
Cette documentation est complémentaire à la documentation d'installation qui est à destination de l'exploitant.
...
À partir du lien ci-dessus, vous trouverez toutes les informations pour personnaliser les commandes des tutoriels ci-dessous.
Fonctionnalités indispensables
| Sommaire |
|---|
| maxLevel | 3 |
|---|
| minLevel | 3 |
|---|
| type | flat |
|---|
| separator | pipe |
|---|
|
1 - Installer GIT ?
Objectif
Installer les outils nécessaires à GitHubGit.
Commande
| Bloc de code |
|---|
|
sudo yum install git 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)
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & 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
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git clone https://github.com/EsupPortail/esup-uportal.git |
Résultat attendu
| Bloc de code |
|---|
|
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)
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git checkout -b maBranche |
Résultat attendu
| Bloc de code |
|---|
|
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
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git checkout master
ou
git checkout maBranche |
Résultat attendu
| Bloc de code |
|---|
|
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
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git add <FICHIER1> <FICHIER2>
git commit -m <MESSAGEPOURQUOIJECOMMIT> <FICHIER1> <FICHIER2> |
Résultat attendu
| Bloc de code |
|---|
|
[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)
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git pull |
Résultat attendu
| Bloc de code |
|---|
|
Already up-to-date.
ou
Les fichiers mis à jour. |
Documentation
www.siteduzero.com
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
...
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git merge master |
Résultat attendu
| Bloc de code |
|---|
|
Updating c6499c1..a82e27f
Fast-forward
README | Bin 3228 -> 3317 bytes
1 file changed, 0 insertions(+), 0 deletions(-) |
Documentation
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 8 ci-dessus | git-scm.com |
| 2 | Ajouter le remote de jasig uportal | Cloner https://github.com/Jasig/uPortal | Cf. Étape 3 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 | www.siteduzero.com - git-scm.com |
| 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 |