bebou

Le site web bebou.netlib.re - retour accueil

git clone git://bebou.netlib.re/bebou
Log | Files | Refs |

index.sh (23600B)


      1 #! /usr/bin/env ./faq
      2 title: Foire aux questions
      3 author: bébouse
      4 description: Les réponses à toutes les questions que vous vous posez au sujet du village des bébous
      5 subtitle: \(dont on pense qu\'elles seront fréquemment posées\)
      6 
      7 sectionmd: main
      8 
      9 Dans toute cette FAQ toutes les commandes à taper sont précédée d'un `$ ` et
     10 les résultats qui s'affichent simplement dans le terminal ne le sont pas.
     11 
     12 ## Obtenir un compte/site
     13 
     14 Plusieurs conditions doivent être réunies pour que vous puissiez obtenir un compte :
     15 
     16   1. Vous devez connaître personnellement une personne actuellement dans le village et le village doit avoir envie de vous y accueillir
     17   2. Il doit rester des ressources matérielles pour vous accueillir (espace disque, ram, cpu, bande passant)
     18   3. Vous devez être en mesure de [fournir une clef ssh publique](/faq/#comment-crer-et-communiquer-une-paire-de-clef-ssh)
     19   4. Vous devez être en mesure d'expliquer pourquoi vous voulez rejoindre le serveur
     20 
     21 Si toutes ces conditions sont réunies vous pouvez nous envoyer votre clef
     22 publique et nous rejoindre :)
     23 
     24 ## Créer et communiquer une paire de clef ssh
     25 
     26 L'unique prérequis est d'avoir [openSSH](https://www.openssh.com/) installé sur votre machine.
     27 
     28 Le but ici est de créer ce que l'on nomme une paire de clef ssh qui permettra de vous
     29 authentifier sur le serveur. C'est un peu comme un mot de passe mais en mieux. La
     30 procédure va créer sur votre ordinateur deux fichiers intrinsèquement liés. Une
     31 clef dite publique et une clef dite privée. La clef publique est celle qu'il
     32 faudra communiquer aux personnes sur le serveur pour obtenir un accès. Il n'y a
     33 aucun risque à la communiquer au monde entier, elle est faite pour ça. **La clef
     34 privée est elle très secrète. Il ne faut absolument jamais la communiquer à
     35 qui que ce soit d'autre ni la perdre. Il n'est pas possible de la regénérer
     36 si elle est perdue.**
     37 
     38 Tout se fera dans le terminal. Ouvrez donc votre terminal préféré (parfois en
     39 faisant `ctrl+alt+t`). Désolé, je vais mettre les exemples en anglais.
     40 
     41 Pour vérifier si vous avez openSSH lancez `ssh -V`. Si vous voyez quelque chose
     42 du type `OpenSSH_9.2p1 Debian-2+deb12u2, OpenSSL 3.0.11 19 Sep 2023` ou quoi
     43 que ce soit d'autre que `command not found` ou message d'erreur similaire alors
     44 c'est bon ! Sinon il va falloir installer openSSH à l'aide de votre
     45 gestionnaire de paquet. Par exemple sous debian `sudo apt install
     46 openssh-client` fera l'affaire.
     47 
     48 C'est maintenant que vous allez choisir un nom de compte et, par défaut,
     49 votre nom de domaine. Il doit ne contenir que des minuscules de *a* à *z* et/ou
     50 des chiffres. Aucun caractère spécial, aucune majuscule. Si votre nom de compte
     51 est "alice" alors par défaut votre site sera accessible à l'adresse
     52 "http://alice.bebou.netlib.re". [Il est possible de la changer
     53 ensuite](/faq/#changer-de-sous-domaine). En partant du principe que vous voulez
     54 nommer votre compte et votre sous-domaine "alice" vous pouvez lancer la
     55 commande suivante :
     56 
     57 	$ ssh-keygen -t ed25519 -C alice
     58 
     59 Elle va vous demander un ensemble d'informations. Ce qui est écrit entre
     60 parenthèses est le comportement par défaut. S'il convient il suffit d'appuyer
     61 sur entrer pour passer à la suite. Sinon il faut soit même entrer ce que l'on
     62 souhaite.
     63 
     64 Premièrement, l'emplacement de la clef. Ici `votre_utilisateurice` est le nom de
     65 votre compte sur votre machine perso. Vous devez rentrer le chemin vers la clef
     66 (le fichier) à créer. Si c'est votre première clef ssh vous pouvez simplement
     67 appuyer sur entrer. Sinon j'imagine que vous savez un peu ce que vous faites, entrez
     68 un chemin qui convient et faites attention à ne pas écraser une clef existante :
     69 
     70 	Generating public/private ed25519 key pair.
     71 	Enter file in which to save the key (/home/votre_utilisateurice/.ssh/id_ed25519):
     72 
     73 Deuxièmement la commande vous demandera une phrase de passe pour chiffrer la clef.
     74 Autrement dit seules les personnes connaissant cette phrase de passe et ayant
     75 accès à la clef - à priori uniquement vous - pourront utiliser la clef pour
     76 s'authentifier sur le serveur sur le compte correspondant. Si vous choisissez
     77 de ne pas mettre de phrase de passe toute personne ayant une copie de votre clef
     78 privée pourra se connecter sur votre compte sans plus d'informations nécessaires.
     79 Si vous choisissez de mettre une phrase de passe chaque utilisation de la clef
     80 nécessitera d'insérer cette phrase pour la débloquer et pouvoir l'utiliser.
     81 C'est une protection supplémentaire en cas de perte et/ou de vol de la clef
     82 privée. *Il est recommandé de mettre une phrase de passe même si cela n'est
     83 pas nécessaire*. Il est également recommandé de choisir une bonne phrase de
     84 passe, c'est à dire aussi aléatoire que possible et d'au moins 6/7 mots[^2].
     85 Si vous mettez une phrase de passe et que vous l'oubliez il sera **impossible
     86 de débloquer la clef privée**. Il est donc important de faire l'effort de
     87 l'apprendre par coeur.
     88 
     89 	Enter passphrase (empty for no passphrase):
     90 	Enter same passphrase again:
     91 	
     92 	
     93 	Your identification has been saved in /home/votre_utilisateurice/.ssh/id_ed25519
     94 	Your public key has been saved in home/votre_utilisateurice/.ssh/id_ed25519.pub
     95 	The key fingerprint is:
     96 	SHA256:jEl7BWye0joCmY+VQcxyGG9RqmOhTO8TD5bCS6UM38I alice
     97 	The key's randomart image is:
     98 	+--[ED25519 256]--+
     99 	|  .*o....        |
    100 	|  o.=o  o.       |
    101 	|...*+o.+ ..      |
    102 	|*+B=+..=+.       |
    103 	|.BE@. +oS        |
    104 	|..*o* o.         |
    105 	| . o o .         |
    106 	|    .            |
    107 	|                 |
    108 	+----[SHA256]-----+
    109 
    110 Oh le joli dessin ! Comme indiqué vous avez dorénavant un clef privée
    111 `id_ed25519` et la clef publique associée `id_ed25519.pub`.
    112 
    113 Le contenu de la clef publique ressemble à quelque chose du style
    114 
    115 	ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEMQgNDrqMgWCC4EjuXZ/e08/dZOhUqSa/z7w8sAHolL alice
    116 
    117 Tout ce qui suite la longue chaîne de caractères "aléatoire"[^3] servira à vous
    118 donner un nom de compte. Si vous changez d'avis c'est maintenant ou jamais de
    119 l'éditer.
    120 
    121 Pour qu'une personne déjà sur le serveur vous donne les accès il faudra lui
    122 communiquer le fichier `id_ed15519.pub`. Peu importe le canal utilisé, c'est un
    123 simple fichier texte. Vous pouvez copier coller son contenu dans une
    124 conversation, envoyer le fichier en tant que tel en pièce-jointe d'un mail
    125 etc.
    126 
    127 Plus qu'à attendre qu'on vous ajoute !
    128 
    129 ## Se connecter au serveur
    130 
    131 Pour se connecter à votre compte sur le serveur il faut d'abord [remplir les
    132 conditions pour pouvoir obtenir un
    133 compte](/faq/#comment-obtenir-un-comptesite), avoir [créé une paire de clef et
    134 l'avoir envoyé à une personne déjà sur le
    135 serveur](/faq/#comment-crer-et-communiquer-une-paire-de-clef-ssh).
    136 
    137 Si tout cela est déjà fait vous devriez pouvoir vous y connecter en ssh en faisant :
    138 
    139 	$ ssh alice@bebou.netlib.re -p 1459
    140 
    141 Si vous avez mis une phrase de passe il faudra l'insérer, sinon vous devriez
    142 arriver sur votre compte !
    143 
    144 Pour éviter d'avoir à systématiquement taper tout cela quand vous voulez vous
    145 connecter vous pouvez ajouter une entrée dans le fichier
    146 `/home/votre_utilisateurice/.ssh/config` à l'aide d'un éditeur de texte. Si ce
    147 fichier n'existe pas il faudra le créer. A l'intérieur vous pouvez écrire :
    148 
    149 	host bebou
    150 	hostname bebou.netlib.re
    151 	user alice
    152 	port 1459
    153 
    154 Ainsi vous n'aurez plus qu'à taper `ssh bebou` pour vous connecter. `ssh` fera
    155 automatiquement le lien entre le "host" `bebou` et l'url, le port et le nom du
    156 compte.
    157 
    158 ## Ajouter une personne au serveur
    159 
    160 Votre copaine voudrait nous rejoindre, tout le monde l'aime et iel a un projet
    161 trop cool ? Iel vous a envoyé sa clef publique ? Vous mourrez d'envie de lui
    162 créer un compte de suite là maintenant ?
    163 
    164 Rien de plus simple, connectez vous au compte `pi` possédant les droits
    165 d'administration :
    166 
    167 	$ ssh pi@bebou.netlib.re -p 1459
    168 
    169 puis lancez la commande menu :
    170 
    171 	$ menu
    172 	>
    173 	ajouter un compte
    174 	supprimer un compte
    175 	changer de sous-domaine
    176 	mettre un site en ligne
    177 	mettre un site hors ligne
    178 	faq
    179 	shell
    180 
    181 Pour sélectionner une action commencez par taper son nom ou naviguez vers le bas
    182 avec les flèches du clavier. Quand vous êtes sur `ajouter un compte` (quand cette
    183 ligne est en surbrillance), appuyez sur "entrer". Vous verrez ensuite :
    184 
    185 	>
    186 	en copiant/collant
    187 	depuis un fichier
    188 
    189 Si vous choisissez en copiant/collant il suffira de coller la clef publique comme ceci :
    190 
    191 	copier/coller la clef ici : ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIEMQgNDrqMgWCC4EjuXZ/e08/dZOhUqSa/z7w8sAHolL alice
    192 
    193 puis d'appuyer sur la toucher entrer. Le serveur va créer le compte et automatiquement
    194 vous déposer dans le salon "accueil" du serveur irc. Vous pouvez faire un petit coucou
    195 au nom de votre copaine ou directement fermer a session en faisant `ctrl+d`.
    196 
    197 Si vous choisissez depuis un fichier existant sur le serveur il faudra renseigner
    198 son chemin :
    199 
    200 	chemin vers le fichier : /home/pi/alice.pub
    201 
    202 Dans ce cas pas d'ouverture du client irc mais ne vous inquiétez pas.
    203 
    204 ## Supprimer son compte
    205 
    206 ***Attention : toute suppression est définitive***
    207 
    208 Si vous voulez nous quitter, ou si pour une raison légitime il est important de
    209 supprimer le compte d'une autre personne connectez vous au compte pi
    210 
    211 	$ ssh pi@bebou.netlib.re -p 1459
    212 
    213 puis lancez la commande menu
    214 
    215 	$ menu
    216 	>
    217 	ajouter un compte
    218 	supprimer un compte
    219 	changer de sous-domaine
    220 	mettre un site en ligne
    221 	mettre un site hors ligne
    222 	faq
    223 	shell
    224 
    225 choisissez "supprimer un compte" puis le compte en question ("annuler" ferme
    226 tout) :
    227 
    228 	Dire adieu à qui ?
    229 	>
    230 	annuler
    231 	machin
    232 	alice
    233 
    234 Vous devrez confirmer la suppression. En appuyant sur `o` puis entrer vous
    235 supprimerez définitivement toutes les données du compte. En appuyant sur quoi
    236 que ce soit d'autre puis entrer vous annulerez tout.
    237 
    238 	Supprimer l'utilisateurice alice ? o=oui, quoi que ce soit d'autre=non :
    239 
    240 Puis une dernière confirmation (on sait jamais)
    241 
    242 	Vraiment vraiment supprimer alice ? écrire 'oui' pour confirmer : oui
    243 
    244 Hop, tout est supprimé !
    245 
    246 ## Changer de sous-domaine
    247 
    248 Si vous voulez que votre site soit accessible à http://cool.bebou.netlib.re et
    249 plus à http://alice.bebou.netlib.re vous pouvez vous connecter sur le compte pi
    250 puis lancer la commande menu :
    251 
    252 	$ menu
    253 	>
    254 	ajouter un compte
    255 	supprimer un compte
    256 	changer de sous-domaine
    257 	mettre un site en ligne
    258 	mettre un site hors ligne
    259 	faq
    260 	shell
    261 
    262 choisir "changer de sous-domaine" et selectionner votre site parmi la liste :
    263 
    264 	du sous-domaine
    265 	>
    266 	alice
    267 	machin
    268 
    269 et finalement renseigner le nouveau sous-domaine :
    270 
    271 	vers : cool
    272 
    273 Votre site devrait instantanément être dispo à la nouvelle adresse.
    274 [L'annuaire](http://bebou.netlib.re/pagesjaunes) devrait quant à lui se mettre
    275 à jour maximum cinq minutes après l'opération.
    276 
    277 ## Modifier son site
    278 
    279 Si vous venez d'ouvrir un compte vous devriez voir une page extrêmement simple
    280 à `votrecompte.bebou.netlib.re`. Comment la modifier ?
    281 
    282 ### Directement sur le serveur
    283 
    284 Nous documentons cette possibilité parce qu'elle peut avoir son utilité mais
    285 nous recommandons de [travailler en
    286 local](/faq/#en-local-puis-en-poussant-les-modifications-sur-le-serveur).
    287 
    288 Quand vous vous [connectez sur le serveur](/faq/#se-connecter-au-serveur) vous
    289 arriverez dans votre dossier personnel - `/home/alice/`. Ici vous pouvez utiliser
    290 la commande `ls` pour vérifier ce qu'il s'y trouve :
    291 
    292 	$ ls
    293 	alice.bebou.netlib.re  choixutil  createtmuxsession
    294 
    295 `alice.bebou.netlib.re` est le dossier contenant votre site. Tous les fichiers
    296 qui s'y trouvent sont accessibles sur `http://alice.bebou.netlib.re`. Par défaut
    297 le serveur web affiche `index.html` s'il existe. Vous pouvez constatez qu'il existe
    298 déjà :
    299 
    300 	$ ls alice.bebou.netlib.re
    301 	index.html
    302 
    303 Pour vérifier son contenu vous pouvez utiliser `cat` :
    304 
    305 	$ cat alice.bebou.netlib.re/index.html
    306 	page de alice
    307 
    308 Si vous fatiguez après avoir tapé ces commandes assez longues sachez qu'il est
    309 possible d'auto compléter les chemins des fichiers[^4] en faisant une
    310 tabulation.
    311 
    312 Pour modifier le contenu depuis le terminal on peut utiliser un éditeur de texte
    313 dans le terminal, par exemple nano :
    314 
    315 	$ nano alice.bebou.netlib.re/index.html
    316 	  GNU nano 7.2                   alice.bebou.netlib.re/index.html
    317 	page de alice
    318 
    319 
    320 										[ Lecture de 1 ligne ]
    321 	^G Aide        ^O Écrire      ^W Chercher    ^K Couper      ^T Exécuter    ^C Emplacement
    322 	^X Quitter     ^R Lire fich.  ^\ Remplacer   ^U Coller      ^J Justifier   ^/ Aller ligne
    323 
    324 Il est possible ici de modifier le fichier en se déplaçant avec les flèches du
    325 clavier et en tapant le texte que l'on souhaite insérer. Vuos pouvez ensuite
    326 vous référez aux raccourcis en bas de la fenêtre pour sauvegarder le fichier et
    327 sortir, en sachant qu'ici `^` veut dire la touche control. Ainsi pour écrire le
    328 fichier dans sa nouvelle version il faut faire `ctrl+o` et valider le chemin du
    329 fichier (simplement appuyer sur entrer). Pour ensuite quitter vous opuvez faire
    330 `ctrl+x`. Alternativement en faisant directement `ctrl+x` nano vous demandera
    331 si vous voulez sauvegarder le fichier ou pas, ce que vous pouvez accepter en
    332 appuyant sur `o` et vous pourrez quitter en appuyant sur la touche entrer.
    333 
    334 une fois le fichier sauvegarder vous pouvez accéder à `alice.bebou.netlib.re`
    335 via n'importe quel navigateur et constater le changement !
    336 
    337 ### En local puis en poussant les modifications sur le serveur
    338 
    339 Vous conviendrez que la méthode précédente est assez fastidieuse. Il
    340 faut se faire à l'utilisation d'un éditeur de texte dans le terminal,
    341 il n'est pas possible de travailler hors ligne puisqu'il vous pouvoir
    342 accéder au serveur etc. **Nous recommandons donc de travailler en local**.
    343 
    344 Par travailler en local vous crééerez votre site sur votre ordinateur pour
    345 ensuite déposer tous les fichiers d'un coup sur le serveur. Admettons que vous
    346 souhaitiez avoir une page d'accueil très simple avec un titre et une image.
    347 Vous pouvez créer un dossier `site` dans votre répertoire maison et y mettre le
    348 document `index.html` avec le contenu suivant :
    349 
    350 	<!DOCTYPE html>
    351 	<html>
    352 	<head>
    353 		<meta charset="utf-8" />
    354 		<meta name="viewport" content="width=device-width,initial-scale=1" />
    355 		<title>Le site d'Alice</title>
    356 	</head>
    357 	<body>
    358 		<h1>Bienvenu sur mon site !</h1>
    359 		<p>Voici mon chat</p>
    360 		<img src="/chat.jpg">
    361 	</body>
    362 	</html>
    363 
    364 Ici vous serez tenter de vérifier si tout fonctionne bien avant de l'envoyer sur
    365 le serveur. Pour cela pas de solution magique, il vous faut faire tourner un
    366 serveur web localement sur votre ordinateur. Pour cela voir [la partie dédiée
    367 à cette question](/faq/#comment-tester-localement-son-site).
    368 
    369 Pour ensuite envoyer tout le contenu du dossier `site` vers le bon dossier sur
    370 le serveur nous allons utiliser [`rsync`](https://rsync.samba.org/). Sur debian
    371 vous pouvez l'obtenir via apt : `sudo apt install rsync`.
    372 
    373 Une fois rsync installé vous pouvez synchroniser les dossiers locaux et distants
    374 en faisant :
    375 
    376 	rsync -hvr ~/site/ bebou:~/alice.bebou.netlib.re/
    377 	Enter passphrase for key '/home/votre_utilisateurice/.ssh/id_ed25519':
    378 	sending incremental file list
    379 	site/
    380 	site/chat.jpg
    381 	site/index.html
    382 
    383 	sent 933 bytes  received 58 bytes  31,46 bytes/sec
    384 	total size is 735  speedup is 0,74
    385 
    386 `-h` dit à rsync d'afficher les tailles transférées en format lisible par des
    387 humain·es. `-v` d'afficher plus d'infos. `-r` de copier récursivement tout ce
    388 qu'il y a dans le dossier local. `~/site/` est le dossier dans lequel vous avez
    389 mis les fichiers à copier.  `alice` est le nom du host [que vous avez
    390 possiblement préalablement créé dans `.ssh/config`](/faq/#se-connecter-au-serveur) et
    391 `~/alice.bebou.netlib.re/` le dossier dans lequel copier le contenu de `site`.
    392 
    393 Si vous n'avez pas renseigné de phrase de passe à la [génération de votre
    394 clef](/faq/#comment-crer-et-communiquer-une-paire-de-clef-ssh) elle ne vous
    395 sera pas demandée. Si vous n'avez pas ajouté d'entrée dans votre `.ssh/config`
    396 de façon à pouvoir simplement écrire `bebou:` vous pouvez écrire
    397 
    398 	rsync -e 'ssh -p 1459' -hvr ~/site/ alice@bebou.netlib.re:~/alice.bebou.netlib.re/
    399 
    400 C'est un peu plus long et embêtant. Il est **important de mettre des `/` à la
    401 fin des chemins sinon les fichiers ne se copieront pas comme il faut**. C'est
    402 bien `~/site/` et `~/alice.bebou.netlib.re/` et non pas `~/site` et
    403 `~/alice.bebou.netlib.re`.
    404 
    405 Si vous avez tout fait comme il faut vous devriez pouvoir voir votre
    406 nouveau site à l'url correspondante, bravo !
    407 
    408 ## Gérer l'apparition de son site sur les pages jaunes
    409 
    410 > Tous les changements qui suivent prennent cinq minutes à être effectifs.
    411 
    412 Par défaut votre site n'apparaît pas dans l'[annuaire](/pagesjaunes). Pour le
    413 faire il faut vous [connecter une première fois](/faq/#se-connecter-au-serveur)
    414 à votre compte et il vous sera demandé si vous souhaitez y apparaître ou pas.
    415 
    416 Il est toujours possible de changer d'avis :
    417 
    418 ### Masquer votre site
    419 
    420 [Connectez-vous à votre compte](/faq/#se-connecter-au-serveur) et
    421 supprimez le fichier `.listeblanche` en lançant la commande `rm .listeblanche`.
    422 
    423 ### Rendre votre site visible
    424 
    425 [Connectez-vous à votre compte](/faq/#se-connecter-au-serveur) et
    426 creez le fichier `.listeblanche` en lançant la commande `touch .listeblanche`.
    427 
    428 ## Gérer la disponibilité de son site
    429 
    430 Peut-être que vous ne voulez pas simplement [ne pas faire apparaître votre site
    431 dans les pages jaunes](/faq/#masquer-votre-site) mais carrément le rendre
    432 innacessible sans pour autant le supprimer.
    433 
    434 ### Mettre son site hors ligne
    435 
    436 Deux façons :
    437 
    438 1. En crééant un fichier nommé `.offline` à la racine de votre site
    439 
    440 [Modifiez votre site](/faq/#modifier-son-site) de manière à ce qu'il existe un
    441 fichier nommé `.offline` à sa racine. Vous pouvez utiliser les commandes :
    442 
    443 	cd alice.bebou.netlib.re
    444 	touch .offline
    445 
    446 2. En utilisant la commande "mettre un site hors ligne" du menu
    447 
    448 Se connecter au compte pi, lancer la commande menu et utiliser "mettre un site
    449 hors ligne" :
    450 
    451 	$ menu
    452 	>
    453 	ajouter un compte
    454 	supprimer un compte
    455 	changer de sous-domaine
    456 	mettre un site en ligne
    457 	mettre un site hors ligne
    458 	faq
    459 	shell
    460 
    461 puis choisissez le site en question dans la liste :
    462 
    463 	>
    464 	test
    465 	alice
    466 	machin
    467 
    468 ### Mettre un site en ligne
    469 
    470 Les sites sont par défaut créé de manière à ce qu'ils soient en ligne.
    471 Si un site a été rendu hors ligne par le passé et que vous souhaitez le
    472 rétablir, deux façons :
    473 
    474 1. En supprimant le fichier nommé `.offline` à la racine de votre site
    475 
    476 [Modifiez votre site](/faq/#modifier-son-site) de manière à ce qu'il n'existe
    477 plus de fichier nommé `.offline` à sa racine. Vous pouvez utiliser les
    478 commandes :
    479 
    480 	cd alice.bebou.netlib.re
    481 	rm .offline
    482 
    483 2. En utilisant la commande "mettre un site en ligne" du menu
    484 
    485 Se connecter au compte pi, lancer la commande menu et utiliser "mettre un site
    486 en ligne" :
    487 
    488 	$ menu
    489 	>
    490 	ajouter un compte
    491 	supprimer un compte
    492 	changer de sous-domaine
    493 	mettre un site en ligne
    494 	mettre un site hors ligne
    495 	faq
    496 	shell
    497 
    498 puis choisissez le site en question dans la liste :
    499 
    500 	>
    501 	test
    502 	alice
    503 	machin
    504 
    505 ## Consulter et gérer des dépôts git
    506 
    507 Les dépôts git publics sont disponibles sur : http://git.bebou.netlib.re.
    508 
    509 ### Si vous souhaitez simplement lire/exécuter un dépôt
    510 
    511 Vous pouvez cloner "anonymement", c'est à dire sans avoir à vous authentifier,
    512 via le protocole git. Pour ce faire lancer :
    513 
    514     $ git clone git://bebou.netlib.re/nom_du_depot
    515 
    516 Par exemple pour cloner le dépôt de ce site :
    517 
    518     $ git clone git://bebou.netlib.re/bebou
    519 
    520 ### Si vous souhaitez contribuer à un dépôt existant
    521 
    522 Pour pouvoir contribuer, c'est à dire pousser du code sur le dépôt distant,
    523 hébergé sur le serveur, il faut utiliser le protocole ssh. Il faut donc
    524 [posséder un compte sur le serveur](/faq/#obtenir-un-comptesite).
    525 
    526 Si vous possédez un compte vous pouvez cloner un dépôt existant comme ceci :
    527 
    528     $ git clone ssh://nom_du_compte@bebou.netlib.re:1459/srv/git/nom_du_depot
    529 
    530 Si vous avez une entrée dans votre `~/.ssh/config` qui renseigne le nom de
    531 domaine et votre compte cette commande pourrait se résumer par :
    532 
    533     $ git clone bebou:/srv/git/nom_du_depot
    534 
    535 En SSH le chemin `/srv/git` est nécessaire pour que le serveur sache où
    536 trouver le dépôt que vous voulez cloner.
    537 
    538 Alternativement vous pouvez cloner anonymement, faire votre commit puis
    539 pousser en utilisant l'option `--set-upstream` pour dire à git de suivre
    540 cette branche distante :
    541 
    542     $ git clone git://bebou.netlib.re/nom_du_depot
    543 	# blablabla git commit
    544 	$ git push --set-upstream ssh://nom_du_compte@bebou.netlib.re:1459/srv/git/nom_du_depot
    545 
    546 Une fois vos modifications ou votre premier push avec `--set-upstream` fait
    547 vous pourrez ensuite pousser avec :
    548 
    549     $ git push
    550 
    551 Si c'est la première fois que vous utilisez git il est possible qu'il vous
    552 demande des informations à propos de votre identité (nom, prénom, mails).
    553 Vous pouvez y mettre ce que vous voulez.
    554 
    555 ### Si vous souhaitez créer un dépôt
    556 
    557 Admettons vous avez un dépôt en local que vous voulez le partager au monde (ou à
    558 vos ami·es). Il faut d'abord qu'un dépôt vide existe sur le serveur distant,
    559 prêt à recevoir vos données. Pour cela il existe un script `makegitrepo` qui
    560 vous guidera. Vous pouvez le lancer en faisant (si votre config est configuré
    561 pour) :
    562 
    563     $ ssh nom_du_compte@bebou.netlib.re -p 1459 makegitrepo
    564     Nom du dépôt : test2
    565     Description du dépôt : un dépôt de test
    566     Rendre publique sur le web ? (o/n) o
    567     Dépôt Git vide partagé initialisé dans /srv/git/test2/
    568 
    569 Vous pouvez ensuite vous déplacer dans votre dépôt git en local et pousser sur
    570 la branche distante main (celle par défaut) :
    571 
    572     git push --set-upstream ssh://nom_du_compte@bebou.netlib.re:1459/srv/git/test2 main
    573 
    574 ## Il est un peu moche ce site non ?
    575 
    576 Il est un peu austère. Si vous avez des suggestions rejoignez nous et
    577 proposez vos idées !
    578 
    579 ## Est-ce qu'un jour le serveur sera remis droit ?
    580 
    581 Si une autre personne souhaite l'héberger chez elle oui :)
    582 
    583 ## C'est quoi le petit nom du serveur ?
    584 
    585 Il n'en a pas encore mais toutes les propositions sont les bienvenues. Pour
    586 soumettre vos idées vous pouvez accéder à l'url
    587 http://bebou.netlib.re/nom=inserer_nom_ici.  Une liste des propositions sera
    588 publiée d'ici quelques semaines ou mois (on est le 29 avril 2024). Si, par
    589 exemple, vous voulez l'appeler "raspi" vous pouvez copier-coller le lien au
    590 dessus et remplacer `inserer_nom_ici` par `raspi` :
    591 http://bebou.netlib.re/nom=raspi
    592 
    593 Vous allez recevoir une erreur 404 mais c'est normal ! Cette méthode de sondage
    594 est très scientifiquement nommées "par greppage de logs de serveurs web" et est
    595 décrite dans [cet
    596 article](http://arthur.bebou.netlib.re/sondages/#par-greppage-de-logs-de-serveurs-web).
    597 
    598 ## bebou.netlib.re c'est un nom de domaine définitif ?
    599 
    600 Non. Il a le mérite d'être gratos mais il est envisageable de le changer. Il
    601 faudra que ce soit d'un commun accord et qu'une ou plusieurs personnes passent
    602 à la caisse.
    603 
    604 ## Est-ce qu'il est possible d'avoir de l'HTTPS ?
    605 
    606 Oui, cela devrait arriver bientôt, au plus tard au changement de nom de domaine
    607 s'il a lieu. Cela dit il y a des (rares) avantages à conserver des versions
    608 HTTP des sites notamment l'incapacité de certains vieux matériels à utiliser
    609 le protocole HTTPS[^5].
    610 
    611 [^2]: Pour en savoir plus vous pouvez visionner [une conférence sur le sujet](https://podv2.unistra.fr/video/23983-techdays-6-quest-ce-qui-fait-un-bon-mot-de-passe-arthur-pons/)
    612 [^3]: ici "alice"
    613 [^4]: et certaines commandes !
    614 [^5]: parce que les logiciels qui fonctionnent dessus ne le supportent pas ou qu'ils ne font plus confiance aux bonnes autorités de certification.