Différences

Ci-dessous, les différences entre deux révisions de la page.

--- documentation:technique:git [2017/12/01 23:50] – [Dépot Git de Mycélium] cacatoes
+++ documentation:technique:git:creer-un-depot-git-centralise [2021/04/16 14:27] (Version actuelle) – ↷ Page déplacée de documentation:technique:creer-un-depot-git-centralise à documentation:technique:git:creer-un-depot-git-centralise cacatoes
@@ Ligne 1: / Ligne 1: @@
-====== Dépot Git de Mycélium ======
+====== Mise en place d'un dépot Git ======
-Nous souhaitons avoir accès à un dépot Git pour poser nos scripts Ansible, et éventuellement d'autres choses.
+TODO Cette doc est brouillon.
-Le dépot est actuellement hébergé sur [[.:machines:mplx]].
+Des tutos :
-Cette page raconte d'abord comment accéder et utiliser le dépot Git. Puis elle raconte la mise en place de ce dépot Git.
+  * https://git-scm.com/book/fr/v1/Git-sur-le-serveur-Mise-en-place-du-serveur (celui suivi ici)
-===== Utiliser le dépot Git=====
+  * https://git-scm.com/docs/git-shell.html (ajouter un message de bienvenue pour ssh)
+  * https://opensource.com/article/17/8/ansible-environment-management (sauce ansible)
-==== Envoie ta clé SSH dedieu ====
+  * https://stackoverflow.com/questions/39204455/ansible-how-to-init-git-bare-repository-and-clone-it-to-the-same-machine (sauce ansible bis)
+  * https://linuxfr.org/users/postroutine/journaux/serveur-git-avec-gitolite
-D'abord, vous devez m'envoyer votre clé publique SSH (si par email, en pièce jointe de préférence pour éviter les soucis liés à mime/encodage).
-==== Infos sur l'hôte ====
-Sur mon réseau local la machine s'appelle ''mplgit'', mais sur internet, il s'agit de ''cacatoes.ml''. L'accès SSH se fait sur le port 20122.
-Le compte utilisateur est ''mycelium''.
-Dans mon ''.ssh/config'', que vous pouvez copier tel quel, j'ai :
-<code>
-Host mplgit
-  Hostname cacatoes.ml
-  HostKeyAlias mplgit
-  CheckHostIP yes
-  Port 20122
-</code>
-==== Vérifier l'authentification ====
-Si vous avez copié mon bout de config ssh :
-<code>$ ssh mycelium@mplgit</code>
-Sinon :
-<code>$ ssh mycelium@cacatoes.ml -p 20122</code>
-==== Réglages initiaux du dépôt mycelium.git ====
-//A compléter, voir aussi: https://wiki.monitoring-fr.org/infra/git //
-Récupérer le contenu du dépot :
-<code>
-$ git clone ssh://mycelium@cacatoes.ml:20122/~/mycelium.git
-</code>
-ou bien (à condition d'avoir fait la manip précédente du ''.ssh/config'') :
-<code>
-$ git clone mycelium@mplgit:/home/mycelium/mycelium.git
-</code>
-Après le clone, la première fois, il est préférable de configurer les informations personnelles.
-<code>
-$ git config --local --add user.name "<Prénom> <Nom>"
-$ git config --local --add user.email "<email>"
-</code>
-==== Usage basique du dépôt mycelium.git ====
-Récupérer une version récente des fichiers du dépot :
-<code>
-$ git pull
-</code>
-Consulter le journal d'activité :
-<code>
-$ git log
-</code>
-Ajouter un fichier ou répertoire :
-<code>
-$ git add file
-$ git add directory
-</code>
-Commiter des changements (il faut ajouter les fichiers avant) :
-<code>
-$ git commit -m "Mon super commentaire explicite"
-</code>
-Envoyer le commit sur le dépôt centralisé
-<code>
-$ git push
-</code>
-==== Le répertoire 'keys' ====
-Le répertoire ''keys'' à la racine du dépôt GIT de mycélium stocke les clés publiques SSH des administeurs Mycélium.
-Le format du fichier de la clé doit être : ''<username>.pub''.
-Préférer les clés RSA (2048 ou supérieur) ou EC25519. (éviter les clés DSA et ECDSA)
-Envoyer sa clé publique ssh dedans :
-<code>
-git pull
-git add keys/<username>.pub
-git commit -m "Add ssh public key for <username>"
-git push
-</code>
-==== Erreurs diverses =====
-:!: RSA host key for mplserv has changed and you have requested strict checking.
-Ce problème est lié à ssh (et non pas à git). Il signifie que l'empreinte SSH du serveur a changé, ce qui pose la question de son authenticité, et vous devez vous enquérir du pourquoi : réinstallation du serveur, changement de la configuration réseau qui fait parvenir sur un autre serveur SSH...
-A moins que vous ne connaissiez la raison de ce changement, vous devriez contacter l'administrateurice du serveur.
-Un peu de debug possible avec :
-<code>ssh -vvv mycelium@mplserv</code>
-===== Mise en place du dépot =====
-Tout a commencé ... par un tutorial qui se promenait sur la toile.
-  * https://git-scm.com/book/fr/v1/Git-sur-le-serveur-Mise-en-place-du-serveur
-Plutôt que d'utiliser git+ssh, on pourra se pencher sur gitolite et ses frérots : https://linuxfr.org/users/postroutine/journaux/serveur-git-avec-gitolite
 En résumé :
@@ Ligne 134: / Ligne 17: @@
   - modification de /etc/passwd pour usage du shell restreint git-shell (ou mieux: ''chsh -s /usr/bin/git-shell''). (Ne pas prendre à court la doc en le faisant trop tôt.)
   - ajout de clés SSH des usageres du dépot Git
-Petit détour, cette doc indique entre autre comment ajuster un message de bienvenue pour git-shell : https://git-scm.com/docs/git-shell.html
 Initialisation du dépot :