Différences

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

--- git [2017/01/28 23:59] – Explications : mais oui au fait; c'est quoi git ? capslock
+++ git [2017/01/29 13:10] – capslock
@@ Ligne 31: / Ligne 31: @@
 ===== Liste des dépôts =====
-^ Nom du dépôt      ^ Description       ^ Conditions d'accès ^
+Les dépôts sont gérés par [[gitlab|Gitlab]].
-|membres| Dépôt dédié aux membres et aux documents sur la vie de l'association : Comptes-rendus de réunion, d'assemblée générale, etc.| Accès réservé aux membres|
-|graphisme| Dépôt dédié aux documents graphiques : logos, flyer, templates, etc.| Accès libre|
-|sdtan| Dépôt dédié au projet sur le SDTAN (schémas directeurs territoriaux d'aménagement numérique)| Accès libre|
-|adminsys| Dépôt dédié au groupe de travail adminsys| Accès réservé |
-|site-pelican| Dépôt dédié à notre site Internet  - Techno : Pelican| Accès libre|
-|si| Dépôt dédié à notre SI : Coin - Techno : Django| Accès réservé|
-**TODO : compléter avec les dépôts restants**
+Voici les principaux dépôts utilisés par l'association :
-===== Comment accéder aux dépôts de FAImaison ? =====
-Reprendre des infos ci-dessous, reformuler version user-friendly. Ajouter quelques noms de logiciels  avec interface graphique.
+^ Nom du dépôt      ^ Description                                            ^ Conditions d'accès ^
+|membres            | Dépôt dédié aux membres et aux documents sur la vie de l'association : Comptes-rendus de réunion, d'assemblée générale, etc.| Accès réservé aux membres                                    |
+|graphisme          | Dépôt dédié aux documents graphiques : logos, flyer, templates, etc.| Accès libre|
+|sdtan              | Dépôt dédié au projet sur le SDTAN (schémas directeurs territoriaux d'aménagement numérique)| Accès libre|
+|adminsys           | Dépôt dédié au groupe de travail adminsys              | Accès réservé |
+|site-pelican       | Dépôt dédié à notre site Internet  - Techno : Pelican  | Accès libre|
+|si                 | Dépôt dédié à notre SI : Coin - Techno : Django        | Accès réservé|
-===== Serveurs git =====
+Par ailleurs les groupes Gitlab suivants sont définis :
-Voir page [[backup#depot git|backups]].
+^ Nom du dépôt        ^ Description                            ^ Conditions d'accès                                            ^
+|faimaison-adminsys   | projets utilisés par les adminsys      | lecture = membres ; contribution = adminsys                   |
+|faimaison-bureau     | projets utilisés par le bureau         | lecture = membres du bureau ; contribution = membres du bureau|
+|faimaison-membres    | projets utilisés par les membres       | lecture = membres de faimaison ; contribution = membres de faimaison |
+|faimaison-public     | projets publics                        | lecture = tout le monde ; contribution = membres de faimaison |
-Le service git est accessible via SSH (voir [[#methodes_d_acces|ci-dessous]] pour les autres méthodes d'accès) :
+Pour contribuer il vous faut un accès.
-  * ''faimaison-git@git.faimaison.net'' (maître)
-  * ''faimaison-git@git-slave.faimaison.net'' (esclave)
+===== Comment accéder aux dépôts de FAImaison ? =====
-^ Machine               ^ Nom               ^ Contact ^ SSH (utilisateur) ^ Gitweb ^ git-daemon ^
+Rendez-vous sur la page dédiée à [[gitlab|Gitlab]]
-| chomsky.autogeree.net | git-slave.faimaison.net | jca+fma@wxcvbn.org | Oui (faimaison-git) | Oui    | Oui |
-| trompe-souris.faimaison.net| git.faimaison.net | adminsys@faimaison.net | Oui (faimaison-git) | TODO    | Oui |
-===== Méthodes d'accès =====
-Le dépôt git de FAImaison est accessible par les moyens suivants :
+===== Serveurs git =====
-  * **[[#git-daemon|git-daemon]]** (lecture uniquement)
+Voir page [[backup#depot git|backups]].
-  * **[[#gitweb|gitweb]]** (lecture uniquement)
-  * **[[#utilisation_en_lecture_ecriture|gitolite]]** //via// ssh (lecture/écriture avec contrôle d'accès)
-==== Utilisation en lecture seule ====
+Le service git est accessible via SSH (voir [[#methodes_d_acces|ci-dessous]] pour les autres méthodes d'accès) :
-Ces méthodes d'accès ne demandant aucune authentification, certains dépôts ne sont pas accessibles par ce biais.
-=== git-daemon ===
-Il est possible de cloner n'importe quel dépôt accessible en lecture :
-  git clone git://git.faimaison.net/testing
-Pour obtenir la liste des dépôts disponibles, il faut passer par gitolite ou gitweb.
-=== gitweb ===
-Accessible sur http://git.faimaison.net (redirection "temporaire").
+^ Machine               ^ Nom                     ^ Role      ^ Contact                ^ utilisateur SSH     ^ Soft       ^
+| riboul.faimaison.net  | git.faimaison.net       | Maître    | adminsys@faimaison.net | git                 | gitlab     |
+| chomsky.autogeree.net | git-slave.faimaison.net | Esclave   | jca+fma@wxcvbn.org     | faimaison-git       | git-daemon |
 ==== Utilisation en lecture/écriture ====
+Les dépôts publics
 === Authentification ===
-Toute l'authentification passe par SSH, //gitolite// ne s'occupe que des aspects liés à git.
+Les comptes sont gérés par Gitlab.
+Pour contribuer, vous avez deux possibilités :
+* Utiliser l'interface Web de Gitlab
+* Utiliser vos outils, sur votre ordinateur. Dans ce cas, il vous faut une clé SSH pour contribuer (voir ci-dessous)
 == Générer sa paire de clés SSH ==
@@ Ligne 103: / Ligne 94: @@
 Ceci a pour but d'empêcher un tiers d'utiliser votre clé (il lui faudra connaître votre passphrase).
-== Envoyer sa clé publique ==
+Dès que vous avez votre paire de clé, il suffit d'ajouter votre clé **publique** (contenue dans le fichier terminant par .pub) dans votre compte Gitlab.
-Pour avoir accès au dépôt git, il faut envoyer la clé publique générée (''~/.ssh/faimaison.pub''), avec le nom d'utilisateur souhaité, aux administrateurs de gitolite à l'adresse ''git (chez) faimaison.net''.
+== Authentification à deux facteurs ==
-Les administrateurs doivent pouvoir vérifier votre identité, ce qui se fait principalement par deux biais :
+Pour protéger votre compte Gitlab, vous pouvez activer l'authentification à 2 facteurs (2FA ; accessible dans les [[https://git.faimaison.net/profile/account|paramètres de votre compte]]).
-  * soit **en signant votre mail avec GPG**. Çela suppose qu'au moins un des membres de l'association ait signé votre clé GPG (pour qu'on puisse vérifier votre identité).
-  * soit on vient à une réunion avec sa clé publique SSH sur une clé USB.
-:!: Si vous envoyez votre clé publique par mail, faites le avec une **pièce jointe**.
+Quand l'authentification à 2 facteurs est activée pour votre compte Gitlab, vous devrez entrer les informations suivantes pour vous connecter :
-En effet copier/coller une clé est le meilleur moyen de la retrouver en morceaux.
+  * votre nom d'utilisateur
+  * votre mot de passe
+  * un code à usage unique donné par l'application dont on parle ci-dessous
+Pour obtenir un code à usage unique, il vous faut une application compatible "Google Authenticator", il en existe des libres comme [[https://f-droid.org/repository/browse/?fdfilter=freeotp&fdid=org.fedorahosted.freeotp|FreeOTP]].
 === Utilisation ===
-Fonctionnement : tout se fait en ssh en passant par //gitolite//. Si on essaie de se connecter directement :
-  ssh -i ~/.ssh/faimaison faimaison-git@git.faimaison.net info
+== Par l'interface Web de Gitlab ==
+== Via vos outils Git installés sur votre machine ==
+Fonctionnement : tout se fait en ssh. Si on essaie de se connecter directement :
+  ssh -i ~/.ssh/faimaison git@git.faimaison.net
+On obtient un message de bienvenue :
-on a la liste des dépôts accessibles en lecture et/ou écriture.
+  PTY allocation request failed on channel 0
+  Welcome to GitLab, CapsLock!
+  Connection to git.faimaison.net closed.
 Pour dire à ssh de toujours utiliser cette clé et cet utilisateur (et donc pour simplifier la vie à git), on peut mettre quelque chose du genre dans son fichier ''~/.ssh/config'' :
@@ Ligne 132: / Ligne 135: @@
 Ensuite, il suffit de cloner comme d'habitude :
-  git clone git.faimaison.net:testing
+  git clone git@gitlab.faimaison.net:faimaison-membres/membres.git
+Pour trouver l'adresse du dépot, il suffit d'aller sur la page du dépôt (exemple https://gitlab.faimaison.net/faimaison-membres/membres) et de la récupérer ici :
+{{ ::depot.png?direct&500 |}}
 Noter qu'en l'absence de précision du protocole (e.g. ''%%git://git.faimaison.net%%'' ou ''%%ssh://git.faimaison.net%%''), //git// utilise //ssh//.
@@ Ligne 138: / Ligne 145: @@
 === Création d'un nouveau dépôt ===
-Pour créer un nouveau dépôt, il faut contacter les administrateurs (voir adresse email ci-dessus).
+Pour créer un nouveau dépôt, vous pouvez-le faire via l'interface Web de [[gitlab|Gitlab]]
 === Mise à jour du dépôt distant ===
 Une fois que votre nouveau dépôt a été créé, pour y pousser votre travail local, il faut commencer par renseigner son URL :
+FIXME
   git remote add origin git.faimaison.net:mon_beau_depot