wiki

Wiki for sbi.re
Log | Files | Refs | Submodules | README

git.md (2800B)


1---
2title: Git
3author: flupe
4updated: 16/11/2021
5---
6
7Les sbires hébèrgent leur propre serveur git pour les services faits maison.
8Les dépôts publiques se consultent à l'addresse [git.sbi.re].
9
10[git.sbi.re]: https://git.sbi.re
11
12Il est possible de cloner n'importe quel dépôt *publique* --- sans
13autorisation préalable --- en faisant :
14
15    $ git clone https://git.sbi.re/depot
16
17Les clones réalisés ainsi sont **en lecture seule**.
18
19## Autorisation et clés SSH
20
21Pour pouvoir contribuer facilement aux dépôts et pouvoir héberger les tiens, il
22va falloir demander l'accès à un admin et lui fournir une clé publique SSH qui
23servira à t'authentifier.
24
25L'administrateur n'a plus qu'à exécuter la commande :
26
27    $ cat id.pub > ssh git@sbi.re keys add -user <pseudo> <appareil>
28
29Le serveur SSH est accessible depuis l'exterieur sur le port `222` plutot que le
30port usuel `22`, il faut donc penser à parametrer SSH pour utiliser le bon port
31systematiquement. Dans `~/.ssh/config`, rajouter :
32
33    Host sbi.re
34    Port 222
35
36## Dépôts utilisateurs
37
38Tu peux dès à présent héberger tes propres dépôts sous le format
39`~pseudo/depot`. Pour en créer un nouveau, il suffit d'ajouter un remote et de
40push, il sera créé sur le serveur automatiquement.
41
42    $ git remote add origin git@sbi.re:~pseudo/projet
43    $ git push -u origin master
44
45Par défaut, le dépôt est publique, c'est à dire lisibile --- et clonable --- par
46tous. En revanche, tu es le seul à pouvoir le modifier.
47
48## Sbire Shell
49
50Tu peux accéder à notre [shell maison][shell], qui te permet d'exécuter quelques
51commandes d'administration.
52
53    $ ssh git@sbi.re
54
55Il est possible de lancer les commandes sans utiliser le shell interactif :
56
57    $ ssh git@sbi.re <commande> [arguments]
58
59Pour un résumé des commandes disponibles :
60
61    $ ssh git@sbi.re help
62
63[shell]: https://git.sbi.re/shell/log.html
64
65### Changer la description d'un dépôt
66
67A condition d'avoir les droits en écriture, exécuter la commande :
68
69    $ ssh git@sbi.re desc <depot> <description>
70    $ ssh git@sbi.re desc wiki "Le wiki des sbires"
71
72### Gérer ses clés SSH
73
74Pour ajouter d'autres clés SSH d'authentification, pour de nouveaux appareil,
75faire ainsi :
76
77- Lister les clés actuellement autorisées :
78
79      $ ssh git@sbi.re keys
80
81- Ajouter une nouvelle clé SSH `id.pub` pour l'appareil `laptop` :
82
83      $ cat id.pub > ssh git@sbi.re keys add laptop
84
85## Autres
86
87Aucune interface n'est en ligne pour contribuer aux dépôts à l'instar de [Github],
88[Gitlab] ou autre plateforme du genre.
89C'est un choix assumé, et la méthode à privilégier et d'utiliser [le mail](wiki:meta/mail).
90Voir le [guide suivant](https://git-send-email.io/) pour apprendre à collaborer
91par mail.
92
93[Gitlab]: https://gitlab.com
94[Github]: https://github.com
95