Outils pour utilisateurs

Outils du site


Panneau latéral

Mycélium

Documentation

Travaux

Membres

Wiki

documentation:services:git

Usage des dépots Git de Mycélium

Liste des dépots Git

Nos dépots Git sont hébergés sur mplx, il y en a plusieurs :

Nom du dépot Utilisateur Visibilité Contenu
mycelium-public mycelium public sensibilisation
mycelium mycelium sera public scritps d'administration, playbooks ansible
mycelium-pass   mycelium privé le password-store lié à notre clé GPG de l'email contact

Accès aux dépots (en résumé)

Nom du dépot Commande
mycelium-public git clone git://mplx.ml/~mycelium/mycelium-public.git
mycelium git clone mycelium@mplgit:mycelium.git
mycelium-pass git clone mycelium@mplgit:mycelium-pass.git

Note : Les dépots privés ne sont accessibles que si vous avez transmis votre clé (publique) SSH.

Accès public

L'accès public n'est possible qu'en lecture, pas en écriture.

La commande pour cloner un dépot public est la suivante :

git clone git://mplx.ml/~utilisateur/nom_du_depot.git

Pour le dépot public de Mycélium, il s'agira donc de :

git clone git://mplx.ml/~mycelium/mycelium-public.git

Accès authentifié

L'accès authentifié (privé) permet un accès en lecture et écriture aux dépots.

Envoie ta clé SSH dedieu

D'abord, vous devez m'envoyer (à cacatoès) votre clé publique SSH (si par email, en pièce jointe de préférence pour éviter les soucis liés à mime/encodage).

Attendre la confirmation que votre clé a été ajoutée. Vous pourrez accéder aux dépots Git via l'un des comptes utilisateur de Mycélium (voir Liste des dépots)

Connexion SSH (avec ProxyJump)

Suivez les instructions décrites dans mplx : accès SSH

Vérifier l'authentification

Après avoir mis en place le fichier de config ssh :

$ ssh mycelium@mplgit

Vous n'obtiendrez pas de shell, mais cela vous permettra de valider l'empreinte SSH de mplgit et de vérifier que votre clé SSH est acceptée par le serveur.

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 :

ssh -vvv mycelium@mplgit

Usage basique de git

Étapes initiales

Récupérer le contenu du dépot :

$ git clone mycelium@mplgit:mycelium.git

Après un premier clonage, il est préférable de configurer les informations personnelles.

$ git config --local --add user.name "<Prénom> <Nom>"
$ git config --local --add user.email "<email>"

Récupérer une version récente des fichiers du dépot

$ git pull

Consulter le journal d'activité

$ git log

Ajouter un fichier ou répertoire

$ git add file
$ git add directory

Commiter des changements (il faut ajouter les fichiers avant)

$ git commit -m "Mon super commentaire explicite"

Envoyer le commit sur le dépôt centralisé

$ git push

Aller plus loin

Une documentation sympa pour creuser l'usage de Git : https://www.miximum.fr/blog/enfin-comprendre-git/

Organisation du contenu des dépots

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 :

git pull
git add keys/<username>.pub
git commit -m "Add ssh public key for <username>"
git push
documentation/services/git.txt · Dernière modification: 2019/11/03 12:17 par tyrben