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 | ||
atelier:git-df:git-df [27/10/2012 10:00] smolski |
atelier:git-df:git-df [27/05/2018 20:48] (Version actuelle) captnfab [Initialisation] |
||
---|---|---|---|
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à !.]] :-) | + | [[:doc:systeme:commandes:le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) |
===== Installation ===== | ===== Installation ===== | ||
Ligne 14: | Ligne 14: | ||
**Terminal root** : | **Terminal root** : | ||
- | Mettre son système à jour ! | + | Mettre son système à jour : |
- | <code bash> | + | <code root> |
- | aptitude update</code> | + | apt-get update |
- | + | apt-get upgrade</code> | |
- | Pour stable : | + | |
- | <code bash> | + | |
- | aptitude safe-upgrade</code> | + | |
Installer git-core : | Installer git-core : | ||
- | <code bash> | + | <code root> |
- | aptitude install git-core</code> | + | apt-get 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 ===== | ||
Tapez : | Tapez : | ||
- | <code bash> | + | <code user> |
- | 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" |
+ | git config --global color.ui true | ||
+ | git config --global core.quotePath false | ||
+ | </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 les clés sh ==== |
- | <code bash> | + | |
- | ssh-keygen -f df-git-votre_pseudo</code> | + | |
- | <note>Il vous sera demandé si vous voulez ajouter un passphrase, à vous de voir si il vous paraît nécessaire...</note> | + | Créer une paire de clés ssh(([[:doc:reseau: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, dans notre tuto et pour éviter les erreurs, on adoptera cette convention)) !</note> | ||
- | Ce qui vous donnera dans le fichier ~/.ssh : | + | <code user>ssh-keygen -f ~/.ssh/df-git-nom_ou_pseudo</code> |
- | - un fichier de clé privée((df-git-votre_pseudo)) | + | |
- | - et un de clé publique((df-git-votre_pseudo.pub)) | + | <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'' : | ||
+ | - un fichier de clé privée((df-git-nom_ou_pseudo)) | ||
+ | - et un de clé publique((df-git-nom_ou_pseudo.pub)) | ||
Vérifiez : | Vérifiez : | ||
- | <code bash> | + | <code user> |
- | ls .ssh | + | ls ~/.ssh</code> |
- | df-git-votre_pseudo df-git-votre_pseudo.pub</code> | + | <code>df-git-nom_ou_pseudo df-git-nom_ou_pseudo.pub</code> |
+ | |||
+ | ==== Communiquez la clé publique ==== | ||
+ | |||
+ | Il vous faudra communiquer au [[http://debian-facile.org/profile.php?id=302] | 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-votre_pseudo.pub, par email ou depuis le forum df par mp par exemple... | + | <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> |
- | <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> | + | Éditez ensuite le fichier ''~/.ssh/config'', à créer s'il n'existe pas. |
+ | Rajouter dans ce dernier le bloc de lignes que vous aura envoyé le captnfab en réponse à votre message. | ||
- | 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 : | + | ==== Créez le répertoire contenant vos git-projets-df ==== |
- | ~/.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 got mis en commun sur le git-df genre : | + | 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. \\ |
- | <code bash> | + | Par exemple nommé //projets-df// : |
+ | <code user> | ||
mkdir ~/projets-df</code> | mkdir ~/projets-df</code> | ||
Ligne 70: | Ligne 81: | ||
Si vous avez créé une passphrase tapez : | Si vous avez créé une passphrase tapez : | ||
- | <code bash> | + | <code user> |
ssh-add ~/.ssh/df-git-votre_pseudo</code> | ssh-add ~/.ssh/df-git-votre_pseudo</code> | ||
Ligne 76: | Ligne 87: | ||
===== 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 (ce que jojo veux dire, c'est que vous n'avez pas de shell sur le serveur)</note> | ||
+ | |||
+ | Afin de connaître la liste des dépôts auxquels vous avez accès en lecture ou en écriture, tapez la commande suivante : | ||
+ | <code user>ssh -T df-git</code> | ||
+ | <code>hello contributeur, the gitolite version here is 2.0.3 | ||
+ | the gitolite config gives you the following access: | ||
+ | @R_ @W_ bac-a-sable | ||
+ | @R W docs/ebook-facile | ||
+ | @R outils/live-df | ||
+ | @R W tutos/latex/pour-commencer | ||
+ | @R tutos/systeme/c-shell | ||
+ | </code> | ||
+ | Dans cet exemple, l'utilisateur "contributeur" a accès en écriture aux dépôts ''bac-a-sable'' (un dépôt pour faire des tests si vous n'êtes pas familiers avec git), ''docs/ebook-facile'', le dépôt pour le projet ebook et ''tutos/latex/pour-commencer''. Il n'a qu'un accès en lecture aux deux autres projets. | ||
+ | |||
+ | <note info>En tant que contributeur, vous avez accès en lecture/écriture aux projets auxquels vous participez, et en lecture seule aux autres projets. | ||
+ | Il est en projet de faire en sorte que les non-contributeurs aient un accès web en lecture seule à tous les projets.</note> | ||
Se placer dans ce répertoire créé pour git : | Se placer dans ce répertoire créé pour git : | ||
- | <code bash> | + | <code user> |
- | 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 user> |
- | git clone df-git-votre_pseudo:le_projet_commun</code> | + | git clone df-git: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 : | + | Si vous préférez voir un cas typique d'utilisation avant de lire la liste des commandes, le TP1 suivant s'y prête bien : |
- | le_projet_commun | + | * [[:atelier:git-df:tp-basique|TP 1 : Exemple d'utilisation basique]] |
+ | |||
+ | |||
+ | ==== Liste des commandes ==== | ||
+ | |||
+ | Placez-vous dans le répertoire cloné du //fichier_travail// | ||
+ | <code user> | ||
+ | cd ~/projets-df/le_projet_commun/</code> | ||
+ | |||
+ | Vous pouvez modifier ou compléter le fichier_travail, par exemple avec vim : | ||
+ | <code user> | ||
+ | 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 : | ||
- | ==== add ==== | + | === add === |
- | <code bash> | + | <code user> |
- | git add le_projet_commun</code> | + | git add fichier_travail</code> |
- | ==== commit ==== | + | === commit === |
Vous le commitez : | Vous le commitez : | ||
- | <code bash> | + | <code user> |
- | git commit -a le_projet_commun</code> | + | git commit -a</code> |
- | ==== push ==== | + | 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: votre pseudo du forum. Votre mail. | ||
+ | 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: votre pseudo du forum. Votre mail. | ||
+ | |||
+ | 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 === | ||
Vous le poussez vers le git-df : | Vous le poussez vers le git-df : | ||
- | <code bash> | + | <code user> |
- | git push le_projet_commun</code> | + | git push</code> |
- | ==== pull ==== | + | 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> | ||
- | Pour le tirer de nouveau vers vous avec toutes les interventions ajoutées : | + | |
- | <code bash> | + | === pull === |
- | git pull le_projet_commun</code> | + | |
+ | Plus tard, pour le tirer de nouveau vers vous avec toutes les interventions ajoutées : | ||
+ | <code user> | ||
+ | git pull</code> | ||
//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 ===== | ||
//À suivre, jeu sais pas encore faire ça...// ;-) | //À suivre, jeu sais pas encore faire ça...// ;-) | ||
+ | |||
+ | ===== TP ===== | ||
+ | - [[:atelier:git-df:tp-basique|TP 1 : Exemple d'utilisation basique]] | ||
+ | - [[:atelier:git-df:tp-merge|TP 2 : Résoudre des conflits]] | ||
+ | |||
===== 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** ;-) |