Gitlab

Résumé Rapide

Adresse: https://code.fosm.space

Manuel utilisateur: https://docs.gitlab.com/ee/user/index.html (En anglais)

Objectifs: Permettre aux membres FOSM de collaborer sur les codes et différentes version de celui-ci et le maintenir à jour

Présentation

Gitlab est initialement une interface au gestionnaire de code source “Git”, permettant de tracer les modifications effectuées sur le code source par les différents contributeurs. Gitlab a petit à petit étendu ses fonctionnalités pour devenir un gestionnaire de projet complet, permettant d’intégrer également la gestion des tâches et de déploiement continu (CI).

Utilisation

Bouton Gitlab entre NExtcloud et Discourse

Gitlab est accessible depuis la page des projets via l’icône dédiée

A la création d’un projet sur  la plateforme, un groupe Gitlab est créé, groupe pouvant contenir plusieurs projets.

Création d’un dépôt GIT : le fonctionnement suit ensuite la documentation de GITLab.

Interface de création d'un dépot Git

L’espace membres permet d’ajouter des membres soit au groupe, soit au projet en cours. Les membres peuvent se voir affecter des “rôles” leur donnant accès à différentes actions allant de l’administration des groupes et projets à la simple consultation du code ou des pages de documentation.

Interface de l'espace membre d'un dépôt Git

L’espace de gestion des fichiers permet de visualiser le code dans les différente branches, ainsi que d’effectuer certaines opérations liées à git (merge, création de branches, diff, ...). Il est aussi possible d’effectuer une “merge request” c’est à dire une demande de fusion des modifications d’une branche dans une autre branche.

Interface de création de branche dans Gitlab

Cette fonctionnalité est très pratique lors de séances de Peer Coding, ou simplement en cas de doute sur le code produit.

Au final Gitlab est un outil extrêmement complexe dont nous ne pouvons pas évoquer toutes les possibilités ici. Une documentation exhaustive est disponible en ligne

Comment configurer Visual Studio Code sur Windows

Si vous utilisez Visual Studio code comme editor de code pour développer (où sa version open-source VSCodium), sur Windows, vous pouvez utiliser l'intégration native pour git. Ici les instructions pour configurer la machine en SSH

Prérequis

• Avoir VS Code ou VS Codium installé et à jour
• Avoir Git for Windows installé et à jour

Procédure

1. Ouvre le menu Start de Windows
2. Ouvrir Programmes et Fonctionnalités
3. Cliquer sur Gérer les fonctionnalités facultatives.
4. Installer OpenSSH (Client)

   

   Installation de OpenSSH

   
   
5. Ouvrir l'application Git for Windows
6. Dans le terminal exécuter la commande {{{ssh-keygen.exe}}} en confirmant tout en cliquant "Entrée". Cette commande aura créé un dossier nommé {{{.ssh}}} dans votre dossier utilisateur {{{C:/Users/<username>}}}
7. Aller dans propre profil sur https://code.fosm.space, Settings, SSH Keys
8. Copier le contenu du fichier .ssh/id_rsa.pub dans l'espace "Key" et sauvegarder. Maintenat votre clé publique est enregistré dans la forge logicielle

Cloner un projet depuis Visual Studio

Une fois que votre clé est en place, vous pouvez effectuer les action de clone, push, pull etc... directement depuis l'application.

1. Ouvrir Visual Studio Code (ou Codium) et cliquer sur l'icône Source Control à gauche
2. Clone Project
3. Insérer l'adresse du répertoire git en version SSH (format git@code.federation-openspacemakers.com/projet/sous-projet.git)
4. Sélectionner un dossier sur votre machine dans lequel cloner le répertoire
5. Après le téléchargement, vous pouvez ouvrir le projet dans VSCode directement

Écran Source Control de VSCode

ssh-keygen