WikiBR - Contributions [fr]

Modèle:Réunions2011

2014-01-29T20:08:01Z

Michel.blancard : ag

* [[Réunion:2014-01-29_Assemblée_Générale|Assemblée Générale de 2014]]
* [[Réunion:2013-05-12_Réunion_DSI_Aile_0|Réunion avec la DSI sur la réfection de l'aile 0]]
* [[Réunion:2013-05-12_Réunion_FedeRez|Réunion FedeRez du 12 mai 2013]]
* [[Réunion:2013-05-01_2e_reunion_du_BR|2e Réunion BR 2011 du 01 mai 2013]]
* [[Réunion:2012-03-27_Réunion_BCX|Réunion sur les impressions à la BCX]]
* [[Réunion:2012-03-27_Réunion_GEIDE|Réunion sur le cloud storage]]
* [[Réunion:2012-03-19_Réunion_CU|Réunion du Comité Utilisateur du 19 mars 2013]]
* [[Réunion:2013-03-14_Réunion_DSI|Réunion DSI du 14 mars 2013]]
* [[Réunion:2013-02-14_Réunion_DSI|Réunion DSI du 14 février 2013]]
* [[Réunion:2013-02-13_Assemblée_Générale|Assemblée Générale du 13 février 2013]]
* [[Réunion:2013-02-12_Réunion_SOI|Réunion SOI du 12 février 2013]]
* [[Réunion:2013-01-17_Réunion_DSI|Réunion DSI du 17 janvier 2013]]
* [[Réunion:2013-01-16_1ere_reunion_du_BR|1ère Réunion BR 2011 du 16 janvier 2013]]
* [[Réunion:2012-12-20_Kes-BR| Réunion avec la Kès du 20 décembre 2012]]
* [[Réunion:2012-12-19_Magnan_BR-ENSTA|Magnan-BR du 19 décembre 2012, avec l'ENSTA]]
* [[Réunion:2012-12-04_Réunion_CD|Réunion du Comité Directeur du 04 décembre 2012]]
* [[Réunion:2012-11-23_Réunion_CU|Réunion du Comité Utilisateur du 23 novembre 2012]]

Ubuntu

2013-05-19T13:37:07Z

Michel.blancard :

Survivre sur le plâtal avec Ubuntu.

==Comment configurer Ubuntu==

===Configuration de la connexion réseau===

Pour configurer ta connexion dans ton casert, clique sur le bouton réseau en haut à droite, puis sur le menu "Edit connections".

===Configuration du proxy===

La configuration du proxy se fait dans "System settings", "Network", "Network proxy". Trois choix sont proposés :
* None : tu ne peux accéder qu'au réseau interne : http://frankiz, ftp://miroir, http://fruits, ftp://biscotte:6?, ...
* Manual : configuré à 129.104.247.2:8080 (ou kuzh:8080) partout (seuls les 3 premières lignes sont utiles en fait), tu ne peux accéder qu'à l'internet, mais pas au réseau interne.
* Automatic : avec http://config/proxy.pac, tu a accès au réseau interne et à l'internet en même temps. Cependant, certains logiciels comprennent pas cette configuration automatique, comme Dropbox, apt...

Lorsque tu enregistres la configuration, le système édite des variables globales (comme http_proxy lorsque la config est "Manual") et répercute les changements dans la configuration d'un certain nombre de logiciels, comme firefox, apt... avec un succès relatif.

===Configurations particulières===

====Firefox====

Firefox se conforme très bien à la configuration du système lorsque l'option "Use system proxy settings" est choisie dans "Edit"/"Preferences"/"Advanced"/"Network"/"Connextion"/"Settings". Il est parfois nécessaire de redémarrer firefox lorsque la configuration réseau change pour que les changements prennent effet.

====apt====

apt, curieusement, fait pas mal de la merde lorsque la configuration du proxy est en automatique : cela reviens à pas de proxy du tout. Donc il faut :
* soit modifier la conf de apt en ligne de commande (dans /etc/apt), au risque de devoir le refaire à chaque modification de la configuration du proxy qui modifie la conf de apt.
* soit se contenter de ftp://miroir dont la connexion ne requiert pas de proxy

====Dropbox====

Dropbox est un sacré coquin et j'ai mis du temps à comprendre comment le faire marcher avec le proxy.

Déjà, lire l'article suivant : [http://doc.ubuntu-fr.org/dropbox].

Dropbox s'installe plus ou moins avec les commandes suivantes (l'ajout de fautes est volontaire, contacte un BRman si tu ne sais vraiment pas ce que tu fais) :
sudo apt-get updat
sudo apt-get install notilus-dropbox
drpbox start -i
wget htp://www.getdropox.com/download?plat=lnx.x86
tar ...
mv ...
dropbx start

Il faut ensuite configurer dropbox pour fonctionner avec le proxy kuzh, car sinon dropbox sera muet dès le redémarrage de l'ordi (menus inaccessibles, pas de synchronisation). En effet, lorsque dropbox est configuré par défaut, dropbox ne fonctionne que si l'ordi a été redémarré avec la configuration du proxy en "Manual". Si tu rencontre le problème de dropbox complètement muet, il faut donc changer la configuration du proxy en "Manual", redémarrer l'ordi, puis dropbox devrait marcher après le redémarrage. Il est ensuite possible de revenir à la configuration automatique du proxy.

====Github====

déjà sur le wikibr

====Thunderbird====

déjà sur le wikibr ou sur l'infoBR 2011

====flash====

déjà sur le wikibr

Ubuntu

2013-05-19T13:33:10Z

Michel.blancard : Page créée avec « Survivre sur le plâtal avec Ubuntu. ==Comment configurer Ubuntu== ===Configuration de la connexion réseau=== Pour configurer ta connexion dans ton casert, clique sur le ... »

Survivre sur le plâtal avec Ubuntu.

==Comment configurer Ubuntu==

===Configuration de la connexion réseau===

Pour configurer ta connexion dans ton casert, clique sur le bouton réseau en haut à droite, puis sur le menu "Edit connections".

===Configuration du proxy===

La configuration du proxy se fait dans "System settings", "Network", "Network proxy". Trois choix sont proposés :
* None : tu ne peux accéder qu'au réseau interne : http://frankiz, ftp://miroir, http://fruits, ftp://biscotte:6?, ...
* Manual : configuré à 129.104.247.2:8080 (ou kuzh:8080) partout, tu ne peux accéder qu'à l'internet, mais pas au réseau interne.
* Automatic : avec http://config/proxy.pac, tu a accès au réseau interne et à l'internet en même temps. Cependant, certains logiciels comprennent pas cette configuration automatique comme Dropbox, apt...

Lorsque tu enregistres la configuration, le système édite des variables globales (comme http_proxy lorsque la config est "Manual") et répercute les changements dans la configuration d'un certain nombre de logiciels, comme firefox, apt...

===Configuration particulières===

====Firefox====

Firefox se conforme très bien à la configuration du système lorsque l'option "Use system proxy settings" est choisie dans "Edit"/"Preferences"/"Advanced"/"Network"/"Connextion"/"Settings". Il est parfois nécessaire de redémarrer firefox lorsque la configuration réseau change pour que les changements prennent effet.

====apt====

apt, curieusement, fait pas mal de la merde lorsque la configuration du proxy est en automatique : cela reviens à pas de proxy du tout. Donc il faut :
* soit modifier la conf de apt en ligne de commande (dans /etc/apt), au risque de devoir le refaire à chaque modification de la configuration du proxy qui modifie la conf de apt.
* soit se contenter de ftp://miroir dont la connexion ne requiert pas de proxy

====Dropbox====

Dropbox est un sacré coquin et j'ai mis du temps à comprendre comment le faire marcher avec le proxy.

Déjà, lire l'article suivant : [http://doc.ubuntu-fr.org/dropbox].

Dropbox s'installe plus ou moins avec les commandes suivantes (l'ajout de fautes est volontaire, contacte un BRman si tu ne sais vraiment pas ce que tu fais) :
sudo apt-get updat
sudo apt-get install notilus-dropbox
drpbox start -i
wget htp://www.getdropox.com/download?plat=lnx.x86
tar ...
mv ...
dropbx start

Il faut ensuite configurer dropbox pour fonctionner avec le proxy kuzh, car sinon dropbox sera muet dès le redémarrage de l'ordi (menus inaccessibles, pas de synchronisation). En effet, lorsque dropbox est configuré par défaut, dropbox ne fonctionne que si l'ordi a été redémarré avec la configuration du proxy en "Manual". Si tu rencontre le problème de dropbox complètement muet, il faut donc changer la configuration du proxy en "Manual", redémerrer l'ordi, puis dropbox devrait marcher après le redémarrage.

====Github====

====Thunderbird====

RespoBar

2013-05-14T22:47:40Z

Michel.blancard : déplacement de la page

Cette page a été déplacée à l'adresse [http://wikix.polytechnique.org/Respo_bar].

Modèle:Réunions2011

2013-05-12T18:43:57Z

Michel.blancard : création réunion federez

* [[Réunion:2013-05-12_Réunion_FedeRez|Réunion FedeRez du 12 mai 2013]]
* [[Réunion:2013-05-01_2e_reunion_du_BR|2e Réunion BR 2011 du 01 mai 2013]]
* [[Réunion:2012-03-27_Réunion_BCX|Réunion sur les impressions à la BCX]]
* [[Réunion:2012-03-27_Réunion_GEIDE|Réunion sur le cloud storage]]
* [[Réunion:2012-03-19_Réunion_CU|Réunion du Comité Utilisateur du 19 mars 2013]]
* [[Réunion:2013-03-14_Réunion_DSI|Réunion DSI du 14 mars 2013]]
* [[Réunion:2013-02-14_Réunion_DSI|Réunion DSI du 14 février 2013]]
* [[Réunion:2013-02-13_Assemblée_Générale|Assemblée Générale du 13 février 2013]]
* [[Réunion:2013-02-12_Réunion_SOI|Réunion SOI du 12 février 2013]]
* [[Réunion:2013-01-17_Réunion_DSI|Réunion DSI du 17 janvier 2013]]
* [[Réunion:2013-01-16_1ere_reunion_du_BR|1ère Réunion BR 2011 du 16 janvier 2013]]
* [[Réunion:2012-12-20_Kes-BR| Réunion avec la Kès du 20 décembre 2012]]
* [[Réunion:2012-12-19_Magnan_BR-ENSTA|Magnan-BR du 19 décembre 2012, avec l'ENSTA]]
* [[Réunion:2012-12-04_Réunion_CD|Réunion du Comité Directeur du 04 décembre 2012]]
* [[Réunion:2012-11-23_Réunion_CU|Réunion du Comité Utilisateur du 23 novembre 2012]]

Modèle:Réunions2011

2013-05-01T18:51:02Z

Michel.blancard : ajout réunion

* [[Réunion:2013-05-01_2e_reunion_du_BR|2e Réunion BR 2011 du 01 mai 2013]]
* [[Réunion:2012-03-27_Réunion_BCX|Réunion sur les impressions à la BCX]]
* [[Réunion:2012-03-27_Réunion_GEIDE|Réunion sur le cloud storage]]
* [[Réunion:2012-03-19_Réunion_CU|Réunion du Comité Utilisateur du 19 mars 2013]]
* [[Réunion:2013-03-14_Réunion_DSI|Réunion DSI du 14 mars 2013]]
* [[Réunion:2013-02-14_Réunion_DSI|Réunion DSI du 14 février 2013]]
* [[Réunion:2013-02-13_Assemblée_Générale|Assemblée Générale du 13 février 2013]]
* [[Réunion:2013-02-12_Réunion_SOI|Réunion SOI du 12 février 2013]]
* [[Réunion:2013-01-17_Réunion_DSI|Réunion DSI du 17 janvier 2013]]
* [[Réunion:2013-01-16_1ere_reunion_du_BR|1ère Réunion BR 2011 du 16 janvier 2013]]
* [[Réunion:2012-12-20_Kes-BR| Réunion avec la Kès du 20 décembre 2012]]
* [[Réunion:2012-12-19_Magnan_BR-ENSTA|Magnan-BR du 19 décembre 2012, avec l'ENSTA]]
* [[Réunion:2012-12-04_Réunion_CD|Réunion du Comité Directeur du 04 décembre 2012]]
* [[Réunion:2012-11-23_Réunion_CU|Réunion du Comité Utilisateur du 23 novembre 2012]]

RespoBar

2013-04-28T21:46:34Z

Michel.blancard : mise en forme

=Respo bar(ou comment subir efficacement)=

==Ouverture du bar==
* Choisir un groupe de respobars, idéalement trois ou quatre
* Ouvrir un compte courant pour le Bar d'étage, la banque dépends de votre section
** LCL : Judo, Natation, Escrime, Aviron, Escalade
** BNP : Tennis, Hand, Bad, Volley, Raid
** SG : Foot, Rugby, Basket, Poney, Boxe
* Il faut choisir un trésorier, qui sera titulaire du compte, le mieux étant de désigner un trésorier adjoint dans les respos bars (qui pourra signer les chèques en l’absence du premier), et donner procuration aux respos restants sur le compte, pour parer à toute forme de problème.
* Récupérer la carte bleue du bar et le chéquier pour pouvoir commencer à faire des courses (les appros).

==La compta==
Point essentiel, le logiciel est en train d'être repensé, et réécrit pour remplacer une version actuellement assez peu fonctionnelle, dans l'état actuel des choses, le mieux est de tenir une comptabilité annexe sur une feuille excel.
* Les renseignements à demander à l'ouverture du compte, et à bien se faire préciser (le banquier de l'x n'est pas souvent le plus renseigné au monde...)
** Découvert autorisé (souvent 300€ sur 30 jours glissants, en gros vous pouvez descendre gratuitement jusque -300€ sur le compte, et moins de 30 jours après la mise en négatif, vous devez positiver votre solde. Après il y a des agios)
** Plafond de retrait par mois (à ne pas négliger, la consommation d'un gros bar oscille entre 4000€ et 5000€ par mois en moyenne, bien au delà des standards bancaires pour un compte particulier, c'est bête de pas avoir à manger pour une histoire de plafond mal placé)
* Pour faire une remise de chèque, au moins signer au dos de chaque chèque (marquer aussi le numéro du compte peut s'avérer utile), remplir un bordereau de remise. Dans la plupart des banques le détail des chèques remis n'est pas demandé, pas besoin de le remplir (et à raison de 15 chèques par semaine ça devient vite long)
* Penser à garder tous les documents, relevés de comptes, tickets de caisse et autres traces de ce que vous avez fait comme opérations.

==La fascisation==
* Amendes, si tu loggue pas, tu raques !
* Faire des affiches partout pour expliquer au jeune Taupin le fonctionnement de l'éponge, l'effet de la gravité sur l'eau (elle coule vers le bas en généralement), bref la base du sens commun reste déjà beaucoup trop longue à expliquer pour se lancer dans des considérations plus élaborées...
* Tours de nettoyage : ça peut être une bonne idée de désigner des respos propreté par semaine pour fasciser et nettoyer ce qui l'à pas été pour que ce soit pas tout le temps les mêmes qui trinquent.
* Agios : à activer pour ne pas avoir à courir après les chèques, étrangement après ils accourent tout seuls.

==Le log==
* Le fonctionnement du logiciel est assez erratique, si vous arrivez à rentrer vos appros correctement, vous m'expliquerez. L'essentiel est de créer les aliments au bon tarif, avec une taxe de 20%, ce qui permet de payer les produits open (épices/sauces/poeles, ... à vous de voir). Encore une fois, celui ci va être refait.

==Les appros==
Vous pouvez toujours aller faire les courses avec une voiture à Cora ou Auchan (voir sur le wikix), mais ça devient rapidement lassant à raison d'un voyage par semaine. Pour ce qui est des livraisons, il existe deux types de supermarché en ligne :
* La plupart des enseignes font un service ad-hoc, schématiquement vous commandez, un mec du magasin se ballade pour vous dans les rayons, remplis un caddie et vous l'apporte. L'avantage : il y a beaucoup plus de magasins dispos, donc de moyen de changer si ça vous convient pas. L'inconvénient : des limitations en quantité achetée et en volume, comme en variété des produits disponibles.
** Intermarché : http://drive.intermarche.com/ livreur très sympa et très arrangeant, mais le magasin est tout le temps vide, et c'est presque impossible d'avoir ce qu'on veut en quantité. De la même manière, une limitation à 300 ou 400€ par commande.
** Auchan : www.auchandirect.fr/ Possibilité d'être livré du jour au lendemain, limite à 500€ et en volume de liquide transporté (donc de bière).
** Cora : http://www.houra.fr/ Pas testé
* Deux enseignes ont un vrai service de livraison pro (séparé du magasin) et font du gros.
** Telemarket (super U) : http://www.telemarket.fr/ Limite de livraison à 4000€ et grande variété de produits, problèmes récurrents d'indisponibilité de produits dans la liste et peu de crénaux de livraison disponibles, qui se trouvent de temps en temps saturés. La livraison est un peu délicate quand le livreur ne trouve pas, vu que tout passe par un centre d'appels.
** Ooshop (Carrefour) : http://www.ooshop.com dans l'idée un peu plus cher que Telemarket, mais un service client plus réactif. Les produits vendus sont similaires, et la limite est initialement à 800€ mais avec possibilité d'augmenter en les appelant.

RespoBar

2013-04-28T21:46:00Z

Michel.blancard : Page créée avec « =Respo bar= ===ou comment subir efficacement==== ==Ouverture du bar== * Choisir un groupe de respobars, idéalement trois ou quatre * Ouvrir un compte courant pour le Bar d'... »

=Respo bar=
===ou comment subir efficacement====

==Ouverture du bar==
* Choisir un groupe de respobars, idéalement trois ou quatre
* Ouvrir un compte courant pour le Bar d'étage, la banque dépends de votre section
** LCL : Judo, Natation, Escrime, Aviron, Escalade
** BNP : Tennis, Hand, Bad, Volley, Raid
** SG : Foot, Rugby, Basket, Poney, Boxe
* Il faut choisir un trésorier, qui sera titulaire du compte, le mieux étant de désigner un trésorier adjoint dans les respos bars (qui pourra signer les chèques en l’absence du premier), et donner procuration aux respos restants sur le compte, pour parer à toute forme de problème.
* Récupérer la carte bleue du bar et le chéquier pour pouvoir commencer à faire des courses (les appros).

==La compta==
Point essentiel, le logiciel est en train d'être repensé, et réécrit pour remplacer une version actuellement assez peu fonctionnelle, dans l'état actuel des choses, le mieux est de tenir une comptabilité annexe sur une feuille excel.
* Les renseignements à demander à l'ouverture du compte, et à bien se faire préciser (le banquier de l'x n'est pas souvent le plus renseigné au monde...)
** Découvert autorisé (souvent 300€ sur 30 jours glissants, en gros vous pouvez descendre gratuitement jusque -300€ sur le compte, et moins de 30 jours après la mise en négatif, vous devez positiver votre solde. Après il y a des agios)
** Plafond de retrait par mois (à ne pas négliger, la consommation d'un gros bar oscille entre 4000€ et 5000€ par mois en moyenne, bien au delà des standards bancaires pour un compte particulier, c'est bête de pas avoir à manger pour une histoire de plafond mal placé)
* Pour faire une remise de chèque, au moins signer au dos de chaque chèque (marquer aussi le numéro du compte peut s'avérer utile), remplir un bordereau de remise. Dans la plupart des banques le détail des chèques remis n'est pas demandé, pas besoin de le remplir (et à raison de 15 chèques par semaine ça devient vite long)
* Penser à garder tous les documents, relevés de comptes, tickets de caisse et autres traces de ce que vous avez fait comme opérations.

==La fascisation==
* Amendes, si tu loggue pas, tu raques !
* Faire des affiches partout pour expliquer au jeune Taupin le fonctionnement de l'éponge, l'effet de la gravité sur l'eau (elle coule vers le bas en généralement), bref la base du sens commun reste déjà beaucoup trop longue à expliquer pour se lancer dans des considérations plus élaborées...
* Tours de nettoyage : ça peut être une bonne idée de désigner des respos propreté par semaine pour fasciser et nettoyer ce qui l'à pas été pour que ce soit pas tout le temps les mêmes qui trinquent.
* Agios : à activer pour ne pas avoir à courir après les chèques, étrangement après ils accourent tout seuls.

==Le log==
* Le fonctionnement du logiciel est assez erratique, si vous arrivez à rentrer vos appros correctement, vous m'expliquerez. L'essentiel est de créer les aliments au bon tarif, avec une taxe de 20%, ce qui permet de payer les produits open (épices/sauces/poeles, ... à vous de voir). Encore une fois, celui ci va être refait.

==Les appros==
Vous pouvez toujours aller faire les courses avec une voiture à Cora ou Auchan (voir sur le wikix), mais ça devient rapidement lassant à raison d'un voyage par semaine. Pour ce qui est des livraisons, il existe deux types de supermarché en ligne :
* La plupart des enseignes font un service ad-hoc, schématiquement vous commandez, un mec du magasin se ballade pour vous dans les rayons, remplis un caddie et vous l'apporte. L'avantage : il y a beaucoup plus de magasins dispos, donc de moyen de changer si ça vous convient pas. L'inconvénient : des limitations en quantité achetée et en volume, comme en variété des produits disponibles.
** Intermarché : http://drive.intermarche.com/ livreur très sympa et très arrangeant, mais le magasin est tout le temps vide, et c'est presque impossible d'avoir ce qu'on veut en quantité. De la même manière, une limitation à 300 ou 400€ par commande.
** Auchan : www.auchandirect.fr/ Possibilité d'être livré du jour au lendemain, limite à 500€ et en volume de liquide transporté (donc de bière).
** Cora : http://www.houra.fr/ Pas testé
* Deux enseignes ont un vrai service de livraison pro (séparé du magasin) et font du gros.
** Telemarket (super U) : http://www.telemarket.fr/ Limite de livraison à 4000€ et grande variété de produits, problèmes récurrents d'indisponibilité de produits dans la liste et peu de crénaux de livraison disponibles, qui se trouvent de temps en temps saturés. La livraison est un peu délicate quand le livreur ne trouve pas, vu que tout passe par un centre d'appels.
** Ooshop (Carrefour) : http://www.ooshop.com dans l'idée un peu plus cher que Telemarket, mais un service client plus réactif. Les produits vendus sont similaires, et la limite est initialement à 800€ mais avec possibilité d'augmenter en les appelant.

Git

2013-04-18T17:07:21Z

Michel.blancard : /* Récupérer le code d'un projet existant */

{{menu Root Toolbox}}

Git est un [[VCS|système de contrôle de version]]. Assez proche de [[SVN]] par certains côtés, il présente néanmoins un grand nombre de différences.

Si tu découvre git, ou que tu n'est pas encore très à l'aise avec, consulte [http://www.vogella.com/articles/Git/article.html ce tutoriel très bien expliqué et très complet]. Pour un aide mémoire, va voir [http://giudoku.sourceforge.net/media/GitHandbook.pdf ici] ou [http://ndpsoftware.com/git-cheatsheet.html ici].

== Dépôts ==

Alors que [[CVS]] et [[SVN]] sont des systèmes de versionnement centralisés (i.e un serveur contient le dépôt, et chaque utilisateur effectue un ''checkout'' depuis ce dépôt), Git est complètement décentralisé. Cela signifie que chaque contributeur a sa propre copie locale de tout l'historique d'un projet. Si aujourd'hui vous considérez que l'espace disque sur votre ordinateur est un problème, allez faire un tour, partez admirer les merveilles de la technologies qui nous entoure, et revenez demain. Sur cette page, tous les examples sont tirés du Git de [[Frankiz]], mais voici d'autres dépôts bien utiles :
* [http://www.github.com/ GitHub]
* [http://git.frankiz.net/ Frankiz]
* [http://git.polytechnique.org/ Polytechnique.org]

== Récupérer le code d'un projet existant ==

Pour télécharger un projet existant, il y a deux possibilités : avec un compte de développeur ou sans compte. Avec un compte SSH simple, il suffit d'exécuter la commande suivante :
git clone mybeautifulname@git.frankiz.net:/hosting/git/frankiz
Sans compte, certains projets sont téléchargeables avec le protocole HTTP, mais vous ne pourrez pas uploader vos modifications.
git clone http://dev.frankiz.net/git/frankiz

Cela crée un '''clone''' du dépôt d'origine (i.e une copie conforme), qui peut d'ailleurs servir de backup si le dépôt d'origine était perdu. Notre clone contient tout l'historique du dépôt depuis sa création, toutes les branches, etc. Cette première opération est très souple. On peut cloner des dépôt via SSH, HTTP, GIT, ou même en local le dépôt d'un autre utilisateur...

Par exemple la commande suivante clone dans le dossier ''platal'' la branche ''core/master'' d'une version de Plat/al potientiellement modifiée par le vice-prez 2010 :
git clone /home/2010/fishilico/dev/platal/.git platal -b core/master

== Accéder à l'aide ==
Avant toute chose, il est essentiel de savoir où trouver de l'aide, d'autant plus que l'aide de Git est très bien faite.
* Sur internet, il y a le wikiBR, les pages de manuel ([http://linux.die.net/man/1/git sur Linux Die] par exemple) et le [http://book.git-scm.com/ Git Book]
* En terminal, ''git help'' pour une liste des commandes, ''git help cmd'' ou ''git cmd --help'' pour l'aide complète de la commande ''cmd'', ou encore simplement ''git cmd -h'' pour une aide courte sur la commande ''cmd''

== Quel est l'état de ma copie de travail ? ==
Ceci est la question que vous devez vous posez avant de reprendre après une pause votre travail sur un projet versionné. Il peut y avoir eu des changements sur le projet entre temps, des patchs mal faits en production, ... Pour cela, il y a trois commandes essentielles :
* Pour vérifier que le dépôt est correct, ''git status'' doit dire cela :
git status
# On branch master
nothing to commit (working directory clean)
* En cours de travail, la réponse ressemble plus à :
git status
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: un-fichier-random.blah
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# un-fichier-chombier-ajouté.42
no changes added to commit (use "git add" and/or "git commit -a")
* Lire l'historique est bien pour savoir quel est le dernier commit
git log
commit 2a424aae1e746fb5f33de3b3bc3e8a31ee25c684
Author: Nicolas Iooss <fishilico@eleves.polytechnique.fr>
Date: Fri Mar 9 00:27:35 2012 +0100
* Voir les différences entre la version sur le dépôt distant et celle de travail
git diff

De plus, après avoir téléchargé les derniers commits avec ''git fetch'', il est possible d'obtenir le message suivant :
git status
# On branch master
# Your branch is behind 'origin/master' by 42 commits, and can be fast-forwarded.
Cela signifie que la copie locale a 42 commits de retard sur le dépôt distant, mais qu'un ''git rebase origin/master'' suffit pour mettre à jour la copie locale.

== Réinitialiser le dépôt ==
Pour restaurer un fichier, il suffit de le ''checkout'' à partir de l'index. En français, cela signifie que lorsque vous faites une modification sur un fichier, vous pouvez effacer les modifications et revenir la dernière version enregistrée dans l'index Git avec la commande :
git checkout -- chemin/vers/mon/fichier.blih
Pour réinitialiser l'index dans l'état indiqué par une branche (comme ''master'' par exemple) sans modifier les fichier, il suffit d'écrire :
git reset master
Si cela ne marche pas car des fichiers seront modifiés ou effacés, on peut forcer la main à Git, mais alors il faut être prêt à subir les conséqences que cela implique (perte des modifications non commitées)
git reset --hard master

== Mettre à jour la copie de travail ==
=== git fetch && git rebase origin/master ===
Dans le cas général, vous travaillez sur la branche ''master'' et vous synchronisez votre projet sur un seul serveur. Si votre cas est plus compliqué, vous devez être suffisamment compétent pour vous débrouillez par vous-même. On disait donc... dans le cas simple, Git stocke en interne deux branches : ''master'' et ''origin/master''. Sur Frankiz, c'est un peu plus compliqué car il y a une branche de production, mais les développeurs n'utilisent que master.
git branch -a
* master
remotes/origin/HEAD -> origin/master
remotes/origin/f579e1971a66623b2948bf0e20c2e23481022b41
remotes/origin/fkz2
remotes/origin/kangz-h4ck3s
remotes/origin/master
remotes/origin/prod

Pour mettre à jour sa copie de travail, il faut donc commencer par mettre à jour les branches distantes, avec '''au choix''' l'une des commandes suivantes
git fetch
git fetch origin

Ensuite, il faut appliquer les éventuelles modifications locales à la suite de celles effectuées sur le dépôt, c'est le '''rebase'''.
git rebase origin/master
Git essaiera alors d'appliquer les commits locaux successivement, en indiquant chaque fois qu'il y a un problème (conflit ou fichier supprimé). En cas de problème, il faut
# Résoudre le problème (les fichiers avec des conflits apparaîssent comme ''Changed but not updated'' dans ''git status'')
# Ajouter les fichiers (''git add'')
# Indiquer à git de continuer : ''git rebase --continue''

Remarque : git pull --rebase est un raccourci pour l'ensemble git fetch && git rebase. Attention cependant lors du travail sur plusieurs branches.

Ceci permet de transformer l'état suivant (les ''O'' sont les commits, ''A'' le moment où les deux versions ont commencé à diverger, ''B'' la version du dépôt, ''E'' la version locale, ''C'' et ''D'' des commits locaux

-C--D--E
/
-O--A--O--B

En l'état plus propre :
-O--A--O--B--C'--D'--E'

Avec C, D et E convertis en C', D' et E' : ils ont été modifiés pour être des modifications relatives à B au lieu de A.

=== Pourquoi il ne faut JAMAIS utiliser git pull ===
Certains développeurs utilisent la commande ''git pull'' pour mettre à jour leur dépôt. Cette pratique est justifiée lorsque la copie de travail était propre (sans commit en attente de push entre autres), mais sinon, cela peut avoir des conséquences très graves et sales. En effet, ''git pull' est assimilé à la succession de commandes suivantes :
git fetch origin && git merge origin/master
Le problème est le merge. En reprenant les schémas précédents, cela transforme l'état suivant :

-C--D--E
/
-O--A--O--B

en :

-C--D--E
/ \
-O--A--O--B----M

où M est le commit ''de fusion de branches''. '''Cela est très moche et à éviter absolument'''. Si vous vous retrouvez dans cette suituation (pour vérifier : ''git log''), vous pouvez toujours tenter un ''git rebase origin/master'' qui peut fonctionner si le ''merge'' était trivial (sans conflit). Sinon, un ''git reset --hard origin/master'' s'impose pour assurer votre salut.

=== Sauvegarder des modifications locales (git stash) ===
Avant de faire un merge particulièrement délicat, ou si l'on doit résoudre un bug alors que l'on a pas mal de modifications non commitées en cours, il est parfois utile de sauvegarder l'état courant de la copie de travail.

Pour cela, il faut utiliser '''avant''' un changement (avec ''git rebase'' par exemple) :
git stash
Une fois les modifications effectuées, on peut restorer la copie locale à l'état sauvegardé avec :
git stash pop

== Effectuer un commit ==
Un '''commit''' est un ensemble de fichiers modifiés. Cela permet plus de cohérence dans le suivi des versions. Par exemple, si l'ajout d'une fonctionnalité sur Frankiz modifie les fichiers ''blah'', ''blih'' et ''bloh'', le ''commit'' regroupe les modifications de ces trois fichiers, et associe à cette modification une date et un auteur.

Pour effectuer un commit, il faut :
* Vérifier l'état de la copie de travail, pour ne commiter que ce qui est nécessaire
git status
git diff
* Indiquer à Git quels fichiers feront partie du commit ; ceci permet de ne committer que les modifications de quelques fichiers
git add path/to/blih path/to/blah path/to/bloh
* Vérifier que l'on a ajouté les fichiers que l'on voulait :
git status
* Faire le commit (le ''-s'' ajoute une ligne ''Signed of by'' dans le message, pour pouvoir retrouver plus efficacement l'auteur réel du commit)
git commit -s
* Cette commande ouvre un éditeur (vi, nano ou emacs selon la configuration de la variable EDITOR). Il faut alors entrer un bref descriptif du commit. '''Pour certains projets (dont Frankiz), les conventions de codage obligent les développeurs à écrire les descriptions en anglais.''' Il est un bon usage de s'adapter en conséquence, car un commit peut être refusé en production s'il est mal fait.
* Mettre à jour la copie locale avec le dépôt distant (cela décale le nouveau commit à la fin). '''IL NE FAUT SURTOUT PAS FAIRE DE git pull OU DE git merge ICI'''
git fetch
git rebase origin/master
* Transmettre les commits au dépôt d'origine
git push

La dernière commande provient du fait que git n'est pas centralisé : il n'envoie pas les modifications locales au dépôt parent spontanément.

Ceci permet de faire quelques modifications locales puis de n'envoyer cela au reste des développeurs que lorsque les modifications sont stables et complètes, par exemple.

== Gérer les branches ==
On peut voir la liste des branches accessibles avec :
git branch -a
* La ligne avec une étoile est la branche courante
* Les lignes blanches sont les branches ''locales'' (elles suivent généralement une branche distante)
* Les lignes rouges (si les couleurs sont activées) sont les branches distantes.

Pour récupérer une autre branche, il faut d'abord l'ajouter localement :
git checkout -b NomLocal origin/NomDistant

Cela aura également pour effet de basculer sur la branche NomLocal.
Les modifications que l'on avait effectuées sont bien entendu conservées.

Une fois la branche ajoutée, on peut basculer de branche en branche à l'aide de :
git checkout NomLocal

== Créer un dépôt ==
Contrairement à [[SVN]] où il faut installer un serveur subversion, créer un dépôt Git est très rapide : dans le dossier que l'on souhaite versionner, il suffit de taper
git init
Et voilà, le dossier est versionné : on peut donc commencer à faire des modifications, des commits, etc. (bien entendu, on ne peut pas ''pusher'' ses commits, puisqu'il n'y a pas de serveur distant).

Cette particularité rend Git très efficace pour versionner un petit projet, un exercice de TD, etc.

Pour créer un dépôt qui peut être cloné, il faut exécuter les commandes suivantes :
git init --bare mon_projet
cd mon_projet && git update-server-info

Enfin, pour configurer un serveur HTTP (gitweb), il ne faut pas oublier de créer un fichier vide '''git-daemon-export-ok''' dans le dossier, afin de permettre le clonage.

== Structure interne ==

Git stocke les commits de manière très particulière : un commit correspond à peu près à une sauvegarde de l'état des fichiers, à un message, et à une référence vers le commit parent.
Contrairemant à [[SVN]], il n'y a donc pas de notion de numéro de révision : chaque commit est identifié par une chaîne hexadécimale de 40 caractères (par exemple : ''04fd02e59b1bdc430c7a7dcc1ca9f4cbc2b04037'' )

Un ''tag'' est en fait un nom «lisible» donné à un ''commit'' ; une ''branche'' indique également le ''commit'' principal d'une branche.

== Du bon usage de gitignore ==
Dans un projet, il est inutile de versionner les fichiers temporaires et les fichiers compilés (qu'ils soient binaires ou non). On utilise généralement un Makefile pour créer ces fichiers. Pour éviter de les versionner, il suffit d'utiliser un fichier ''.gitignore'' bien placé. Généralement, chaque projet a un tel fichier dans son dossier principal. Voici par exemple un extrait du gitignore de Frankiz :
configs/frankiz.conf
htdocs/.htaccess
htdocs/data/*
htdocs/css/*
spool/*
upgrade/2.0.0_to_3.0.0/unversionned

== Configuration globale ==
Si vous avez déjà commitez, vous aurez certainement remarqué qu'il faut utiliser ''git config'' pour configurer vos informations personnelles. Ainsi, les deux premières commandes que tout utilisateur doit taper avant de faire un commit sont :
git config --global user.name "Prénom Nom de famille"
git config --global user.email "prenom.nom.promo@polytechnique.org"

Ensuite, si vous aimez les couleurs, vous avez envie de taper cette commande :
git config --global color.ui auto

Enfin, si vous en avez assez des projets qui ne mettent pas les fichiers temporaires dans le gitignore, vous pouvez configurer un fichier gitignore global. Si votre ''/home/user/.gitignore_global'' ressemble à
*~
*.swp
*.tmp
il suffit de taper :
git config --global core.excludesfile /home/user/.gitignore_global

Tout cela permet de gérer la configuration globale, visible par
git config --global -l
En enlevant ''--global'' dans toutes les commandes précédentes, on configure la copie locale.

=== Exemple de configuration ===
Voici un exemple de fichier ~/.gitconfig (qui stocke la configuration ''--global'', le même format peut être utilisé dans les fichier ''$REPO/.git/config'' de chaque dépot) :
[gc]
auto = 1
[color]
ui = true
[color "diff"]
whitespace = red reverse
[core]
whitespace=fix,-indent-with-non-tab,trailing-space,cr-at-eol
[alias]
st = status
ci = commit
br = branch
co = checkout
df = diff
dc = diff --cached
lg = log -p
lo = log --graph --decorate --pretty=oneline --abbrev-commit -n 10
lol = log --graph --decorate --pretty=oneline --abbrev-commit
lola = log --graph --decorate --pretty=oneline --abbrev-commit --all
ls = ls-files
# Show files ignored by git:
ign = ls-files -o -i --exclude-standard
amend = commit --amend -C HEAD
[branch]
autosetuprebase = always

== Utiliser le proxy de l'X avec Git ==
Si vous hébergez un projet sur [http://www.github.com GitHub], vous avez envie de dire à Git de se connecter à GitHub en SSH en passant par le proxy de l'X (qui est [http://kuzh.polytechnique.fr:8080 kuzh:8080]). Pour cela, il suffit de configurer le client SSH pour utiliser le proxy à chaque connexion vers github.com. Cela s'effecute par le fichier de configuration suivant dans /home/user/.ssh/config (adaptez avec votre dossier personnel)
Host github.com
ProxyCommand socat - PROXY:kuzh.polytechnique.fr:%h:%p,proxyport=8080

Si vous souhaitez utiliser le protocole git://, il faut utiliser socat, et créer un exécutable avec dedans :
#!/bin/sh
exec socat STDIO PROXY:129.104.247.2:$1:$2

Puis mettre cet executable dans la variable core.gitproxy :
git config --global core.gitproxy NOM_DU_FICHIER

N'oubliez pas d'enlever cette variable pour utiliser git en-dehors de l'X.

'''Si vous souhaitez uniquement cloner un dépôt GitHub''' dont vous n'êtes pas contributeur, il suffit d'utiliser le lien HTTPS en ligne de commande, en précisant le proxy.
export https_proxy=http://kuzh.polytechnique.fr:8080
git clone https://github.com/BinetReseau/frankiz.git

Finalement, si vous ne voulez pas vous connecter par ssh, mais vous souhaitez travailler normalement avec un depôt à l'extérieur de l'X, configurez git par le biais de ces commandes:
git config --global http.proxy http://kuzh.polytechnique.fr:8080
git config --global https.proxy http://kuzh.polytechnique.fr:8080

Cela va effectuer les modifications correspondantes sur le fichier ~/.gitconfig. '''N'oubliez pas de les enlever dès que vous n'êtes plus connectés au réseau de l'école, avec''':
git config --global --unset http.proxy http://kuzh.polytechnique.fr:8080

= Pour Windows =

Pour utiliser Git sur Windows, on peut par exemple télécharger MSys Git : [http://msysgit.github.com/ http://msysgit.github.com/].

[[Catégorie:Root]]

Git

2013-04-18T17:06:52Z

Michel.blancard : /* Récupérer le code d'un projet existant */

{{menu Root Toolbox}}

Git est un [[VCS|système de contrôle de version]]. Assez proche de [[SVN]] par certains côtés, il présente néanmoins un grand nombre de différences.

Si tu découvre git, ou que tu n'est pas encore très à l'aise avec, consulte [http://www.vogella.com/articles/Git/article.html ce tutoriel très bien expliqué et très complet]. Pour un aide mémoire, va voir [http://giudoku.sourceforge.net/media/GitHandbook.pdf ici] ou [http://ndpsoftware.com/git-cheatsheet.html ici].

== Dépôts ==

Alors que [[CVS]] et [[SVN]] sont des systèmes de versionnement centralisés (i.e un serveur contient le dépôt, et chaque utilisateur effectue un ''checkout'' depuis ce dépôt), Git est complètement décentralisé. Cela signifie que chaque contributeur a sa propre copie locale de tout l'historique d'un projet. Si aujourd'hui vous considérez que l'espace disque sur votre ordinateur est un problème, allez faire un tour, partez admirer les merveilles de la technologies qui nous entoure, et revenez demain. Sur cette page, tous les examples sont tirés du Git de [[Frankiz]], mais voici d'autres dépôts bien utiles :
* [http://www.github.com/ GitHub]
* [http://git.frankiz.net/ Frankiz]
* [http://git.polytechnique.org/ Polytechnique.org]

== Récupérer le code d'un projet existant ==

Pour télécharger un projet existant, il y a deux possibilités : avec un compte de développeur ou sans compte. Avec un compte SSH simple, il suffit d'exécuter la commande suivante :
git clone mybeautifulname@git.frankiz.net:/hosting/git/frankiz
Sans compte, certains projets sont téléchargeables avec le protocole HTTP, mais vous ne pourrez pas uploader vos modifications.
git clone http://dev.frankiz.net/frankiz

Cela crée un '''clone''' du dépôt d'origine (i.e une copie conforme), qui peut d'ailleurs servir de backup si le dépôt d'origine était perdu. Notre clone contient tout l'historique du dépôt depuis sa création, toutes les branches, etc. Cette première opération est très souple. On peut cloner des dépôt via SSH, HTTP, GIT, ou même en local le dépôt d'un autre utilisateur...

Par exemple la commande suivante clone dans le dossier ''platal'' la branche ''core/master'' d'une version de Plat/al potientiellement modifiée par le vice-prez 2010 :
git clone /home/2010/fishilico/dev/platal/.git platal -b core/master

== Accéder à l'aide ==
Avant toute chose, il est essentiel de savoir où trouver de l'aide, d'autant plus que l'aide de Git est très bien faite.
* Sur internet, il y a le wikiBR, les pages de manuel ([http://linux.die.net/man/1/git sur Linux Die] par exemple) et le [http://book.git-scm.com/ Git Book]
* En terminal, ''git help'' pour une liste des commandes, ''git help cmd'' ou ''git cmd --help'' pour l'aide complète de la commande ''cmd'', ou encore simplement ''git cmd -h'' pour une aide courte sur la commande ''cmd''

== Quel est l'état de ma copie de travail ? ==
Ceci est la question que vous devez vous posez avant de reprendre après une pause votre travail sur un projet versionné. Il peut y avoir eu des changements sur le projet entre temps, des patchs mal faits en production, ... Pour cela, il y a trois commandes essentielles :
* Pour vérifier que le dépôt est correct, ''git status'' doit dire cela :
git status
# On branch master
nothing to commit (working directory clean)
* En cours de travail, la réponse ressemble plus à :
git status
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: un-fichier-random.blah
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# un-fichier-chombier-ajouté.42
no changes added to commit (use "git add" and/or "git commit -a")
* Lire l'historique est bien pour savoir quel est le dernier commit
git log
commit 2a424aae1e746fb5f33de3b3bc3e8a31ee25c684
Author: Nicolas Iooss <fishilico@eleves.polytechnique.fr>
Date: Fri Mar 9 00:27:35 2012 +0100
* Voir les différences entre la version sur le dépôt distant et celle de travail
git diff

De plus, après avoir téléchargé les derniers commits avec ''git fetch'', il est possible d'obtenir le message suivant :
git status
# On branch master
# Your branch is behind 'origin/master' by 42 commits, and can be fast-forwarded.
Cela signifie que la copie locale a 42 commits de retard sur le dépôt distant, mais qu'un ''git rebase origin/master'' suffit pour mettre à jour la copie locale.

== Réinitialiser le dépôt ==
Pour restaurer un fichier, il suffit de le ''checkout'' à partir de l'index. En français, cela signifie que lorsque vous faites une modification sur un fichier, vous pouvez effacer les modifications et revenir la dernière version enregistrée dans l'index Git avec la commande :
git checkout -- chemin/vers/mon/fichier.blih
Pour réinitialiser l'index dans l'état indiqué par une branche (comme ''master'' par exemple) sans modifier les fichier, il suffit d'écrire :
git reset master
Si cela ne marche pas car des fichiers seront modifiés ou effacés, on peut forcer la main à Git, mais alors il faut être prêt à subir les conséqences que cela implique (perte des modifications non commitées)
git reset --hard master

== Mettre à jour la copie de travail ==
=== git fetch && git rebase origin/master ===
Dans le cas général, vous travaillez sur la branche ''master'' et vous synchronisez votre projet sur un seul serveur. Si votre cas est plus compliqué, vous devez être suffisamment compétent pour vous débrouillez par vous-même. On disait donc... dans le cas simple, Git stocke en interne deux branches : ''master'' et ''origin/master''. Sur Frankiz, c'est un peu plus compliqué car il y a une branche de production, mais les développeurs n'utilisent que master.
git branch -a
* master
remotes/origin/HEAD -> origin/master
remotes/origin/f579e1971a66623b2948bf0e20c2e23481022b41
remotes/origin/fkz2
remotes/origin/kangz-h4ck3s
remotes/origin/master
remotes/origin/prod

Pour mettre à jour sa copie de travail, il faut donc commencer par mettre à jour les branches distantes, avec '''au choix''' l'une des commandes suivantes
git fetch
git fetch origin

Ensuite, il faut appliquer les éventuelles modifications locales à la suite de celles effectuées sur le dépôt, c'est le '''rebase'''.
git rebase origin/master
Git essaiera alors d'appliquer les commits locaux successivement, en indiquant chaque fois qu'il y a un problème (conflit ou fichier supprimé). En cas de problème, il faut
# Résoudre le problème (les fichiers avec des conflits apparaîssent comme ''Changed but not updated'' dans ''git status'')
# Ajouter les fichiers (''git add'')
# Indiquer à git de continuer : ''git rebase --continue''

Remarque : git pull --rebase est un raccourci pour l'ensemble git fetch && git rebase. Attention cependant lors du travail sur plusieurs branches.

Ceci permet de transformer l'état suivant (les ''O'' sont les commits, ''A'' le moment où les deux versions ont commencé à diverger, ''B'' la version du dépôt, ''E'' la version locale, ''C'' et ''D'' des commits locaux

-C--D--E
/
-O--A--O--B

En l'état plus propre :
-O--A--O--B--C'--D'--E'

Avec C, D et E convertis en C', D' et E' : ils ont été modifiés pour être des modifications relatives à B au lieu de A.

=== Pourquoi il ne faut JAMAIS utiliser git pull ===
Certains développeurs utilisent la commande ''git pull'' pour mettre à jour leur dépôt. Cette pratique est justifiée lorsque la copie de travail était propre (sans commit en attente de push entre autres), mais sinon, cela peut avoir des conséquences très graves et sales. En effet, ''git pull' est assimilé à la succession de commandes suivantes :
git fetch origin && git merge origin/master
Le problème est le merge. En reprenant les schémas précédents, cela transforme l'état suivant :

-C--D--E
/
-O--A--O--B

en :

-C--D--E
/ \
-O--A--O--B----M

où M est le commit ''de fusion de branches''. '''Cela est très moche et à éviter absolument'''. Si vous vous retrouvez dans cette suituation (pour vérifier : ''git log''), vous pouvez toujours tenter un ''git rebase origin/master'' qui peut fonctionner si le ''merge'' était trivial (sans conflit). Sinon, un ''git reset --hard origin/master'' s'impose pour assurer votre salut.

=== Sauvegarder des modifications locales (git stash) ===
Avant de faire un merge particulièrement délicat, ou si l'on doit résoudre un bug alors que l'on a pas mal de modifications non commitées en cours, il est parfois utile de sauvegarder l'état courant de la copie de travail.

Pour cela, il faut utiliser '''avant''' un changement (avec ''git rebase'' par exemple) :
git stash
Une fois les modifications effectuées, on peut restorer la copie locale à l'état sauvegardé avec :
git stash pop

== Effectuer un commit ==
Un '''commit''' est un ensemble de fichiers modifiés. Cela permet plus de cohérence dans le suivi des versions. Par exemple, si l'ajout d'une fonctionnalité sur Frankiz modifie les fichiers ''blah'', ''blih'' et ''bloh'', le ''commit'' regroupe les modifications de ces trois fichiers, et associe à cette modification une date et un auteur.

Pour effectuer un commit, il faut :
* Vérifier l'état de la copie de travail, pour ne commiter que ce qui est nécessaire
git status
git diff
* Indiquer à Git quels fichiers feront partie du commit ; ceci permet de ne committer que les modifications de quelques fichiers
git add path/to/blih path/to/blah path/to/bloh
* Vérifier que l'on a ajouté les fichiers que l'on voulait :
git status
* Faire le commit (le ''-s'' ajoute une ligne ''Signed of by'' dans le message, pour pouvoir retrouver plus efficacement l'auteur réel du commit)
git commit -s
* Cette commande ouvre un éditeur (vi, nano ou emacs selon la configuration de la variable EDITOR). Il faut alors entrer un bref descriptif du commit. '''Pour certains projets (dont Frankiz), les conventions de codage obligent les développeurs à écrire les descriptions en anglais.''' Il est un bon usage de s'adapter en conséquence, car un commit peut être refusé en production s'il est mal fait.
* Mettre à jour la copie locale avec le dépôt distant (cela décale le nouveau commit à la fin). '''IL NE FAUT SURTOUT PAS FAIRE DE git pull OU DE git merge ICI'''
git fetch
git rebase origin/master
* Transmettre les commits au dépôt d'origine
git push

La dernière commande provient du fait que git n'est pas centralisé : il n'envoie pas les modifications locales au dépôt parent spontanément.

Ceci permet de faire quelques modifications locales puis de n'envoyer cela au reste des développeurs que lorsque les modifications sont stables et complètes, par exemple.

== Gérer les branches ==
On peut voir la liste des branches accessibles avec :
git branch -a
* La ligne avec une étoile est la branche courante
* Les lignes blanches sont les branches ''locales'' (elles suivent généralement une branche distante)
* Les lignes rouges (si les couleurs sont activées) sont les branches distantes.

Pour récupérer une autre branche, il faut d'abord l'ajouter localement :
git checkout -b NomLocal origin/NomDistant

Cela aura également pour effet de basculer sur la branche NomLocal.
Les modifications que l'on avait effectuées sont bien entendu conservées.

Une fois la branche ajoutée, on peut basculer de branche en branche à l'aide de :
git checkout NomLocal

== Créer un dépôt ==
Contrairement à [[SVN]] où il faut installer un serveur subversion, créer un dépôt Git est très rapide : dans le dossier que l'on souhaite versionner, il suffit de taper
git init
Et voilà, le dossier est versionné : on peut donc commencer à faire des modifications, des commits, etc. (bien entendu, on ne peut pas ''pusher'' ses commits, puisqu'il n'y a pas de serveur distant).

Cette particularité rend Git très efficace pour versionner un petit projet, un exercice de TD, etc.

Pour créer un dépôt qui peut être cloné, il faut exécuter les commandes suivantes :
git init --bare mon_projet
cd mon_projet && git update-server-info

Enfin, pour configurer un serveur HTTP (gitweb), il ne faut pas oublier de créer un fichier vide '''git-daemon-export-ok''' dans le dossier, afin de permettre le clonage.

== Structure interne ==

Git stocke les commits de manière très particulière : un commit correspond à peu près à une sauvegarde de l'état des fichiers, à un message, et à une référence vers le commit parent.
Contrairemant à [[SVN]], il n'y a donc pas de notion de numéro de révision : chaque commit est identifié par une chaîne hexadécimale de 40 caractères (par exemple : ''04fd02e59b1bdc430c7a7dcc1ca9f4cbc2b04037'' )

Un ''tag'' est en fait un nom «lisible» donné à un ''commit'' ; une ''branche'' indique également le ''commit'' principal d'une branche.

== Du bon usage de gitignore ==
Dans un projet, il est inutile de versionner les fichiers temporaires et les fichiers compilés (qu'ils soient binaires ou non). On utilise généralement un Makefile pour créer ces fichiers. Pour éviter de les versionner, il suffit d'utiliser un fichier ''.gitignore'' bien placé. Généralement, chaque projet a un tel fichier dans son dossier principal. Voici par exemple un extrait du gitignore de Frankiz :
configs/frankiz.conf
htdocs/.htaccess
htdocs/data/*
htdocs/css/*
spool/*
upgrade/2.0.0_to_3.0.0/unversionned

== Configuration globale ==
Si vous avez déjà commitez, vous aurez certainement remarqué qu'il faut utiliser ''git config'' pour configurer vos informations personnelles. Ainsi, les deux premières commandes que tout utilisateur doit taper avant de faire un commit sont :
git config --global user.name "Prénom Nom de famille"
git config --global user.email "prenom.nom.promo@polytechnique.org"

Ensuite, si vous aimez les couleurs, vous avez envie de taper cette commande :
git config --global color.ui auto

Enfin, si vous en avez assez des projets qui ne mettent pas les fichiers temporaires dans le gitignore, vous pouvez configurer un fichier gitignore global. Si votre ''/home/user/.gitignore_global'' ressemble à
*~
*.swp
*.tmp
il suffit de taper :
git config --global core.excludesfile /home/user/.gitignore_global

Tout cela permet de gérer la configuration globale, visible par
git config --global -l
En enlevant ''--global'' dans toutes les commandes précédentes, on configure la copie locale.

=== Exemple de configuration ===
Voici un exemple de fichier ~/.gitconfig (qui stocke la configuration ''--global'', le même format peut être utilisé dans les fichier ''$REPO/.git/config'' de chaque dépot) :
[gc]
auto = 1
[color]
ui = true
[color "diff"]
whitespace = red reverse
[core]
whitespace=fix,-indent-with-non-tab,trailing-space,cr-at-eol
[alias]
st = status
ci = commit
br = branch
co = checkout
df = diff
dc = diff --cached
lg = log -p
lo = log --graph --decorate --pretty=oneline --abbrev-commit -n 10
lol = log --graph --decorate --pretty=oneline --abbrev-commit
lola = log --graph --decorate --pretty=oneline --abbrev-commit --all
ls = ls-files
# Show files ignored by git:
ign = ls-files -o -i --exclude-standard
amend = commit --amend -C HEAD
[branch]
autosetuprebase = always

== Utiliser le proxy de l'X avec Git ==
Si vous hébergez un projet sur [http://www.github.com GitHub], vous avez envie de dire à Git de se connecter à GitHub en SSH en passant par le proxy de l'X (qui est [http://kuzh.polytechnique.fr:8080 kuzh:8080]). Pour cela, il suffit de configurer le client SSH pour utiliser le proxy à chaque connexion vers github.com. Cela s'effecute par le fichier de configuration suivant dans /home/user/.ssh/config (adaptez avec votre dossier personnel)
Host github.com
ProxyCommand socat - PROXY:kuzh.polytechnique.fr:%h:%p,proxyport=8080

Si vous souhaitez utiliser le protocole git://, il faut utiliser socat, et créer un exécutable avec dedans :
#!/bin/sh
exec socat STDIO PROXY:129.104.247.2:$1:$2

Puis mettre cet executable dans la variable core.gitproxy :
git config --global core.gitproxy NOM_DU_FICHIER

N'oubliez pas d'enlever cette variable pour utiliser git en-dehors de l'X.

'''Si vous souhaitez uniquement cloner un dépôt GitHub''' dont vous n'êtes pas contributeur, il suffit d'utiliser le lien HTTPS en ligne de commande, en précisant le proxy.
export https_proxy=http://kuzh.polytechnique.fr:8080
git clone https://github.com/BinetReseau/frankiz.git

Finalement, si vous ne voulez pas vous connecter par ssh, mais vous souhaitez travailler normalement avec un depôt à l'extérieur de l'X, configurez git par le biais de ces commandes:
git config --global http.proxy http://kuzh.polytechnique.fr:8080
git config --global https.proxy http://kuzh.polytechnique.fr:8080

Cela va effectuer les modifications correspondantes sur le fichier ~/.gitconfig. '''N'oubliez pas de les enlever dès que vous n'êtes plus connectés au réseau de l'école, avec''':
git config --global --unset http.proxy http://kuzh.polytechnique.fr:8080

= Pour Windows =

Pour utiliser Git sur Windows, on peut par exemple télécharger MSys Git : [http://msysgit.github.com/ http://msysgit.github.com/].

[[Catégorie:Root]]

Frankiz

2013-04-18T16:13:50Z

Michel.blancard : ajout adresse git de plat/al et de frankiz

Frankiz est le portail interne des élèves.

La version actuelle (3) a été lancée par le BR2k8 juste avant son départ du plateau. Elle est principalement destinée à pouvoir ouvrir l'utilisation de Frankiz aux écoles arrivant progressivement sur le plateau, et à devenir ainsi un portail de la vie associative du campus.

Le code de Frankiz3 est libre, et utilise git comme système de versionnement.
Il est intégralement disponible à l'adresse suivante : http://dev.frankiz.net/ ou https://github.com/BinetReseau/frankiz
Le code de plat/al, le framework php utilisé par frankiz qui a été développé par polytechnique.org, est disponible ici : http://git.polytechnique.org/?p=platal.git;a=tree;hb=refs/heads/core/master

= Développement =

Les principaux projets de développement sont actuellement (juillet 2011) :
* l'élargissement effectif aux autres écoles, en travaillant notamment sur :
** la simplicité de création de nouveaux comptes, avec nomination de modérateurs dans chaque école
** le cloisonnement des données et la possibilité de définir des champs de visibilité
* la création de mini-forums qui remplaceraient à la fois les annonces et les newsgroups

== Outils pour les développeurs ==
=== Authentification sur des sites externes ===

Frankiz permet à des sites externes (binets en particulier) d'utiliser sa base de données pour authentifier les utilisateurs.

Le webmaster du site en question doit auparavant faire une demande de mise en place de ce système en envoyant un mail à l'équipe frankiz (frankiz@frankiz.polytechnique.fr).
Il doit alors donner :
* l'url complète de la page de login de son site
* les informations auxquelles il souhaite accéder
* une justification de la demande (et oui, on ne partage évidemment pas notre base de données avec n'importe qui !)

Si la demande est acceptée, l'équipe frankiz renvoie alors une clé permettant d'authentifier les échanges d'informations entre frankiz et le site externe.
Le site est alors inscrit dans notre base de données, et peut utiliser le système d'authentification externe.

Vous pouvez voir [[Authentification_Frankiz|un exemple de code]].

Accueil

2013-04-16T19:04:34Z

Michel.blancard : Qu'est-ce qui court et qui se jette??? Une courgette!

__NOTOC____NOEDITSECTION__
=== Bienvenue sur le site du BR ! ===

Le Binet Réseau est l'association d'étudiants de l'[http://www.polytechnique.fr École polytechnique] qui s'occupent du réseau élève : maintenance des serveurs, mise en place de nouveaux services et développement (applications réseau et sites).

L'InfoBR est disponible [http://br.binets.fr/files/InfoBR_2k12_final.pdf ici] ou [https://ik.frankiz.net/pdfs/ik/InfoBR_2k12_final.pdf ici] pour la version 2012, et [https://ik.frankiz.net/pdfs/ik/InfoBR.pdf ici] pour la version 2011.

L'InfoFrankiz est disponible [http://br.binets.fr/files/infoFrankiz.pdf ici]

<div style="float: left; width: 46%; margin: 0 1% 0 0;">
=Les ressources en ligne=
==Nos services==
* [[DNS|Le DNS des élèves]]
* [[MSDNAA|Le partenariat MSDNAA avec Microsoft]]
* [[Apple_on_Campus|Apple on Campus]]
* [[Serveur IRC|L'IRC sur le platal]]
* [[Miroir FTP|Le miroir FTP du BR]]
* [[TV|La TV dans les casert]]
* [[LDAP|L'annuaire LDAP (complétion automatique des adresses mail)]]
* [[Comptes_des_bars_élèves|Le site des bars d'etage]]
* [[Platalpad|L'édition collaborative de documents avec PlatalPad]]
* [[Hébergement_des_sites_des_binets|Hébergement des sites des binets]]
==Utilisation de nos services==
* [[Configuration du proxy|Comment configurer le proxy de l'X ?]]
* [[Configuration des clients pour le WiFi|Comment se connecter au WiFi ?]]
* [[Comptes Frankiz|Demander la création d'un compte Frankiz]]
* [[Diagnostic réseau|Comment diagnostiquer seul une panne du réseau ?]]
</div>

<div style="float: right; width: 46%; margin: 0 1%;-moz-box-shadow: 1px 1px 12px #AAA; -webkit-box-shadow: 1px 1px 12px #AAA; padding: 1em; margin-top: 1em;">
===Le BR recrute===
Les membres du Binet Réseau ne sont pas pour autant tous des férus d'informatique et se partagent les taches en fonction de leurs capacités et de leurs envies : relations avec nos partenaires, communication avec les élèves constituent aussi des postes essentiels.

Ainsi, le Binet Réseau offre une chance unique d'approfondir ses connaissances en informatique, au service des autres et en se faisant plaisir
----
=== Deviens un membre actif du BR ! ===
À n'importe quelle époque de l'année, viens nous voir et nous t'accueillerons à bras ouverts. Il y a toujours des choses à faire pour améliorer les services ou faire de nouveaux services.

==Fiches techniques==
* [[Recuperation de donnees perdues|Comment récupérer mes données que j'ai effacées sur mon disque dur ?]]
* [[Sauvegarde (ordinateur)|Comment faire une sauvegarde complète de mon système Windows ?]]
* [[Git|Comment utiliser Git ? (Pour les projets en équipe)]]
* [[Astuces_ssh|Utiliser la protection ssh]]
</div>
<div style="clear:both;"></div>

=N'hésite pas à nous contacter=
{| class="tableau-support"
| valign="top" |{{block|Par mail|support mail|Edit.png}}
| valign="top" |{{block|Au téléphone|support téléphone|Phone.png}}
| valign="top" |{{block|Sur IRC|support irc|Serveur.png}} {{block|En vrai|support vrai|People.png}}
|}

Accueil

2013-04-16T19:03:51Z

Michel.blancard :

__NOTOC____NOEDITSECTION__
=== Bienvenue sur le site du BR ! ===

Le Binet Réseau est l'association d'étudiants de l'[http://www.polytechnique.fr École polytechnique] qui s'occupent du réseau élève : maintenance des serveurs, mise en place de nouveaux services et développement (applications réseau et sites).

L'InfoBR est disponible [http://br.binets.fr/files/InfoBR_2k12_final.pdf ici] ou [https://ik.frankiz.net/pdfs/ik/InfoBR_2k12_final.pdf ici] pour la version 2012, et [https://ik.frankiz.net/pdfs/ik/InfoBR.pdf ici pour la version 2011].

L'InfoFrankiz est disponible [http://br.binets.fr/files/infoFrankiz.pdf ici]

<div style="float: left; width: 46%; margin: 0 1% 0 0;">
=Les ressources en ligne=
==Nos services==
* [[DNS|Le DNS des élèves]]
* [[MSDNAA|Le partenariat MSDNAA avec Microsoft]]
* [[Apple_on_Campus|Apple on Campus]]
* [[Serveur IRC|L'IRC sur le platal]]
* [[Miroir FTP|Le miroir FTP du BR]]
* [[TV|La TV dans les casert]]
* [[LDAP|L'annuaire LDAP (complétion automatique des adresses mail)]]
* [[Comptes_des_bars_élèves|Le site des bars d'etage]]
* [[Platalpad|L'édition collaborative de documents avec PlatalPad]]
* [[Hébergement_des_sites_des_binets|Hébergement des sites des binets]]
==Utilisation de nos services==
* [[Configuration du proxy|Comment configurer le proxy de l'X ?]]
* [[Configuration des clients pour le WiFi|Comment se connecter au WiFi ?]]
* [[Comptes Frankiz|Demander la création d'un compte Frankiz]]
* [[Diagnostic réseau|Comment diagnostiquer seul une panne du réseau ?]]
</div>

<div style="float: right; width: 46%; margin: 0 1%;-moz-box-shadow: 1px 1px 12px #AAA; -webkit-box-shadow: 1px 1px 12px #AAA; padding: 1em; margin-top: 1em;">
===Le BR recrute===
Les membres du Binet Réseau ne sont pas pour autant tous des férus d'informatique et se partagent les taches en fonction de leurs capacités et de leurs envies : relations avec nos partenaires, communication avec les élèves constituent aussi des postes essentiels.

Ainsi, le Binet Réseau offre une chance unique d'approfondir ses connaissances en informatique, au service des autres et en se faisant plaisir
----
=== Deviens un membre actif du BR ! ===
À n'importe quelle époque de l'année, viens nous voir et nous t'accueillerons à bras ouverts. Il y a toujours des choses à faire pour améliorer les services ou faire de nouveaux services.

==Fiches techniques==
* [[Recuperation de donnees perdues|Comment récupérer mes données que j'ai effacées sur mon disque dur ?]]
* [[Sauvegarde (ordinateur)|Comment faire une sauvegarde complète de mon système Windows ?]]
* [[Git|Comment utiliser Git ? (Pour les projets en équipe)]]
* [[Astuces_ssh|Utiliser la protection ssh]]
</div>
<div style="clear:both;"></div>

=N'hésite pas à nous contacter=
{| class="tableau-support"
| valign="top" |{{block|Par mail|support mail|Edit.png}}
| valign="top" |{{block|Au téléphone|support téléphone|Phone.png}}
| valign="top" |{{block|Sur IRC|support irc|Serveur.png}} {{block|En vrai|support vrai|People.png}}
|}

Accueil

2013-04-16T19:03:27Z

Michel.blancard : lien infobr

__NOTOC____NOEDITSECTION__
=== Bienvenue sur le site du BR ! ===

Le Binet Réseau est l'association d'étudiants de l'[http://www.polytechnique.fr École polytechnique] qui s'occupent du réseau élève : maintenance des serveurs, mise en place de nouveaux services et développement (applications réseau et sites).

L'InfoBR est disponible [http://br.binets.fr/files/InfoBR_2k12_final.pdf ici] ou [https://ik.frankiz.net/pdfs/ik/InfoBR_2k12_final.pdf ici pour la version 2012], et [https://ik.frankiz.net/pdfs/ik/InfoBR.pdf ici pour la version 2011].

L'InfoFrankiz est disponible [http://br.binets.fr/files/infoFrankiz.pdf ici]

<div style="float: left; width: 46%; margin: 0 1% 0 0;">
=Les ressources en ligne=
==Nos services==
* [[DNS|Le DNS des élèves]]
* [[MSDNAA|Le partenariat MSDNAA avec Microsoft]]
* [[Apple_on_Campus|Apple on Campus]]
* [[Serveur IRC|L'IRC sur le platal]]
* [[Miroir FTP|Le miroir FTP du BR]]
* [[TV|La TV dans les casert]]
* [[LDAP|L'annuaire LDAP (complétion automatique des adresses mail)]]
* [[Comptes_des_bars_élèves|Le site des bars d'etage]]
* [[Platalpad|L'édition collaborative de documents avec PlatalPad]]
* [[Hébergement_des_sites_des_binets|Hébergement des sites des binets]]
==Utilisation de nos services==
* [[Configuration du proxy|Comment configurer le proxy de l'X ?]]
* [[Configuration des clients pour le WiFi|Comment se connecter au WiFi ?]]
* [[Comptes Frankiz|Demander la création d'un compte Frankiz]]
* [[Diagnostic réseau|Comment diagnostiquer seul une panne du réseau ?]]
</div>

<div style="float: right; width: 46%; margin: 0 1%;-moz-box-shadow: 1px 1px 12px #AAA; -webkit-box-shadow: 1px 1px 12px #AAA; padding: 1em; margin-top: 1em;">
===Le BR recrute===
Les membres du Binet Réseau ne sont pas pour autant tous des férus d'informatique et se partagent les taches en fonction de leurs capacités et de leurs envies : relations avec nos partenaires, communication avec les élèves constituent aussi des postes essentiels.

Ainsi, le Binet Réseau offre une chance unique d'approfondir ses connaissances en informatique, au service des autres et en se faisant plaisir
----
=== Deviens un membre actif du BR ! ===
À n'importe quelle époque de l'année, viens nous voir et nous t'accueillerons à bras ouverts. Il y a toujours des choses à faire pour améliorer les services ou faire de nouveaux services.

==Fiches techniques==
* [[Recuperation de donnees perdues|Comment récupérer mes données que j'ai effacées sur mon disque dur ?]]
* [[Sauvegarde (ordinateur)|Comment faire une sauvegarde complète de mon système Windows ?]]
* [[Git|Comment utiliser Git ? (Pour les projets en équipe)]]
* [[Astuces_ssh|Utiliser la protection ssh]]
</div>
<div style="clear:both;"></div>

=N'hésite pas à nous contacter=
{| class="tableau-support"
| valign="top" |{{block|Par mail|support mail|Edit.png}}
| valign="top" |{{block|Au téléphone|support téléphone|Phone.png}}
| valign="top" |{{block|Sur IRC|support irc|Serveur.png}} {{block|En vrai|support vrai|People.png}}
|}

Authentification Frankiz

2013-04-14T20:17:28Z

Michel.blancard : clarification, mise a jour adresse mail

Frankiz permet à des sites externes (binets en particulier) d'utiliser sa base de données pour authentifier les utilisateurs.

Le webmaster du site en question doit auparavant faire une demande de mise en place de ce système en envoyant un mail à l'équipe frankiz ([mailto:web@eleves.polytechnique.fr web@eleves.polytechnique.fr]).
Il doit alors donner :
* l'url complète de la page de login de son site
* les informations auxquelles il souhaite accéder
* une justification de la demande (et oui, on ne partage évidemment pas notre base de données avec n'importe qui !)

Si la demande est acceptée, un web va alors inscrire ton site dans notre base de donnée de sites externes et générer une clé qu'il va te communiquer. Cette opération se déroule via l'interface d'administration de frankiz. Cette clé va te permettre d'authentifier les échanges d'informations entre frankiz et le site externe.

Ci dessous un exemple commenté de script d'authentification, à mettre sur le site externe :

==Code de la page d'identification==

<code php>
<?php
include 'fkz_auth.php';
if(!isset($_GET['response'])){
frankiz_do_auth();
}
$auth = frankiz_get_response();
// et voila !
// les données sont stockées dans $auth = array(key => value, ...);
</code>

==Code des fonctions utilisées dans ''fkz_auth.php''==

<code php>

<?php
/**
* Clé secrète fournie par l'équipe frankiz lors de l'inscription du site.
* Cette clé sert à signer les requêtes et à authentifier le site.
*/
$FKZ_KEY = "000";

function frankiz_do_auth(){
global $FKZ_KEY;
/**
* Prendre le timestamp permet d'éviter le rejeu de la requête
*/
$timestamp = time();
/**
* url de la page de login, doit correspondre *exactement* à celle entrée dans
* la base de données de Frankiz (définie lors de l'inscription)
*/
$site = 'http://monsite/login';
/**
* Champ non utile pour l'authentification et retransmis tel quel par frankiz.
* Il est prévu pour pouvoir mettre en place un système de redirection après
* authentification, vers la page à partir de laquelle le client avait tenté de se connecter.
*/
$location = "..."
/**
* Nature de la requête.
* Fkz renverra ici à la fois les noms de la personne mais aussi ses droits dans différents groupes.
* Il faut cependant que le site ait les droits sur les informations en question (à définir lors de son inscription).
*/
$request = json_encode(array('names', 'rights', 'email', 'sport', 'promo', 'photo'));

$hash = md5($timestamp . $site . $FKZ_KEY . $request);

$remote = 'https://www.frankiz.net/remote?timestamp=' . $timestamp .
'&site=' . $site .
'&location=' . $location .
'&hash=' . $hash .
'&request=' . $request;
header("Location:" . $remote);
exit();
}

function frankiz_get_response(){
global $FKZ_KEY;
// Read request
$timestamp = (isset($_GET['timestamp']) ? $_GET['timestamp'] : 0);
$response = (isset($_GET['response']) ? urldecode($_GET['response']) : '');
$hash = (isset($_GET['hash']) ? $_GET['hash'] : '');
$location = (isset($_GET['location']) ? $_GET['location'] : '');

// Frankiz security protocol
if (abs($timestamp - time()) > 600)
die("Délai de réponse dépassé. Annulation de la requête");
if (md5($timestamp . $FKZ_KEY . $response) != $hash)
die("Session compromise.");

$response = json_decode($response, true);
$response['location'] = $location;

// Set empty fields
$fields = array('hruid',
'firstname', 'lastname', 'nickname',
'promo', 'photo', 'location');
foreach ($fields as $k) {
if (!isset($response[$k]))
$response[$k] = '';
}
return $response;
}
?>
</code>

==Bugs vécu==

Si authentification fonctionne sur certains navigateurs, vérifier les variables $_GET car elles sont peut être doublement encodées. Dans ce cas, soit refaire '''urldecode''', soit un
$s = str_replace('%22','"',$s);
Si il y a un problème avec les encodages en \u''machinchose'' pour les caractères accentués, voila une fonction qui peut vous servir (reconversion en UTF-8) :
function jsonClean($s) {
return preg_replace("/\\\\u([a-f0-9]{4})/e", "iconv('UCS-4LE','UTF-8',pack('V', hexdec('U$1')))",$s);
}

[[Catégorie:Dev]]

Screen et IRC

2013-04-13T14:23:32Z

Michel.blancard : /* ~/.irssi/config */

{{menu IRC}}

== Introduction ==
C'est important de venir sur IRC chatter avec les membres du BR. Cela permet de discuter avec les autres BRmen, ce qui en plus d'être sympathique, est quand même quelque chose de parfois fondamental dans le travail de BRmen (quel qu'il soit), et donc dans le bon fonctionnement du BR de manière plus générale. Par ailleurs, on peut y trouver des anciens souvent disponibles, qui sont assez pratiques lorsqu'on a des questions. Le but de cet article est d'expliquer comment utiliser IRC comme un vrai BRman (ou une vraie BRwoman).

=== screen ? moaz ? IRC ? Petit tour d'horizon pour ceux qui sont déjà perdus ===

Tu peux trouver plus d'infos sur l'utilisation d'IRC à l'X [http://wikix.polytechnique.org/IRC sur le WikiX] ; voici juste un résumé de ce qui est utile à savoir : pour utiliser IRC, il faut se connecter à un serveur (ici, le serveur IRC du BR) par un logiciel que l'on appelle un client IRC. Les gens normaux utilisent un client IRC directement sur leur ordinateur pour se connecter à un serveur IRC (''cf'' la page du WikiX) ; mais au BR, on fait ça de façon un peu plus contournée mais beaucoup plus pratique - comme tu le verras par la suite. D'où cette page qui sert à expliquer cette méthode, dont je te conseille l'utilisation, quel que soit ton degré d'affinité avec les ordinateurs - elle n'est pas plus compliquée que la méthode normale et le gain est énorme.

Continuons notre tour d'horizon : screen est un logiciel qui permet de laisser fonctionner une session sur une machine distante, même lorsqu'on n'est plus en train d'utiliser cette machine (entre autres et en un peu simplifié, mais c'est cette fonctionnalité précise qui nous intéressera ici). L'idée, en l'occurrence, c'est de pouvoir laisser tourner un client IRC sur une machine du BR (et pas sur son ordinateur !), de façon à ne pas se déconnecter d'IRC lorsqu'on éteint son ordi (puisque le client IRC est sur la machine du BR, et pas sur son ordi personnel). On se connecte alors à la machine du BR pour utiliser le client IRC qui y tourne ; donc en gros, tout se déroule comme si on utilisait un client IRC sur son ordinateur, sauf qu'on utilise à la place un logiciel pour se connecter à une machine du BR et utiliser le client IRC qui fonctionne déjà sur cette machine, avec l'avantage que cette machine là ne s'éteint jamais (en principe). Cet avantage te parait peut-être minime, mais il est en fait assez fondamental : comme tout le monde n'est pas devant son ordinateur en même temps, il permet de pouvoir tenir des discussions sur IRC sans avoir à se déconnecter en plein milieu de la discussion parce qu'on va en cours ou parce que son ordi ne marche plus ; par ailleurs, de façon équivalente, il permet de garder l'historique des conversations à disposition sans passer par les logs. Enfin, de plus, il permet aussi de pouvoir accéder au client IRC par n'importe quel ordinateur qui peut se connecter à la machine du BR (donc n'importe quel ordinateur qui se trouve sur le platâl, ou même un smartphone qui se connecte via le wi-fi de la DSI... c'est une façon comme une autre de s'occuper en conf DFHM), et retrouver ainsi ses discussions sur IRC même si on utilise pas son propre ordinateur (enfin, il faut quand même faire attention lorsqu'on utilise un ordinateur public).

Et pour finir, moaz, c'est le petit nom de la machine du BR qui va héberger ton screen et ton client IRC persistant, et à laquelle tu vas se connecter pour les retrouver. Ainsi, pour résumer ce tour d'horizon, créer un screen sur moaz, cela te permet de laisser tourner ton client IRC (en l'occurrence irssi) tout le temps, et y accéder quand tu veux (voire d'où tu veux).

== Se connecter sur moaz ==

La connexion à moaz est la première étape à suivre. Pour se connecter à moaz, il y faut un compte ; en principe, on te l'a déjà créé, et si ce n'est pas le cas (ou si tu n'en sais rien), contacte un root (genre ton prez, il aime ça). Maintenant, la procédure pour se connecter à moaz est très simple et tu l'as peut-être même déjà suivie dans un autre cadre : il s'agit rigoureusement de la même que celle expliquée [http://wikix.polytechnique.org/eleves/wikix/Acc%C3%A8s_%C3%A0_distance_aux_ordinateurs_des_salles_info ici] pour accéder en ssh (''id est'' juste ouvrir une console) à un ordi des salles infos, sauf qu'à la place du nom de l'ordinateur de la salle info tu mets "moaz". Donc avec windows cela revient juste à lancer PuTTY, taper "moaz" pour le nom d'hôte, vérifier que le mode de connexion "SSH" est bien sélectionné, et cliquer sur "Open" ; sous Linux, cela revient à taper <code>ssh nom_d_utilisateur_sur_moaz@moaz</code> ; sous mac, je te laisse deviner.

== Utilisation de screen avec irssi ==

Une fois connecté sur moaz, lance screen. On arrive à une petite subtilité. Comme tu le sais maintenant, screen permet de lancer une session qui continue d'exister sur moaz une fois qu'on soit parti ; donc si tu as déjà lancé screen avant, et que tu te connectes sur moaz plus tard, il ne faut pas le lancer une seconde fois, il faut rejoindre la session déjà lancée. Par contre si tu n'as jamais lancé screen avant, il faut bien créer une session...

La commande suivante fait ce qu'il faut : si le screen <nowiki>irc</nowiki> (on pourrait choisir d'appeler son screen n'importe comment, ou de ne pas le nommer) n'existe pas, il est crée ; si le screen existe on le ré-attache (on le rejoint).
<nowiki>$ screen -RDU irc</nowiki>

Ceci étant fait, tu es maintenant dans ta session screen ; partant de là, soit tu vois déjà IRC (si tu as rejoins une session qui existait déjà, et où irssi était déjà lancé, ce qui devrait généralement être le cas), soit tu ne vois pas IRC (si tu viens de lancer screen pour la première fois) et pour le lancer il te suffit de taper
<nowiki>$ irssi</nowiki>

Et hop, maintenant tu es connecté à IRC ! Bienvenue !

== Déconnexion ==

Lorsqu'on souhaite se déconnecter de moaz (pour redémarrer son ordi perso par exemple), il faut "détacher" le screen, avec C-a d (ça veut dire appuyer sur Ctrl et a en même temps, relâcher, puis appuyer sur d), ce qui ramène à la console de moaz depuis laquelle on peut fermer la session sur moaz (avec C-d sous linux, plus prosaïquement en fermant PuTTY sous Windows). La session screen et donc le client IRC irssi continuent alors à tourner sur moaz alors qu'on est déconnecté. Pour revenir, il suffit de se reconnecter à moaz puis de rejoindre le screen (mais tu sais déjà faire tout cela, non ?).

== Résumé ==

Si tu as déjà compris le principe d'utiliser screen et de te connecter à IRC et tout, ou si tu t'en fous et que tu veux juste aller vite, voici un résumé des actions à faire pour se connecter à IRC :
# Se connecter à moaz (PuTTY / <code>$ssh login@moaz</code> / ...)
# Rattacher ( = rejoindre) ta session screen avec <code>$ screen -RD irc</code>
# Éventuellement, lancer irssi avec <code>$ irssi</code> s'il n'est pas déjà en train de tourner
# Enjoy chatting

== Articles connexes ==

La page [[:screen]] contient des informations plus détaillées sur screen.

== Références externes ==

* [http://quadpoint.org/articles/irssi/ http://quadpoint.org/articles/irssi/] A Guide to Efficiently Using Irssi and Screen. Cette page contient les informations pour créer une fenêtre de highlight :

/window new split
/window name hilight
/window size 6

OU :
/window new hidden
/window name hilight

== Fichiers de config ==
Voilà des fichiers de config pour irssi et screen :
===~/.screenrc===
bell_msg "^G Bell in window %n"
autodetach on
startup_message off
nonblock on
vbell on
defutf8 on
defscrollback 1000

caption always
hardstatus string "%?%F%{= kG}%:%{= Wk}%? [$USER@%H] %n : %t"

# Always show lastline
caption string "%{= g}[ %{G}${USER}@%H%{g} ][%= %{= w}%?%-Lw%?%{r}(%{W}%n*%f %t%?(%u)%?%{r})%{w}%?%+Lw%?%?%= %{g}][%{B} %d/%m %{W}%c:%s %{g}][%{Y}%l%{g}]%{=b C}%{W}"

# Allow scrollback in xterm
termcap xterm* LP
termcapinfo xterm ti@:te@

===~/.irssi/config===
servers = (
{
address = "ircserver";
chatnet = "RezoSup";
port = "6767";
use_ssl = "yes";
ssl_verify = "no";
autoconnect = "yes";
no_proxy = "yes";
},
{
address = "irc.freenode.net";
chatnet = "FreeNode";
port = "6667";
autoconnect = "yes";
}
);

chatnets = {
RezoSup = {
type = "IRC";
nick = "Arthur";
autosendcmd = "/^msg nickserv IDENTIFY ******;";
};
FreeNode = {
type = "IRC";
nick = "ArthurD";
autosendcmd = "/^msg nickserv identify ******;";
};
};

channels = (
{ name = "#root-br"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#br-actif"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#br2k9"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#frankiz"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#news-br"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#web-br"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#br"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#irc-br"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#opers"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#x"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#federez"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#ascii"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#admin-windows"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#infobr"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#xnet"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#ailleurs"; chatnet = "RezoSup"; autojoin = "yes"; },
#TODO:Check if wanted#

# { name = "#poly.org"; chatnet = "Freenode"; autojoin = "yes"; },
{ name = "#archlinux"; chatnet = "RezoSup"; autojoin = "yes"; },
{ name = "#archlinux-fr"; chatnet = "Freenode"; autojoin = "yes"; },
# { name = "#gentoo"; chatnet = "Freenode"; autojoin = "yes"; }
# { name = "#physique"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#bural-br"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#resel"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#boulets"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#pi_perceptron"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#pendaison"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#br-vieux"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#br-private"; chatnet = "RezoSup"; autojoin = "yes"; },
# { name = "#channel"; chatnet = "freenode"; autojoin = "yes"; },
);

aliases = {
J = "join";
WJOIN = "join -window";
WQUERY = "query -window";
LEAVE = "part";
BYE = "quit";
EXIT = "quit";
SIGNOFF = "quit";
DESCRIBE = "action";
DATE = "time";
HOST = "userhost";
LAST = "lastlog";
SAY = "msg *";
WI = "whois";
WII = "whois $0 $0";
WW = "whowas";
W = "who";
N = "names";
M = "msg";
T = "topic";
C = "clear";
CL = "clear";
K = "kick";
KB = "kickban";
KN = "knockout";
BANS = "ban";
B = "ban";
MUB = "unban *";
UB = "unban";
IG = "ignore";
UNIG = "unignore";
SB = "scrollback";
UMODE = "mode $N";
WC = "window close";
WN = "window new hide";
SV = "say Irssi $J ($V) - http://irssi.org/";
GOTO = "sb goto";
CHAT = "dcc chat";
RUN = "SCRIPT LOAD";
UPTIME = "eval exec - expr `date +%s` - \\$F | awk '{print \"Irssi uptime: \"int(\\\\\\$1/3600/24)\"d \"int(\\\\\\$1/3600%24)\"h \"int(\\\\\\$1/60%60)\"m \"int(\\\\\\$1%60)\"s\" }'";
CALC = "exec - if which bc &>/dev/null\\; then echo '$*' | bc | awk '{print \"$*=\"$$1}'\\; else echo bc was not found\\; fi";
SBAR = "STATUSBAR";
INVITELIST = "mode $C +I";
Q = "QUERY";
"MANUAL-WINDOWS" = "set use_status_window off;set autocreate_windows off;set autocreate_query_level none;set autoclose_windows off;set reuse_unused_windows on;save";
EXEMPTLIST = "mode $C +e";
ATAG = "WINDOW SERVER";
ADDALLCHANNELS = "script exec foreach my \\$channel (Irssi::channels()) { Irssi::command(\"channel add -auto \\$channel->{name} \\$channel->{server}->{tag} \\$channel->{key}\")\\;}";
};

statusbar = {
# formats:
# when using {templates}, the template is shown only if it's argument isn't
# empty unless no argument is given. for example {sb} is printed always,
# but {sb $T} is printed only if $T isn't empty.
items = {
# start/end text in statusbars
barstart = "{sbstart}";
barend = "{sbend}";
topicbarstart = "{topicsbstart}";
topicbarend = "{topicsbend}";
# treated "normally", you could change the time/user name to whatever
time = "{sb $Z}";
user = "{sb {sbnickmode $cumode}$N{sbmode $usermode}{sbaway $A}}";
# treated specially .. window is printed with non-empty windows,
# window_empty is printed with empty windows
window = "{sb $winref:$itemname{sbmode $M}}";
window_empty = "{sb $winref{sbservertag $tag}}";
prompt = "{prompt $[.15]itemname}";
prompt_empty = "{prompt $winname}";
topic = " $topic";
topic_empty = " Irssi v$J - http://irssi.org/help/";
# all of these treated specially, they're only displayed when needed
lag = "{sb Lag: $0-}";
act = "{sb Act: $0-}";
more = "-- more --";
};
# there's two type of statusbars. root statusbars are either at the top
# of the screen or at the bottom of the screen. window statusbars are at
# the top/bottom of each split window in screen.

default = {
# the "default statusbar" to be displayed at the bottom of the window.
# contains all the normal items.
window = {
disabled = "no";
# window, root
type = "window";
# top, bottom
placement = "bottom";
# number
position = "1";
# active, inactive, always
visible = "active";
# list of items in statusbar in the display order
items = {
barstart = { priority = "100"; };
time = { };
user = { };
window = { };
window_empty = { };
lag = { priority = "-1"; };
more = { priority = "-1"; alignment = "right"; };
barend = { priority = "100"; alignment = "right"; };
usercount = { };
};
};
# statusbar to use in inactive split windows
window_inact = {
type = "window";
placement = "bottom";
position = "1";
visible = "inactive";
items = {
barstart = { priority = "100"; };
window = { };
window_empty = { };
more = { priority = "-1"; alignment = "right"; };
barend = { priority = "100"; alignment = "right"; };
};
};
# we treat input line as yet another statusbar :) It's possible to
# add other items before or after the input line item.
prompt = {
type = "root";
placement = "bottom";
# we want to be at the bottom always
position = "100";
visible = "always";
items = {
prompt = { priority = "-1"; };
prompt_empty = { priority = "-1"; };
# treated specially, this is the real input line.
input = { priority = "10"; };
};
};
# topicbar
topic = {
type = "root";
placement = "top";
position = "1";
visible = "always";
items = {
topicbarstart = { priority = "100"; };
topic = { };
topic_empty = { };
topicbarend = { priority = "100"; alignment = "right"; };
};
};
awl_0 = {
items = {
barstart = { priority = "100"; };
awl_0 = { };
barend = { priority = "100"; alignment = "right"; };
};
};
};
};

settings = {
core = {
real_name = "Arthur Darcet";
user_name = "Arthur";
nick = "Arthur";
recode = "yes";
recode_autodetect_utf8 = "yes";
recode_out_default_charset = "UTF-8";
recode_fallback = "CP1252";
server_reconnect_time = "10";
quit_message = "";
timestamp_format = "%d|%H:%M:%S";
# use_proxy = "yes";
# proxy_address = "129.104.247.2";
# proxy_port = "8080";
# proxy_string = "CONNECT %s:%d HTTP/1.0\012\012";
};
"fe-common/core" = {
autolog = "yes";
autolog_path = "~/irclogs/%Y/$tag-$0-%m-%d.log";
term_charset = "utf-8";
timestamps = "yes";
show_nickmode = "yes";
show_nickmode_empty = "yes";
theme = "mytheme";
bell_beeps = "yes";
beep_msg_level = "HILIGHT";
beep_when_window_active = "yes";
beep_when_away = "yes";
completion_char = " :";
};
"irc/core" = { lag_max_before_disconnect = "300"; knockout_time = "5"; };
"fe-text" = { indent = "8"; actlist_sort = "refnum"; };
"perl/core/scripts" = {
autorejoin_channels = "#root-br #br2k9 #br #x #news-br #frankiz #web-br #br-actif #federez #ascii #archlinux #archlinux-fr";
nicklist_automode = "screen";
awl_display_nokey_active = "$Q:$H$C$S";
awl_display_key = "$Q|$H$C$S";
awl_display_key_active = "$Q:$H$C$S";
awl_display_nokey = "$Q|$H$C$S";
};
};

hilights = (
# { text = "root"; nick = "yes"; word = "yes"; fullword = "no"; },
# {
# text = "CRIT";
# color = "%Y";
# nick = "no";
# word = "yes";
# fullword = "yes";
# channels = ( "#root-br" );
# },
# { text = "magnan"; nick = "yes"; word = "yes"; fullword = "yes"; },
{ text = "root"; nick = "yes"; word = "yes"; fullword = "yes"; },
{ text = "2k9"; nick = "yes"; word = "yes"; fullword = "yes"; },
{ text = "2009"; nick = "yes"; word = "yes"; fullword = "yes"; }
);

keyboard = (
{ key = "meta-a"; id = "change_window"; data = "2"; },
{ key = "meta-z"; id = "change_window"; data = "3"; },
{ key = "meta-e"; id = "change_window"; data = "4"; },
{ key = "meta-r"; id = "change_window"; data = "5"; },
{ key = "meta-t"; id = "change_window"; data = "6"; },
{ key = "meta-y"; id = "change_window"; data = "7"; },
{ key = "meta-u"; id = "change_window"; data = "8"; },
{ key = "meta-i"; id = "change_window"; data = "9"; },
{ key = "meta-o"; id = "change_window"; data = "10"; },
{ key = "meta-p"; id = "change_window"; data = "11"; },
{ key = "meta-q"; id = "change_window"; data = "12"; },
{ key = "meta-s"; id = "change_window"; data = "13"; },
{ key = "meta-d"; id = "change_window"; data = "14"; },
{ key = "meta-f"; id = "change_window"; data = "15"; },
{ key = "meta-g"; id = "change_window"; data = "16"; },
{ key = "meta-h"; id = "change_window"; data = "17"; },
{ key = "meta-j"; id = "change_window"; data = "18"; },
{ key = "meta-k"; id = "change_window"; data = "19"; },
{ key = "meta-l"; id = "change_window"; data = "20"; },
{ key = "meta-m"; id = "change_window"; data = "21"; }
{ key = "meta-w"; id = "change_window"; data = "20"; },
{ key = "meta-x"; id = "change_window"; data = "20"; },
{ key = "meta-c"; id = "change_window"; data = "20"; },
{ key = "meta-v"; id = "change_window"; data = "20"; },
{ key = "meta-b"; id = "change_window"; data = "20"; },
{ key = "meta-n"; id = "change_window"; data = "20"; },
{ key = "meta-A"; id = "change_window"; data = "20"; },
{ key = "meta-Z"; id = "change_window"; data = "20"; },
{ key = "meta-E"; id = "change_window"; data = "20"; },
{ key = "meta-R"; id = "change_window"; data = "20"; },
{ key = "meta-T"; id = "change_window"; data = "20"; },
{ key = "meta-Y"; id = "change_window"; data = "20"; },
{ key = "meta-U"; id = "change_window"; data = "20"; },
{ key = "meta-I"; id = "change_window"; data = "20"; },
{ key = "meta-O"; id = "change_window"; data = "20"; },
{ key = "meta-P"; id = "change_window"; data = "20"; },
{ key = "meta-Q"; id = "change_window"; data = "20"; },
{ key = "meta-S"; id = "change_window"; data = "20"; },
{ key = "meta-D"; id = "change_window"; data = "20"; },
{ key = "meta-F"; id = "change_window"; data = "20"; },
{ key = "meta-G"; id = "change_window"; data = "20"; },
{ key = "meta-H"; id = "change_window"; data = "20"; },
{ key = "meta-J"; id = "change_window"; data = "20"; },
{ key = "meta-K"; id = "change_window"; data = "20"; },
{ key = "meta-L"; id = "change_window"; data = "20"; },
{ key = "meta-M"; id = "change_window"; data = "20"; },
{ key = "meta-N"; id = "change_window"; data = "20"; },
{ key = "meta-O"; id = "change_window"; data = "20"; },
{ key = "meta-P"; id = "change_window"; data = "20"; },
{ key = "meta-W"; id = "change_window"; data = "20"; },
{ key = "meta-X"; id = "change_window"; data = "20"; },
{ key = "meta-C"; id = "change_window"; data = "20"; },
{ key = "meta-V"; id = "change_window"; data = "20"; },
{ key = "meta-B"; id = "change_window"; data = "20"; },
{ key = "meta-N"; id = "change_window"; data = "20"; }
);

logs = { };
ignores = ( );

[[Catégorie:IRC]]

Serveur IRC

2013-04-13T14:21:41Z

Michel.blancard : liens inutiles

{{menu services}}
{{menu IRC}}

IRC, ou Internet Relay Chat, est un protocole de dialogue qui permet de se connecter à un réseau de serveurs IRC sur lequel peuvent être connectées de nombreuses personnes (comme Undernet, EFNet ou Rezosup \o/).

Une fois connecté au réseau grâce à ce client, tu pourras rejoindre (ou créer) un salon de discussion, appelé channel, sur lequel peuvent se connecter a priori toutes les personnes connectées au serveur. Cela fait d'IRC un moyen bien pratique pour permettre aux communautés de se retrouver en direct, et en particulier à l'X !

L'école dispose d'un serveur relié au réseau Rezosup, regroupant de nombreuses écoles et universités francaises. Il y a donc un channel #x, un channel #polytech, et même certains channels de binets sur ce réseau.

== Configuration ==
* serveur : '''irc''' ou '''ircserver''' (irc.eleves.polytechnique.fr/ircsever.eleves.polytechnique.fr)
* port 6667 : connexion non sécurisée
* port 6767 : connexion SSL

[[Catégorie:Services]]
[[Catégorie:IRC]]

Aide utilisateur IRC

2013-04-10T12:20:40Z

Michel.blancard : quelques lignes

{{menu IRC}}

EN COURS D'ECRITURE (02/04/13)

Cette page vous explique comment configurer IRC lorsque vous devenez un utilisateur plus régulier, et voulez protéger votre pseudo, créer un canal sous votre nom, acquérir des droits, etc.

== Préliminaires ==

Pour parler aux serveurs qui gèrent les identités et les chans (respectivement nickserv et chanserv), il faut ouvrir un nouvelle conversation avec la commande '''/query nom_du_serveur'''. Plus rapide : '''/msg nom_du_serveur commande''' qui ouvre quand même une fenêtre, ou '''/^msg nom_du_serveur commande''' qui n'ouvre pas de fenêtre mais ne donne pas de réponse. Tu peux pas exemple demander de l'aide à nickserv en tapant la commande '''/msg nickserv help'''.

Pour fermer la fenêtre lorsqu'elle n'est plus utile, tape "/wc".

== Créer un compte utilisateur ==
C'est le premier pas vers l'utilisation des services.

Pour lancer l'enregistrement, connecte toi sous ce pseudo (ou tape /nick pseudo pour en changer).

Puis envoie à nickserv la commande '''register *password* *email*'''

Tu devrais recevoir un mail rapidement avec la dernière commande à rentrer pour valider l'enregistrement.

== Utiliser son compte ==

Tu dois ensuite envoyer à nickserv la commande '''identify mot_de_passe''' pour être reconnu. Ensuite tu peux par exemple donner la commande '''invite #br-securite''' à chanserv, puis taper '''/join #br-securite''' si tu en a les droits pour joindre le chan #br-securite.

== Gérer un canal ==
=== Fonder un canal ===

=== Gérer les droits d'un canal ===

=== Configurer les options d'un canal ===

=== Commandes utiles ===

== Besoin d'aide ? ==
Une question, un problème ? Connecte toi sur #br et tu trouveras quelqu'un pour y répondre.

[[Catégorie:IRC]]

Git

2013-04-07T21:31:40Z

Michel.blancard : ajout d'un tuto git

{{menu Root Toolbox}}

Git est un [[VCS|système de contrôle de version]]. Assez proche de [[SVN]] par certains côtés, il présente néanmoins un grand nombre de différences.

Si tu découvre git, ou que tu n'est pas encore très à l'aise avec, consulte [http://www.vogella.com/articles/Git/article.html ce tutoriel très bien expliqué et très complet]. Pour un aide mémoire, va voir [http://giudoku.sourceforge.net/media/GitHandbook.pdf ici] ou [http://ndpsoftware.com/git-cheatsheet.html ici].

== Dépôts ==

Alors que [[CVS]] et [[SVN]] sont des systèmes de versionnement centralisés (i.e un serveur contient le dépôt, et chaque utilisateur effectue un ''checkout'' depuis ce dépôt), Git est complètement décentralisé. Cela signifie que chaque contributeur a sa propre copie locale de tout l'historique d'un projet. Si aujourd'hui vous considérez que l'espace disque sur votre ordinateur est un problème, allez faire un tour, partez admirer les merveilles de la technologies qui nous entoure, et revenez demain. Sur cette page, tous les examples sont tirés du Git de [[Frankiz]], mais voici d'autres dépôts bien utiles :
* [http://www.github.com/ GitHub]
* [http://git.frankiz.net/ Frankiz]
* [http://git.polytechnique.org/ Polytechnique.org]

== Récupérer le code d'un projet existant ==

Pour télécharger un projet existant, il y a deux possibilités : avec un compte de développeur ou sans compte. Avec un compte SSH simple, il suffit d'exécuter la commande suivante :
git clone mybeautifulname@git.frankiz.net:/hosting/git/frankiz
Sans compte, certains projets sont téléchargeables avec le protocole HTTP, mais vous ne pourrez pas uploader vos modifications.
git clone http://git.frankiz.net/frankiz

Cela crée un '''clone''' du dépôt d'origine (i.e une copie conforme), qui peut d'ailleurs servir de backup si le dépôt d'origine était perdu. Notre clone contient tout l'historique du dépôt depuis sa création, toutes les branches, etc. Cette première opération est très souple. On peut cloner des dépôt via SSH, HTTP, GIT, ou même en local le dépôt d'un autre utilisateur...

Par exemple la commande suivante clone dans le dossier ''platal'' la branche ''core/master'' d'une version de Plat/al potientiellement modifiée par le vice-prez 2010 :
git clone /home/2010/fishilico/dev/platal/.git platal -b core/master

== Accéder à l'aide ==
Avant toute chose, il est essentiel de savoir où trouver de l'aide, d'autant plus que l'aide de Git est très bien faite.
* Sur internet, il y a le wikiBR, les pages de manuel ([http://linux.die.net/man/1/git sur Linux Die] par exemple) et le [http://book.git-scm.com/ Git Book]
* En terminal, ''git help'' pour une liste des commandes, ''git help cmd'' ou ''git cmd --help'' pour l'aide complète de la commande ''cmd'', ou encore simplement ''git cmd -h'' pour une aide courte sur la commande ''cmd''

== Quel est l'état de ma copie de travail ? ==
Ceci est la question que vous devez vous posez avant de reprendre après une pause votre travail sur un projet versionné. Il peut y avoir eu des changements sur le projet entre temps, des patchs mal faits en production, ... Pour cela, il y a trois commandes essentielles :
* Pour vérifier que le dépôt est correct, ''git status'' doit dire cela :
git status
# On branch master
nothing to commit (working directory clean)
* En cours de travail, la réponse ressemble plus à :
git status
# On branch master
# Changes not staged for commit:
# (use "git add <file>..." to update what will be committed)
# (use "git checkout -- <file>..." to discard changes in working directory)
#
# modified: un-fichier-random.blah
#
# Untracked files:
# (use "git add <file>..." to include in what will be committed)
#
# un-fichier-chombier-ajouté.42
no changes added to commit (use "git add" and/or "git commit -a")
* Lire l'historique est bien pour savoir quel est le dernier commit
git log
commit 2a424aae1e746fb5f33de3b3bc3e8a31ee25c684
Author: Nicolas Iooss <fishilico@eleves.polytechnique.fr>
Date: Fri Mar 9 00:27:35 2012 +0100
* Voir les différences entre la version sur le dépôt distant et celle de travail
git diff

De plus, après avoir téléchargé les derniers commits avec ''git fetch'', il est possible d'obtenir le message suivant :
git status
# On branch master
# Your branch is behind 'origin/master' by 42 commits, and can be fast-forwarded.
Cela signifie que la copie locale a 42 commits de retard sur le dépôt distant, mais qu'un ''git rebase origin/master'' suffit pour mettre à jour la copie locale.

== Réinitialiser le dépôt ==
Pour restaurer un fichier, il suffit de le ''checkout'' à partir de l'index. En français, cela signifie que lorsque vous faites une modification sur un fichier, vous pouvez effacer les modifications et revenir la dernière version enregistrée dans l'index Git avec la commande :
git checkout -- chemin/vers/mon/fichier.blih
Pour réinitialiser l'index dans l'état indiqué par une branche (comme ''master'' par exemple) sans modifier les fichier, il suffit d'écrire :
git reset master
Si cela ne marche pas car des fichiers seront modifiés ou effacés, on peut forcer la main à Git, mais alors il faut être prêt à subir les conséqences que cela implique (perte des modifications non commitées)
git reset --hard master

== Mettre à jour la copie de travail ==
=== git fetch && git rebase origin/master ===
Dans le cas général, vous travaillez sur la branche ''master'' et vous synchronisez votre projet sur un seul serveur. Si votre cas est plus compliqué, vous devez être suffisamment compétent pour vous débrouillez par vous-même. On disait donc... dans le cas simple, Git stocke en interne deux branches : ''master'' et ''origin/master''. Sur Frankiz, c'est un peu plus compliqué car il y a une branche de production, mais les développeurs n'utilisent que master.
git branch -a
* master
remotes/origin/HEAD -> origin/master
remotes/origin/f579e1971a66623b2948bf0e20c2e23481022b41
remotes/origin/fkz2
remotes/origin/kangz-h4ck3s
remotes/origin/master
remotes/origin/prod

Pour mettre à jour sa copie de travail, il faut donc commencer par mettre à jour les branches distantes, avec '''au choix''' l'une des commandes suivantes
git fetch
git fetch origin

Ensuite, il faut appliquer les éventuelles modifications locales à la suite de celles effectuées sur le dépôt, c'est le '''rebase'''.
git rebase origin/master
Git essaiera alors d'appliquer les commits locaux successivement, en indiquant chaque fois qu'il y a un problème (conflit ou fichier supprimé). En cas de problème, il faut
# Résoudre le problème (les fichiers avec des conflits apparaîssent comme ''Changed but not updated'' dans ''git status'')
# Ajouter les fichiers (''git add'')
# Indiquer à git de continuer : ''git rebase --continue''

Remarque : git pull --rebase est un raccourci pour l'ensemble git fetch && git rebase. Attention cependant lors du travail sur plusieurs branches.

Ceci permet de transformer l'état suivant (les ''O'' sont les commits, ''A'' le moment où les deux versions ont commencé à diverger, ''B'' la version du dépôt, ''E'' la version locale, ''C'' et ''D'' des commits locaux

-C--D--E
/
-O--A--O--B

En l'état plus propre :
-O--A--O--B--C'--D'--E'

Avec C, D et E convertis en C', D' et E' : ils ont été modifiés pour être des modifications relatives à B au lieu de A.

=== Pourquoi il ne faut JAMAIS utiliser git pull ===
Certains développeurs utilisent la commande ''git pull'' pour mettre à jour leur dépôt. Cette pratique est justifiée lorsque la copie de travail était propre (sans commit en attente de push entre autres), mais sinon, cela peut avoir des conséquences très graves et sales. En effet, ''git pull' est assimilé à la succession de commandes suivantes :
git fetch origin && git merge origin/master
Le problème est le merge. En reprenant les schémas précédents, cela transforme l'état suivant :

-C--D--E
/
-O--A--O--B

en :

-C--D--E
/ \
-O--A--O--B----M

où M est le commit ''de fusion de branches''. '''Cela est très moche et à éviter absolument'''. Si vous vous retrouvez dans cette suituation (pour vérifier : ''git log''), vous pouvez toujours tenter un ''git rebase origin/master'' qui peut fonctionner si le ''merge'' était trivial (sans conflit). Sinon, un ''git reset --hard origin/master'' s'impose pour assurer votre salut.

=== Sauvegarder des modifications locales (git stash) ===
Avant de faire un merge particulièrement délicat, ou si l'on doit résoudre un bug alors que l'on a pas mal de modifications non commitées en cours, il est parfois utile de sauvegarder l'état courant de la copie de travail.

Pour cela, il faut utiliser '''avant''' un changement (avec ''git rebase'' par exemple) :
git stash
Une fois les modifications effectuées, on peut restorer la copie locale à l'état sauvegardé avec :
git stash pop

== Effectuer un commit ==
Un '''commit''' est un ensemble de fichiers modifiés. Cela permet plus de cohérence dans le suivi des versions. Par exemple, si l'ajout d'une fonctionnalité sur Frankiz modifie les fichiers ''blah'', ''blih'' et ''bloh'', le ''commit'' regroupe les modifications de ces trois fichiers, et associe à cette modification une date et un auteur.

Pour effectuer un commit, il faut :
* Vérifier l'état de la copie de travail, pour ne commiter que ce qui est nécessaire
git status
git diff
* Indiquer à Git quels fichiers feront partie du commit ; ceci permet de ne committer que les modifications de quelques fichiers
git add path/to/blih path/to/blah path/to/bloh
* Vérifier que l'on a ajouté les fichiers que l'on voulait :
git status
* Faire le commit (le ''-s'' ajoute une ligne ''Signed of by'' dans le message, pour pouvoir retrouver plus efficacement l'auteur réel du commit)
git commit -s
* Cette commande ouvre un éditeur (vi, nano ou emacs selon la configuration de la variable EDITOR). Il faut alors entrer un bref descriptif du commit. '''Pour certains projets (dont Frankiz), les conventions de codage obligent les développeurs à écrire les descriptions en anglais.''' Il est un bon usage de s'adapter en conséquence, car un commit peut être refusé en production s'il est mal fait.
* Mettre à jour la copie locale avec le dépôt distant (cela décale le nouveau commit à la fin). '''IL NE FAUT SURTOUT PAS FAIRE DE git pull OU DE git merge ICI'''
git fetch
git rebase origin/master
* Transmettre les commits au dépôt d'origine
git push

La dernière commande provient du fait que git n'est pas centralisé : il n'envoie pas les modifications locales au dépôt parent spontanément.

Ceci permet de faire quelques modifications locales puis de n'envoyer cela au reste des développeurs que lorsque les modifications sont stables et complètes, par exemple.

== Gérer les branches ==
On peut voir la liste des branches accessibles avec :
git branch -a
* La ligne avec une étoile est la branche courante
* Les lignes blanches sont les branches ''locales'' (elles suivent généralement une branche distante)
* Les lignes rouges (si les couleurs sont activées) sont les branches distantes.

Pour récupérer une autre branche, il faut d'abord l'ajouter localement :
git checkout -b NomLocal origin/NomDistant

Cela aura également pour effet de basculer sur la branche NomLocal.
Les modifications que l'on avait effectuées sont bien entendu conservées.

Une fois la branche ajoutée, on peut basculer de branche en branche à l'aide de :
git checkout NomLocal

== Créer un dépôt ==
Contrairement à [[SVN]] où il faut installer un serveur subversion, créer un dépôt Git est très rapide : dans le dossier que l'on souhaite versionner, il suffit de taper
git init
Et voilà, le dossier est versionné : on peut donc commencer à faire des modifications, des commits, etc. (bien entendu, on ne peut pas ''pusher'' ses commits, puisqu'il n'y a pas de serveur distant).

Cette particularité rend Git très efficace pour versionner un petit projet, un exercice de TD, etc.

Pour créer un dépôt qui peut être cloné, il faut exécuter les commandes suivantes :
git init --bare mon_projet
cd mon_projet && git update-server-info

Enfin, pour configurer un serveur HTTP (gitweb), il ne faut pas oublier de créer un fichier vide '''git-daemon-export-ok''' dans le dossier, afin de permettre le clonage.

== Structure interne ==

Git stocke les commits de manière très particulière : un commit correspond à peu près à une sauvegarde de l'état des fichiers, à un message, et à une référence vers le commit parent.
Contrairemant à [[SVN]], il n'y a donc pas de notion de numéro de révision : chaque commit est identifié par une chaîne hexadécimale de 40 caractères (par exemple : ''04fd02e59b1bdc430c7a7dcc1ca9f4cbc2b04037'' )

Un ''tag'' est en fait un nom «lisible» donné à un ''commit'' ; une ''branche'' indique également le ''commit'' principal d'une branche.

== Du bon usage de gitignore ==
Dans un projet, il est inutile de versionner les fichiers temporaires et les fichiers compilés (qu'ils soient binaires ou non). On utilise généralement un Makefile pour créer ces fichiers. Pour éviter de les versionner, il suffit d'utiliser un fichier ''.gitignore'' bien placé. Généralement, chaque projet a un tel fichier dans son dossier principal. Voici par exemple un extrait du gitignore de Frankiz :
configs/frankiz.conf
htdocs/.htaccess
htdocs/data/*
htdocs/css/*
spool/*
upgrade/2.0.0_to_3.0.0/unversionned

== Configuration globale ==
Si vous avez déjà commitez, vous aurez certainement remarqué qu'il faut utiliser ''git config'' pour configurer vos informations personnelles. Ainsi, les deux premières commandes que tout utilisateur doit taper avant de faire un commit sont :
git config --global user.name "Prénom Nom de famille"
git config --global user.email "prenom.nom.promo@polytechnique.org"

Ensuite, si vous aimez les couleurs, vous avez envie de taper cette commande :
git config --global color.ui auto

Enfin, si vous en avez assez des projets qui ne mettent pas les fichiers temporaires dans le gitignore, vous pouvez configurer un fichier gitignore global. Si votre ''/home/user/.gitignore_global'' ressemble à
*~
*.swp
*.tmp
il suffit de taper :
git config --global core.excludesfile /home/user/.gitignore_global

Tout cela permet de gérer la configuration globale, visible par
git config --global -l
En enlevant ''--global'' dans toutes les commandes précédentes, on configure la copie locale.

=== Exemple de configuration ===
Voici un exemple de fichier ~/.gitconfig (qui stocke la configuration ''--global'', le même format peut être utilisé dans les fichier ''$REPO/.git/config'' de chaque dépot) :
[gc]
auto = 1
[color]
ui = true
[color "diff"]
whitespace = red reverse
[core]
whitespace=fix,-indent-with-non-tab,trailing-space,cr-at-eol
[alias]
st = status
ci = commit
br = branch
co = checkout
df = diff
dc = diff --cached
lg = log -p
lo = log --graph --decorate --pretty=oneline --abbrev-commit -n 10
lol = log --graph --decorate --pretty=oneline --abbrev-commit
lola = log --graph --decorate --pretty=oneline --abbrev-commit --all
ls = ls-files
# Show files ignored by git:
ign = ls-files -o -i --exclude-standard
amend = commit --amend -C HEAD
[branch]
autosetuprebase = always

== Utiliser le proxy de l'X avec Git ==
Si vous hébergez un projet sur [http://www.github.com GitHub], vous avez envie de dire à Git de se connecter à GitHub en SSH en passant par le proxy de l'X (qui est [http://kuzh.polytechnique.fr:8080 kuzh:8080]). Pour cela, il suffit de configurer le client SSH pour utiliser le proxy à chaque connexion vers github.com. Cela s'effecute par le fichier de configuration suivant dans /home/user/.ssh/config (adaptez avec votre dossier personnel)
Host github.com
ProxyCommand socat - PROXY:kuzh.polytechnique.fr:%h:%p,proxyport=8080

Si vous souhaitez utiliser le protocole git://, il faut utiliser socat, et créer un exécutable avec dedans :
#!/bin/sh
exec socat STDIO PROXY:129.104.247.2:$1:$2

Puis mettre cet executable dans la variable core.gitproxy :
git config --global core.gitproxy NOM_DU_FICHIER

N'oubliez pas d'enlever cette variable pour utiliser git en-dehors de l'X.

'''Si vous souhaitez uniquement cloner un dépôt GitHub''' dont vous n'êtes pas contributeur, il suffit d'utiliser le lien HTTPS en ligne de commande, en précisant le proxy.
export https_proxy=http://kuzh.polytechnique.fr:8080
git clone https://github.com/BinetReseau/frankiz.git

Finalement, si vous ne voulez pas vous connecter par ssh, mais vous souhaitez travailler normalement avec un depôt à l'extérieur de l'X, configurez git par le biais de ces commandes:
git config --global http.proxy http://kuzh.polytechnique.fr:8080
git config --global https.proxy http://kuzh.polytechnique.fr:8080

Cela va effectuer les modifications correspondantes sur le fichier ~/.gitconfig. '''N'oubliez pas de les enlever dès que vous n'êtes plus connectés au réseau de l'école, avec''':
git config --global --unset http.proxy http://kuzh.polytechnique.fr:8080

= Pour Windows =

Pour utiliser Git sur Windows, on peut par exemple télécharger MSys Git : [http://msysgit.github.com/ http://msysgit.github.com/].

[[Catégorie:Root]]

Modèle:Réunions2011

2013-03-27T16:21:08Z

Michel.blancard : ajout 2 réunions

* [[Réunion:2012-03-27_Réunion_BCX|Réunion sur les impressions à la BCX]]
* [[Réunion:2012-03-27_Réunion_GEIDE|Réunion sur le cloud storage]]
* [[Réunion:2012-03-19_Réunion_CU|Réunion du Comité Utilisateur du 19 mars 2013]]
* [[Réunion:2013-03-14_Réunion_DSI|Réunion DSI du 14 mars 2013]]
* [[Réunion:2013-02-14_Réunion_DSI|Réunion DSI du 14 février 2013]]
* [[Réunion:2013-02-13_Assemblée_Générale|Assemblée Générale du 13 février 2013]]
* [[Réunion:2013-02-12_Réunion_SOI|Réunion SOI du 12 février 2013]]
* [[Réunion:2013-01-17_Réunion_DSI|Réunion DSI du 17 janvier 2013]]
* [[Réunion:2013-01-16_1ere_reunion_du_BR|1ère Réunion BR 2011 du 16 janvier 2013]]
* [[Réunion:2012-12-20_Kes-BR| Réunion avec la Kès du 20 décembre 2012]]
* [[Réunion:2012-12-19_Magnan_BR-ENSTA|Magnan-BR du 19 décembre 2012, avec l'ENSTA]]
* [[Réunion:2012-12-04_Réunion_CD|Réunion du Comité Directeur du 04 décembre 2012]]
* [[Réunion:2012-11-23_Réunion_CU|Réunion du Comité Utilisateur du 23 novembre 2012]]

Fichier:InfoBR 2k12.pdf.zip

2013-03-21T13:32:42Z

Michel.blancard :

Fichier:Couverture InfoBR 2012.jpg

2013-03-21T13:30:36Z

Michel.blancard :

Modèle:Réunions2011

2013-03-20T17:42:25Z

Michel.blancard : CU de mars 2013

* [[Réunion:2012-03-19_Réunion_CU|Réunion du Comité Utilisateur du 19 mars 2013]]
* [[Réunion:2013-03-14_Réunion_DSI|Réunion DSI du 14 mars 2013]]
* [[Réunion:2013-02-14_Réunion_DSI|Réunion DSI du 14 février 2013]]
* [[Réunion:2013-02-13_Assemblée_Générale|Assemblée Générale du 13 février 2013]]
* [[Réunion:2013-02-12_Réunion_SOI|Réunion SOI du 12 février 2013]]
* [[Réunion:2013-01-17_Réunion_DSI|Réunion DSI du 17 janvier 2013]]
* [[Réunion:2013-01-16_1ere_reunion_du_BR|1ère Réunion BR 2011 du 16 janvier 2013]]
* [[Réunion:2012-12-20_Kes-BR| Réunion avec la Kès du 20 décembre 2012]]
* [[Réunion:2012-12-19_Magnan_BR-ENSTA|Magnan-BR du 19 décembre 2012, avec l'ENSTA]]
* [[Réunion:2012-12-04_Réunion_CD|Réunion du Comité Directeur du 04 décembre 2012]]
* [[Réunion:2012-11-23_Réunion_CU|Réunion du Comité Utilisateur du 23 novembre 2012]]