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.
Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
atelier:git-df:git-df [27/10/2012 08:55] smolski créée |
atelier:git-df:git-df [27/10/2012 11:24] smolski |
||
---|---|---|---|
Ligne 2: | Ligne 2: | ||
(//testé// - **smolski** 26/10/2012) Le retour sur le forum est ici : | (//testé// - **smolski** 26/10/2012) Le retour sur le forum est ici : | ||
- | * [[//url// | Lien vers le forum concernant ce tuto]] N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs ! | + | * [[http://debian-facile.org/viewtopic.php?id=6081 | Lien vers le forum concernant ce tuto]] N'hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs ! |
* Objet : git pour df | * Objet : git pour df | ||
* Niveau requis : AVISÉ | * Niveau requis : AVISÉ | ||
- | * Commentaires : // Essentielleemnt, ce tuto est destiné aux participants des projets df via git. // | + | * Commentaires : // Ce tuto est destiné essentiellement aux participants des projets df via le 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 31: | Ligne 32: | ||
Tapez : | Tapez : | ||
<code bash> | <code bash> | ||
- | git config --global user.name "votre_pseudo" | + | 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"</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 : | ||
- | name = votre_pseudo | + | [user] |
+ | name = votre pseudo du forum | ||
email = votre@mail.com | email = votre@mail.com | ||
+ | |||
+ | Ce //name// vous servira en signature de vos interventions et dans vos tag. | ||
===== Clé SSH ===== | ===== Clé SSH ===== | ||
- | Créer une clé ssh(([[config:ssh | Configurer ssh]])) : | + | Créer une clé ssh(([[config:ssh | Configurer ssh]])). |
+ | <note>nom_ou_pseudo = Sans espace ni (pour ce qui concerne df uniquement) sans accent et en minuscule !</note> | ||
<code bash> | <code bash> | ||
- | ssh-keygen -f df-git-smolski</code> | + | ssh-keygen -f df-git-nom_ou_pseudo</code> |
- | <note>Il vous sera demandé si vous voulez ajouter un passphrase, à vous de voir si il 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...</note> |
- | Ce qui vous donnera dans le fichier ~/.ssh : | + | Ce qui donnera au final dans le répertoire ~/.ssh : |
- | - un fichier de clé privée((df-git-votre_pseudo)) | + | - un fichier de clé privée((df-git-nom_ou_pseudo)) |
- | - et un de clé publique((df-git-votre_pseudo.pub)) | + | - et un de clé publique((df-git-nom_ou_pseudo.pub)) |
Vérifiez : | Vérifiez : | ||
<code bash> | <code bash> | ||
- | ls .ssh | + | ls ~/.ssh |
- | df-git-votre_pseudo df-git-votre_pseudo.pub</code> | + | df-git-nom_ou_pseudo df-git-nom_ou_pseudo.pub</code> |
- | Il vous faudra communiquer au captnfab __le fichier de la clé publique__((ou son contenu)) df-git-votre_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'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> | ||
- | En réponse, vous recevrez de ce cher matelot une configuration à mettre dans le fichier //conf//, à 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 //conf//, fichier à créer(([[commande:mkdir]])) s'il n'y est pas : |
~/.ssh/conf | ~/.ssh/conf | ||
- | Ensuite, faire un répertoire dans son ///home/user// (c'est le plus simple) qui vous servira de lieu où faire transiter vos travaux mis en commun sur le git-df genre : | + | 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. |
+ | |||
+ | Par exemple : | ||
<code bash> | <code bash> | ||
mkdir ~/projets-df</code> | mkdir ~/projets-df</code> | ||
Ligne 68: | Ligne 75: | ||
==== 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> | ||
- | ssh-add ~/.ssh/df-git-votre_pseudo</code> | + | ssh-add ~/.ssh/df-git-nom_ou_pseudo</code> |
Cette ligne ajoute la passphrase en mémoire en la donnant à ssh-agent. ;-) | Cette ligne ajoute la passphrase en mémoire en la donnant à ssh-agent. ;-) | ||
Ligne 78: | Ligne 86: | ||
Se placer dans ce répertoire créé pour git : | Se placer dans ce répertoire créé pour git : | ||
<code bash> | <code bash> | ||
- | cd~/.ssh/projets-df</code> | + | cd ~/projets-df</code> |
- | Demander le téléchargement du projet par clonage ainsi : | + | Demander le téléchargement du répertoire du projet par clonage ainsi : |
<code bash> | <code bash> | ||
- | git clone df-git-votre_pseudo:le_projet_commun</code> | + | git clone df-git-nom_ou_pseudo:le_projet_commun</code> |
- | Vous aurez à disposition personnelle ce projet commun mis dans le répertoire git d'où vous avez lancé la commande : | + | Vous aurez à disposition personnelle ce répertoire et tout ce qu'il contient mis dans le répertoire git d'où vous avez lancé la commande : |
- | ~/.ssh/projets-df/le_projet_commun | + | ~/projets-df/le_projet_commun |
===== Utilisation ===== | ===== Utilisation ===== | ||
- | Vous modifiez ou compléter le fichier : | + | Placez-vous dans le répertoire cloné du //fichier_travail// |
- | le_projet_commun | + | <code bash> |
+ | cd ~/projets-df/le_projet_commun/</code> | ||
+ | |||
+ | Vous pouvez modifier ou compléter le fichier_travail, par exemple avec vim : | ||
+ | <code bash> | ||
+ | vim fichier_travail</code> | ||
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 : | ||
Ligne 97: | Ligne 110: | ||
<code bash> | <code bash> | ||
- | git add le_projet_commun</code> | + | git add fichier_travail</code> |
==== commit ==== | ==== commit ==== | ||
Ligne 104: | Ligne 117: | ||
<code bash> | <code bash> | ||
- | git commit -a le_projet_commun</code> | + | git commit -a</code> |
+ | |||
+ | Vous aurez alors accès à la rédaction de ce commit ainsi : | ||
+ | <code> | ||
+ | 1 Tests matutinaux d'utilisaton du git-df <- Ici une ligne vierge qui sert au titrage référence de votre intervention dans le projet. | ||
+ | 2 | ||
+ | 3 Ici est un endroit à ajouter si on le désire pour raconter un historique qui serait trop long dans le titre du dessus. | ||
+ | 4 Bien respecter l'interligne vierge entre les deux. | ||
+ | 5 # Please enter the commit message for your changes. Lines starting | ||
+ | 6 # with '#' will be ignored, and an empty message aborts the commit. | ||
+ | 7 # | ||
+ | 8 # Committer: Joel Smolski <user@mail.com> | ||
+ | 9 # | ||
+ | 10 # On branch master | ||
+ | 11 # Changes to be committed: | ||
+ | 12 # (use "git reset HEAD <file>..." to unstage) | ||
+ | 13 # | ||
+ | 14 # modified: test | ||
+ | 15 #</code> | ||
+ | |||
+ | En enregistrant tout cela dans votre terminal vous obtiendrez ensuite : | ||
+ | <code> | ||
+ | [master 4daaf19] Tests matutinaux d'utilisaton du git-df | ||
+ | Committer: Joel Smolski <admijoel@serveurdeb.(none)> | ||
+ | |||
+ | If the identity used for this commit is wrong, you can fix it with: | ||
+ | |||
+ | git commit --amend --author='Your Name <you@example.com>' | ||
+ | |||
+ | 1 files changed, 1 insertions(+), 1 deletions(-) | ||
+ | </code> | ||
==== push ==== | ==== push ==== | ||
Ligne 110: | Ligne 153: | ||
Vous le poussez vers le git-df : | Vous le poussez vers le git-df : | ||
<code bash> | <code bash> | ||
- | git push le_projet_commun</code> | + | git push</code> |
+ | |||
+ | Vous obtiendrez alors l'édition de ces lignes : | ||
+ | <code> | ||
+ | Counting objects: 5, done. | ||
+ | Delta compression using up to 4 threads. | ||
+ | Compressing objects: 100% (2/2), done. | ||
+ | Writing objects: 100% (3/3), 432 bytes, done. | ||
+ | Total 3 (delta 0), reused 0 (delta 0) | ||
+ | To df-git-nom_pseudo:fichier_travail | ||
+ | xxxxxxx..xxxxxxx master -> master | ||
+ | Already up-to-date.</code> | ||
==== pull ==== | ==== pull ==== | ||
- | 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 : |
<code bash> | <code bash> | ||
- | git pull le_projet_commun</code> | + | git pull</code> |
//Et ainsi de suite...// | //Et ainsi de suite...// | ||
Ligne 123: | Ligne 178: | ||
//À suivre, jeu sais pas encore faire ça...// ;-) | //À suivre, jeu sais pas encore faire ça...// ;-) | ||
+ | |||
+ | ===== Lien et remerciement ===== | ||
+ | |||
+ | Tuto référentielle : | ||
+ | * [[http://www.alexgirard.com/git-book/1_bienvenue_sur_git.html | Bienvenue sur git - alexgirard ]] | ||
+ | |||
+ | //Merci à //**enicar**// et au// **captnfab** ;-) |