Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
atelier:git-df:git-df [27/10/2012 19:11] captnfab |
atelier:git-df:git-df [28/10/2012 17:51] paskal |
||
|---|---|---|---|
| Ligne 44: | Ligne 44: | ||
| Créer une paire de clés ssh(([[config:ssh | Configurer ssh]])). | Créer une paire de clés ssh(([[config:ssh | Configurer ssh]])). | ||
| - | <note>nom_ou_pseudo = Votre nom ou votre pseudo, sans espace ni accent et en minuscule((En principe vous avez le droit. mais notre tuto et pour éviter les erreurs, on adoptera cette convention)) !</note> | + | <note>nom_ou_pseudo = Votre nom ou votre pseudo, sans espace ni accent et en minuscule((En principe vous avez le droit mais, dans notre tuto et pour éviter les erreurs, on adoptera cette convention)) !</note> |
| <code bash>ssh-keygen -f ~/.ssh/df-git-nom_ou_pseudo</code> | <code bash>ssh-keygen -f ~/.ssh/df-git-nom_ou_pseudo</code> | ||
| Ligne 80: | Ligne 80: | ||
| ===== Cloner un projet déjà en cours ===== | ===== Cloner un projet déjà en cours ===== | ||
| + | |||
| + | <note tip>À l'intention des sombres personnes qui gisent habituellement au fond des classes près des radiateurs, précisons bien ici que git ne vous transite pas vous vers le serveur, mais transitent uniquement les données échangées entre votre pc vers le serveur git distant, et vice et versa. //Qu'on se le dise// ! :-P</note> | ||
| Se placer dans ce répertoire créé pour git : | Se placer dans ce répertoire créé pour git : | ||
| Ligne 94: | Ligne 96: | ||
| ===== Utilisation ===== | ===== Utilisation ===== | ||
| - | Avant de faire un listing des commandes, voyons un cas typique d'utilisation. | + | Si vous préférez voir un cas typique d'utilisation avant de lire la liste des commandes, le TP1 s'y prête bien : |
| + | * [[manuel:git-df:TP_basique|TP 1 : Exemple d'utilisation basique]] | ||
| - | [[TP_basique|TP 1 : Exemple d'utilisation basique]] | ||
| - | ==== Exemple d'utilisation basique ==== | + | ==== Liste des commandes ==== |
| - | Deux utilisateurs fictifs, //jojo// et //cap// ont clonés un dépôt git ''bac-a-sable'' dans le dossier ''~/df-git/''. Voici un transcript de ce qu'a fait Cap pour en arriver là (Jojo ayant fait quelque chose de similaire). | + | <note important>Par précaution, à la fin de votre travail, n'oubliez pas de toujours __quitter le répertoire dédié à git__ sur votre machine, par exemple en tapant la commande :<codebash>cd</code></note> |
| - | + | ||
| - | <code> | + | |
| - | cap@bicoque:~$ mkdir ~/df-git/ | + | |
| - | cap@bicoque:~$ cd ~/df-git/ | + | |
| - | cap@bicoque:~/df-git$ git clone df-git-cap:bac-a-sable | + | |
| - | cap@bicoque:~/df-git$ cd bac-a-sable/ | + | |
| - | cap@bicoque:~/df-git/bac-a-sable$ | + | |
| - | </code> | + | |
| - | + | ||
| - | Jojo veut vérifier s'il y a des nouveautés sur le dépôt : | + | |
| - | + | ||
| - | <code> | + | |
| - | jojo@creperie:~$ cd ~/df-git/bac-a-sable/ | + | |
| - | jojo@creperie:~/df-git/bac-a-sable$ git pull | + | |
| - | Already up-to-date. | + | |
| - | </code> | + | |
| - | + | ||
| - | ''git pull'': //pull// signifie « tirer » en anglais, on tire les mises à jour depuis le serveur, vers notre copie locale) | + | |
| - | + | ||
| - | Visiblement, pas de mise à jour, le dépôt est déjà //up-do-date//. | + | |
| - | + | ||
| - | Jojo veut alors créer un fichier ''crêpes.miam'' contenant sa dernière trouvaille. | + | |
| - | + | ||
| - | Il ouvre son éditeur de texte préféré et crée le-dit fichier, de sorte que... | + | |
| - | <code> | + | |
| - | jojo@creperie:~/df-git/bac-a-sable$ ls -l | + | |
| - | total 4 | + | |
| - | -rw-r--r-- 1 jojo jojo 42 oct. 32 25:61 crêpes.miam | + | |
| - | </code> | + | |
| - | + | ||
| - | Il veut maintenant enregistrer ce changement dans le dépôt. | + | |
| - | + | ||
| - | Comme le fichier ''crêpes.miam'' n'existait pas, il doit d'abord demander à git de le surveiller. | + | |
| - | + | ||
| - | <code>jojo@creperie:~/df-git/bac-a-sable$ git add crêpes.miam | + | |
| - | jojo@creperie:~/df-git/bac-a-sable$</code> | + | |
| - | + | ||
| - | Avant de réellement sauvegarder ces modifications. | + | |
| - | + | ||
| - | <code>jojo@creperie:~/df-git/bac-a-sable$ git commit</code> | + | |
| - | S'ouvre alors son éditeur de texte préféré contenant le texte suivant: | + | |
| - | <code> | + | |
| - | + | ||
| - | # Please enter the commit message for your changes. Lines starting | + | |
| - | # with '#' will be ignored, and an empty message aborts the commit. | + | |
| - | # On branch master | + | |
| - | # Changes to be committed: | + | |
| - | # (use "git reset HEAD <file>..." to unstage) | + | |
| - | # | + | |
| - | #>new file: "cr\303\252pes.miam" | + | |
| - | </code> | + | |
| - | + | ||
| - | On voit que le message indique qu'il y a un nouveau fichier "cr\303\252pes.miam" (encodage ascii du nom utf8 du fichier). | + | |
| - | Il doit indiquer dans cette fenêtre un résumé des opérations effectuées, sur la première ligne. Puis, si nécessaire, une description plus détaillée en dessous (en sautant une ligne). Voici le fichier finalisé de Jojo. | + | |
| - | + | ||
| - | <code>Ma nouvelle recette de crêpe :-P | + | |
| - | + | ||
| - | Un peu moins de beurre et un peu plus de bière, que du bon :) | + | |
| - | Coquine s'est régalée, trôôôôô ! | + | |
| - | # Please enter the commit message for your changes. Lines starting | + | |
| - | # with '#' will be ignored, and an empty message aborts the commit. | + | |
| - | # On branch master | + | |
| - | # Changes to be committed: | + | |
| - | # (use "git reset HEAD <file>..." to unstage) | + | |
| - | # | + | |
| - | #>new file: "cr\303\252pes.miam" | + | |
| - | </code> | + | |
| - | + | ||
| - | Il enregistre et quitte son éditeur de texte. | + | |
| - | <code>[master 7774c8a] Ma nouvelle recette de crêpe :-P | + | |
| - | 1 file changed, 1 insertion(+) | + | |
| - | create mode 100644 "cr\303\252pes.miam" | + | |
| - | jojo@creperie:~/df-git/bac-a-sable$ | + | |
| - | </code> | + | |
| - | + | ||
| - | Les modifications sont donc bien enregistrées sur le dépôt, mais toujours localement sur la machine à Jojo. Pour envoyer ses modifications vers le serveur DF, il doit lancer la commande suivante: | + | |
| - | <code>jojo@creperie:~/df-git/bac-a-sable$ git push | + | |
| - | Counting objects: 4, done. | + | |
| - | Delta compression using up to 8 threads. | + | |
| - | Compressing objects: 100% (2/2), done. | + | |
| - | Writing objects: 100% (3/3), 388 bytes, done. | + | |
| - | Total 3 (delta 0), reused 0 (delta 0) | + | |
| - | To df-git-jojo:bac-a-sable | + | |
| - | d83719f..7774c8a master -> master | + | |
| - | </code> | + | |
| - | + | ||
| - | Comme sur IRC Jojo vante à Cap le goût inégalable de sa nouvelle recette, ce dernier décide d'aller chercher la recette de jojo. | + | |
| - | + | ||
| - | <code>cap@bicoque:~/df-git/bac-a-sable$ git pull | + | |
| - | remote: Counting objects: 4, done. | + | |
| - | remote: Compressing objects: 100% (2/2), done. | + | |
| - | remote: Total 3 (delta 0), reused 0 (delta 0) | + | |
| - | Unpacking objects: 100% (3/3), done. | + | |
| - | From df-git-cap:bac-a-sable | + | |
| - | d83719f..7774c8a master -> origin/master | + | |
| - | Updating d83719f..7774c8a | + | |
| - | Fast-forward | + | |
| - | "cr\303\252pes.miam" | 1 + | + | |
| - | 1 files changed, 1 insertions(+), 0 deletions(-) | + | |
| - | create mode 100644 "cr\303\252pes.miam" | + | |
| - | </code> | + | |
| - | + | ||
| - | Et voilà : | + | |
| - | + | ||
| - | <code>cap@bicoque:~/df-git/bac-a-sable$ ls -l | + | |
| - | total 4 | + | |
| - | -rw-r--r-- 1 cap cap 42 oct. 32 25:61 crêpes.miam | + | |
| - | </code> | + | |
| - | + | ||
| - | Cap veut réorganiser le dépôt pour mettre la recette à Jojo dans un dossier ''recettes''. | + | |
| - | + | ||
| - | Il commence par créer un dossier et il indique à git la nouvelle position / le nouveau nom du fichier crêpes.miam. Il enregistre ensuite ses modifications en faisant un //commit//. | + | |
| - | + | ||
| - | <code>$ mkdir recettes | + | |
| - | $ git mv crêpes.miam recettes/</code> | + | |
| - | + | ||
| - | ''git commit -a'' permet ensuite d'enregistrer les modifications faites pour tous les fichiers qui étaient déjà suivis par ''git''. Ie. pour lesquels quelqu'un avait déjà fait ''git add'' avant. | + | |
| - | + | ||
| - | ''git push'' envoie les modifications sur le serveur. | + | |
| - | + | ||
| - | + | ||
| - | <code>$ git commit -a | + | |
| - | [master 7e63d41] Rangement. | + | |
| - | 1 file changed, 0 insertions(+), 0 deletions(-) | + | |
| - | rename "cr\303\252pes.miam" => "recettes/cr\303\252pes.miam" (100%) | + | |
| - | $ git push | + | |
| - | Counting objects: 4, done. | + | |
| - | Delta compression using up to 8 threads. | + | |
| - | Compressing objects: 100% (2/2), done. | + | |
| - | Writing objects: 100% (3/3), 365 bytes, done. | + | |
| - | Total 3 (delta 0), reused 0 (delta 0) | + | |
| - | To df-git-cap:bac-a-sable | + | |
| - | 7774c8a..7e63d41 master -> master | + | |
| - | $ | + | |
| - | </code> | + | |
| - | + | ||
| - | + | ||
| - | ==== Liste des commandes ==== | + | |
| Placez-vous dans le répertoire cloné du //fichier_travail// | Placez-vous dans le répertoire cloné du //fichier_travail// | ||
| Ligne 317: | Ligne 181: | ||
| //Et ainsi de suite...// | //Et ainsi de suite...// | ||
| + | |||
| + | ==== Glossaire ==== | ||
| + | |||
| + | - commit : Dans un gestionnaire de suivi de version comme git, chaque contributeur, après avoir apporté des modifications de son côté, peut les ajouter au projet principal. Cela s'appelle faire un commit. Le gestionnaire de version permet, en cas de problème, de chercher parmis tous les commit la modification qui posait problème. | ||
| + | - add : Cela sert à ajouter un nouveau fichier au dépot. Ce n'est pas une simple modification d'un fichier déja existant, comme avec commit. | ||
| + | - push : (pousser) Cela sert à envoyer les modifications que vous avez apporté (les commits) sur le dépot principal. En cas de conflit avec des modifications d'un autre utilisateur, vous pouvez les résoudre à la main | ||
| + | - pull : Cela vous permet d'être à jour avec le dépot, et les modifications apportées par les autres. | ||
| ===== Création projet ===== | ===== Création projet ===== | ||
| Ligne 322: | Ligne 193: | ||
| //À suivre, jeu sais pas encore faire ça...// ;-) | //À suivre, jeu sais pas encore faire ça...// ;-) | ||
| + | ===== TP ===== | ||
| + | - [[manuel:git-df:TP_basique|TP 1 : Exemple d'utilisation basique]] | ||
| + | - [[manuel:git-df:TP_merge|TP 2 : Résoudre des conflits]] | ||
| - | ===== Glossaire ===== | ||
| - | - commit : Dans un gestionnaire de suivi de version comme git, chaque contributeur, après avoir apporté des modifications de son côté, peut les ajouter au projet principal. Cela s'appelle faire un commit. Le gestionnaire de version permet, en cas de problème, de chercher parmis tous les commit la modification qui posait problème. | ||
| - | - add : Cela sert à ajouter un nouveau fichier au dépot. Ce n'est pas une simple modification d'un fichier déja existant, comme avec commit. | ||
| - | - push : (pousser) Cela sert à envoyer les modifications que vous avez apporté (les commits) sur le dépot principal. En cas de conflit avec des modifications d'un autre utilisateur, vous pouvez les résoudre à la main | ||
| - | - pull : Cela vous permet d'être à jour avec le dépot, et les modifications apportées par les autres. | ||
| ===== Lien et remerciement ===== | ===== Lien et remerciement ===== | ||
