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 17:04] captnfab |
atelier:git-df:git-df [30/10/2012 10:36] thuban |
||
|---|---|---|---|
| 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 droits. 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> | ||
| - | <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 session avant d'utiliser les dépôts.</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 59: | Ligne 59: | ||
| df-git-nom_ou_pseudo df-git-nom_ou_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-nom_ou_pseudo.pub**, par email ou depuis le forum df par mp par exemple... | + | 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... |
| <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'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 //~/.ssh/config//, fichier à créer(([[commande:mkdir]])) s'il n'y est pas : | + | Éditez ensuite le fichier ''~/.ssh/config'', à créer s'il n'existe pas. |
| - | ~/.ssh/config | + | Rajouter dans ce dernier le bloc de lignes que vous aura envoyé le captnfab en réponse à votre message. |
| - | 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. \\ | + | 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 73: | 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 81: | 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 (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 bash> | ||
| + | $ ssh -T df-git | ||
| + | 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 : | ||
| Ligne 88: | Ligne 105: | ||
| Demander le téléchargement du répertoire 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-nom_ou_pseudo:le_projet_commun</code> | + | git clone df-git:le_projet_commun</code> |
| 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 : | 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 : | ||
| Ligne 94: | Ligne 111: | ||
| ===== 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 ==== | ||
| + | |||
| + | <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> | ||
| Placez-vous dans le répertoire cloné du //fichier_travail// | Placez-vous dans le répertoire cloné du //fichier_travail// | ||
| Ligne 105: | Ligne 130: | ||
| 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 147: | Ligne 172: | ||
| </code> | </code> | ||
| - | ==== push ==== | + | === push === |
| Vous le poussez vers le git-df : | Vous le poussez vers le git-df : | ||
| Ligne 165: | Ligne 190: | ||
| - | ==== 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 172: | Ligne 197: | ||
| //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 177: | Ligne 209: | ||
| //À 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 ===== | ||
