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 11:24] smolski |
atelier:git-df:git-df [27/10/2012 22:20] smolski |
||
---|---|---|---|
Ligne 6: | Ligne 6: | ||
* Objet : git pour df | * Objet : git pour df | ||
* Niveau requis : AVISÉ | * Niveau requis : AVISÉ | ||
- | * Commentaires : // Ce tuto est destiné essentiellement aux participants des projets df via le installé sur le serveur df. // | + | * Commentaires : // Ce tuto est destiné essentiellement aux participants des projets df via le dépôt git installé sur le serveur df. // |
* Débutant, à savoir : | * Débutant, à savoir : | ||
[[manuel:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | [[manuel:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) | ||
Ligne 14: | Ligne 14: | ||
**Terminal root** : | **Terminal root** : | ||
- | Mettre son système à jour ! | + | Mettre son système à jour : |
- | <code bash> | + | |
- | aptitude update</code> | + | |
- | + | ||
- | Pour stable : | + | |
<code bash> | <code bash> | ||
+ | aptitude update | ||
aptitude safe-upgrade</code> | aptitude safe-upgrade</code> | ||
Ligne 26: | Ligne 23: | ||
aptitude install git-core</code> | aptitude install git-core</code> | ||
- | <note tip>Tout le reste du tuto se passe en terminal user sauf indication précise.</note> | + | <note tip>Tout le reste du tuto se passe en terminal //utilisateur// sauf indication contraire.</note> |
===== Initialisation ===== | ===== Initialisation ===== | ||
Ligne 33: | Ligne 30: | ||
<code bash> | <code bash> | ||
git config --global user.name "votre pseudo du forum" Majuscules ou espace autorisés. | git config --global user.name "votre pseudo du forum" Majuscules ou espace autorisés. | ||
- | git config --global user.email "votre@mail.com"</code> | + | git config --global user.email "votre@mail.com" |
+ | git config --global color.ui true | ||
+ | </code> | ||
Ces commandes vont créer un fichier dans votre répertoire utilisateur qui sera utilisé par tout vos projets. Par défaut, ce fichier est ~/.gitconfig et il contiendra quelque chose comme ça : | Ces commandes vont créer un fichier dans votre répertoire utilisateur qui sera utilisé par tout vos projets. Par défaut, ce fichier est ~/.gitconfig et il contiendra quelque chose comme ça : | ||
Ligne 44: | Ligne 43: | ||
===== Clé SSH ===== | ===== Clé SSH ===== | ||
- | Créer une clé ssh(([[config:ssh | Configurer ssh]])). | + | Créer une paire de clés ssh(([[config:ssh | Configurer ssh]])). |
- | <note>nom_ou_pseudo = Sans espace ni (pour ce qui concerne df uniquement) sans accent et en minuscule !</note> | + | <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> |
- | <code bash> | + | |
- | ssh-keygen -f df-git-nom_ou_pseudo</code> | + | <code bash>ssh-keygen -f ~/.ssh/df-git-nom_ou_pseudo</code> |
- | <note>Il vous sera demandé si vous voulez ajouter une passphrase, à vous de voir si cela vous paraît nécessaire...</note> | + | <note>Il vous sera demandé si vous voulez ajouter une passphrase, à vous de voir si cela vous paraît nécessaire... Notez que si vous en saisissez une, il vous faudra la retaper à chaque nouvelle session de votre pc avant d'utiliser les dépôts.</note> |
Ce qui donnera au final dans le répertoire ~/.ssh : | Ce qui donnera au final dans le répertoire ~/.ssh : | ||
Ligne 62: | Ligne 61: | ||
Il vous faudra communiquer au captnfab __le fichier de la clé publique__((ou son contenu)) **df-git-nom_ou_pseudo.pub**, par email ou depuis le forum df par mp par exemple... | Il vous faudra communiquer au captnfab __le fichier de la clé publique__((ou son contenu)) **df-git-nom_ou_pseudo.pub**, par email ou depuis le forum df par mp par exemple... | ||
- | <note tip>Cette clé publique n'a pas lieu d'être inquiétante en soit, elle permet simplement de vous identifier lorsque VOUS, vous demandez un accès et n'est pas intrusive dans votre propre pc !</note> | + | <note tip>Cette clé publique n'est pas confidentielle. Elle permet simplement au serveur de vérifier que c'est bien vous qui vous connectez avec votre clé privée !</note> |
- | En réponse, vous recevrez de ce cher matelot une configuration à mettre dans le fichier //conf//, fichier à créer(([[commande:mkdir]])) s'il n'y est pas : | + | En réponse, vous recevrez de ce cher matelot une configuration à mettre dans le fichier //~/.ssh/config//, fichier à créer(([[commande:mkdir]])) s'il n'y est pas : |
- | ~/.ssh/conf | + | ~/.ssh/config |
- | + | ||
- | Ensuite, faire un répertoire dans son ///home/user// (c'est le lieu le plus simple) qui vous servira de répertoire où faire transiter vos travaux git mis en commun sur le git-df. | + | |
+ | Ensuite, créez un répertoire dans votre ///home/user// (c'est le lieu le plus simple) qui vous servira de répertoire où faire transiter vos travaux git mis en commun sur le git-df. \\ | ||
Par exemple : | Par exemple : | ||
<code bash> | <code bash> | ||
Ligne 75: | Ligne 73: | ||
==== passphrase ==== | ==== passphrase ==== | ||
- | <note important>**ATTENTION** ! Contrairement au passwd de ssh, la création d'une passphrase implique qu'elle vous sera demandée à chaque session avant toute utilisation du git !</note> | ||
Si vous avez créé une passphrase tapez : | Si vous avez créé une passphrase tapez : | ||
<code bash> | <code bash> | ||
Ligne 83: | 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 96: | Ligne 95: | ||
===== Utilisation ===== | ===== 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]] | ||
+ | |||
+ | |||
+ | ==== Liste des commandes ==== | ||
Placez-vous dans le répertoire cloné du //fichier_travail// | Placez-vous dans le répertoire cloné du //fichier_travail// | ||
Ligne 107: | Ligne 112: | ||
Lorsque vous avez fini et souhaitez partager ce que vous avez réalisé, vous l'ajoutez : | Lorsque vous avez fini et souhaitez partager ce que vous avez réalisé, vous l'ajoutez : | ||
- | ==== add ==== | + | === add === |
<code bash> | <code bash> | ||
git add fichier_travail</code> | git add fichier_travail</code> | ||
- | ==== commit ==== | + | === commit === |
Vous le commitez : | Vous le commitez : | ||
Ligne 128: | Ligne 133: | ||
6 # with '#' will be ignored, and an empty message aborts the commit. | 6 # with '#' will be ignored, and an empty message aborts the commit. | ||
7 # | 7 # | ||
- | 8 # Committer: Joel Smolski <user@mail.com> | + | 8 # Committer: votre pseudo du forum. Votre mail. |
9 # | 9 # | ||
10 # On branch master | 10 # On branch master | ||
Ligne 140: | Ligne 145: | ||
<code> | <code> | ||
[master 4daaf19] Tests matutinaux d'utilisaton du git-df | [master 4daaf19] Tests matutinaux d'utilisaton du git-df | ||
- | Committer: Joel Smolski <admijoel@serveurdeb.(none)> | + | Committer: votre pseudo du forum. Votre mail. |
If the identity used for this commit is wrong, you can fix it with: | If the identity used for this commit is wrong, you can fix it with: | ||
Ligne 149: | Ligne 154: | ||
</code> | </code> | ||
- | ==== push ==== | + | === push === |
Vous le poussez vers le git-df : | Vous le poussez vers le git-df : | ||
Ligne 167: | Ligne 172: | ||
- | ==== pull ==== | + | === pull === |
Plus tard, pour le tirer de nouveau vers vous avec toutes les interventions ajoutées : | Plus tard, pour le tirer de nouveau vers vous avec toutes les interventions ajoutées : | ||
Ligne 178: | Ligne 183: | ||
//À 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 ===== | ||
- | Tuto référentielle : | + | Tuto référentiel : |
* [[http://www.alexgirard.com/git-book/1_bienvenue_sur_git.html | Bienvenue sur git - alexgirard ]] | * [[http://www.alexgirard.com/git-book/1_bienvenue_sur_git.html | Bienvenue sur git - alexgirard ]] | ||
//Merci à //**enicar**// et au// **captnfab** ;-) | //Merci à //**enicar**// et au// **captnfab** ;-) |