Préambule
Cette documentation est complémentaire à la documentation d'installation qui est à destination de l'exploitant.
...
| Astuce |
|---|
|
Jasig décrit ici les bonnes pratiques d'utilisation de Git. On y trouve notamment le worklow à suivre pour faire une PR via un fork plutôt que sur le master. |
Débutant :
| Sommaire |
|---|
| maxLevel | 3 |
|---|
| minLevel | 3 |
|---|
| include | 1 - .*|2 - .*|3 - .*|4 - .*|5 - .*|6 - .*|7 - .*|8 - .* |
|---|
| type | flat |
|---|
| separator | pipe |
|---|
|
Débutant ++ :
| Sommaire |
|---|
| maxLevel | 3 |
|---|
| minLevel | 3 |
|---|
| include | 9 - .*|10 - .*|11 - .*|12 - .*|13 - .*|14 - .* |
|---|
| type | flat |
|---|
| separator | pipe |
|---|
|
1 - Installer GIT ?
Objectif
Installer les outils nécessaires à Git.
Commande
| Bloc de code |
|---|
|
sudo yum install git gitk gitg |
...
http://windows.github.com/ (Windows)
Résultat attendu
Application cliente installée.
Documentation
www.siteduzero.com - git-scm.com
2 - Régler le proxy (si nécessaire) ?
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 |
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git tag |
...
| Bloc de code |
|---|
|
Note: checking out 'uportal-4.0.8-esup-0-avant-presta-1'.
You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.
If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:
git checkout -b new_branch_name
HEAD is now at 7b39fed... README -> README-JASIG ; README.esup -> README |
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 ent-monuniv |
Résultat attendu
| Bloc de code |
|---|
|
Switched to a new branch 'ent-monuniv' |
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 ent-monuniv |
Résultat attendu
| Bloc de code |
|---|
|
Switched to branch 'master'
Switched to branch 'ent-monuniv' |
Documentation
www.siteduzero.com - git-scm.com
6 - Commiter des configurations dans sa branche ?Objectif
Effectuer une modification, sauvegarder (en local, pas sur le serveur) les modifications de configurations effectuées.
Exemple avec une modification du fichier esup.properties :
Commandes
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git add <Path>/filters/esup.properties
git commit -m "Changement de connecteur" <Path>/filters/esup.properties |
Résultat attendu
| Bloc de code |
|---|
|
[ent-monuniv a82e27f] Changement de connecteur
1 file changed, 0 insertions(+), 0 deletions(-)
rewrite <Path>/filters/esup.properties(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. |
...
| Bloc de code |
|---|
|
Note: checking out 'uportal-4.0.8-esup-0-avant-presta-1'.
You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by performing another checkout.
If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -b with the checkout command again. Example:
git checkout -b new_branch_name
HEAD is now at 7b39fed... README -> README-JASIG ; README.esup -> README |
Documentation
www.siteduzero.com
8 - Faire un merge sur un tag EsupPortail (montée de version sans conflit) ?
Objectif
Conserver la configuration malgré la montée de version.
Commandes
Commiter les fichiers modifiés avant de faire le merge.
...
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git merge <tag> |
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
9 - Réaliser un merge en cas de conflit sur un fichier ?
Objectif
Gérer les erreurs de l'étape 8 ci-dessus.
Commandes
Éditer le fichier conflictuel avec l'éditeur associé. Repérer la section ressemblant à ceci :
...
Il faut remplacer l'ensemble de cette section (y compris <<<<<<<, ======= et >>>>>>>) par ce qui est désiré dans le fichier.
Résultat attendu
| Bloc de code |
|---|
|
...
<div id="footer">
please contact us at email.support@github.com
</div>
... |
Documentation
git-scm.com
10 - Comparer 2 branches ?
Objectif
Comparer les configurations de deux établissements.
Commandes
Consulter les tags et copier les noms des deux tags que l'on souhaite comparer :
...
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git diff tag1 tag2 |
Résultat attendu
| Bloc de code |
|---|
...
$portalBarFontSize : 100%;
$portalBarTextAlign : right;
-$portalBarTextTransform : capitalize; # ce qui est supprimé
+$portalBarTextTransform : none; # ce qui est ajouté
$portalBarLink : $c1lighter;
$portalBarLinkHover : $white;
... |
Documentation
alx.github.com - git-scm.com
11 - Consulter l'historique d'un fichier ?
Objectifs
Comparer les deux dernières configurations d'un établissement.
Voir ce qui a changé dans le dernier commit.
Commandes
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git log fichier |
Résultat attendu
| Bloc de code |
|---|
/home/sweethome/GitHub/esup-uportal [7-SGBD]> git log README
commit b332be2266b4018a677fa2439f34db8e56aef178
Author: Vincent Bonamy <vbonamy@gmail.com>
Date: Mon Jan 21 11:48:06 2013 +0100
MAJ README ESUP : esup.properties - simple renommage de propriétés de configuration lda
commit fe754564d9562ae40431507d05a6d5354265e83d
Author: Vincent Bonamy <vbonamy@gmail.com>
Date: Wed Dec 12 16:38:11 2012 +0100
Update README : git clone with read-only access
commit 7b39fedb27a656eac4a6c2b13b57e79dfa3cb80b
Author: Vincent Bonamy <vbonamy@gmail.com>
Date: Fri Dec 7 09:47:36 2012 +0100
README -> README-JASIG ; README.esup -> README
commit e999d58c61c357fdd19d5c38e7f7c75f6eaa0c4e
Author: Drew Wills <wills.drew@gmail.com>
Date: Tue Oct 2 14:35:04 2012 -0700
NOJIRA: Correct outdated info in the README |
Documentation
git-scm.com
12 - Faire un tag de la version ?
Objectif
Marquer une configuration comme fonctionnelle.
Commandes
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git tag -a v1.4 -m 'my version 1.4' |
Résultat attendu
Aucune sortie. Vérification de la création possible à l'aide de la commande tag.
Documentation
www.siteduzero.com - git-scm.com
13 - Annuler un commit fait par erreur, revenir à une version antérieure de fichier ?
Objectif
En cas de problèmes, revenir à une version fonctionnelle.
Commandes
| Bloc de code |
|---|
| language | bash |
|---|
| title | Unix & Windows |
|---|
|
git reset HEAD^ # Annule le dernier commit
git reset HEAD^^ # Annule l'avant-dernier commit
git reset HEAD~2 # Annule l'avant-dernier commit (notation équivalente)
git reset d6d98923868578a7f38dea79833b56d0326fcba1 # Annule un numéro de commit précis ; |
Résultat attendu
| Bloc de code |
|---|
Unstaged changes after reset:
M README |
Documentation
www.siteduzero.com