« Gitlab » : différence entre les versions
(Création par Co/co du FMN) |
|||
| (6 versions intermédiaires par 2 utilisateurs non affichées) | |||
| Ligne 1 : | Ligne 1 : | ||
== Résumé Rapide == | ==Résumé Rapide== | ||
Adresse: | Adresse: https://code.fosm.space | ||
Manuel utilisateur: (En anglais) | 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 | Objectifs: Permettre aux membres FOSM de collaborer sur les codes et différentes version de celui-ci et le maintenir à jour | ||
== Présentation == | ==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). | 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 == | ==Utilisation== | ||
[[Fichier:Bouton GItlab.png|alt=Bouton Gitlab|vignette|Bouton Gitlab entre NExtcloud et Discourse]] | |||
Gitlab est accessible depuis la page des projets via l’icône dédiée | 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. | 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. | Création d’un dépôt GIT : le fonctionnement suit ensuite [https://docs.gitlab.com/ee/user/index.html la documentation de GITLab]. | ||
[[Fichier:Création dépot Git.png|alt=Création dépôt git|centré|vignette|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. | 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. | ||
[[Fichier:Espace membre git.png|alt=Espace membre git|centré|vignette|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. | 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. | ||
[[Fichier:Création de branche.png|alt=Création de branche gitlab|centré|vignette|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. | 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<br /> | |||
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 [https://vscodium.com/ 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 [https://git-scm.com/download/win Git for Windows] installé et à jour | |||
===Procédure=== | |||
#Ouvre le menu Start de Windows | |||
#Ouvrir '''Programmes et Fonctionnalités''' | |||
#Cliquer sur '''Gérer les fonctionnalités facultatives'''. | |||
#Installer '''OpenSSH (Client)'''[[Fichier:OpenSSH install.png|alt=OpenSSH|vignette|Installation de OpenSSH]]<br /> | |||
#Ouvrir l'application '''Git for Windows''' | |||
#Dans le terminal exécuter la commande <code>ssh-keygen.exe</code> en confirmant tout en cliquant "Entrée". Cette commande aura créé un dossier nommé <code>.ssh</code> dans votre dossier utilisateur <code>C:/Users/<username></code> | |||
#Aller dans propre profil sur https://code.fosm.space, '''Settings, SSH Keys''' | |||
#Copier le contenu du fichier <code>.ssh/id_rsa.pub</code> 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. | |||
#Ouvrir Visual Studio Code (ou Codium) et cliquer sur l'icône '''Source Control''' à gauche | |||
#'''Clone Project''' | |||
#Insérer l'adresse du répertoire git en version SSH (format <code>git@code.federation-openspacemakers.com/projet/sous-projet.git</code>) | |||
#Sélectionner un dossier sur votre machine dans lequel cloner le répertoire | |||
#Après le téléchargement, vous pouvez ouvrir le projet dans VSCode directement | |||
[[Fichier:Écran Visual Studio Code.png|alt=VSCode|vignette|Écran Source Control de VSCode]] | |||
<br /> | |||
[[Fichier:Ssh-keygen.png|vignette|ssh-keygen]] | |||
Dernière version du 14 mai 2020 à 19:01
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
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.
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.
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.
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
- Ouvre le menu Start de Windows
- Ouvrir Programmes et Fonctionnalités
- Cliquer sur Gérer les fonctionnalités facultatives.
- Installer OpenSSH (Client)
Installation de OpenSSH - Ouvrir l'application Git for Windows
- Dans le terminal exécuter la commande
ssh-keygen.exeen confirmant tout en cliquant "Entrée". Cette commande aura créé un dossier nommé.sshdans votre dossier utilisateurC:/Users/<username> - Aller dans propre profil sur https://code.fosm.space, Settings, SSH Keys
- Copier le contenu du fichier
.ssh/id_rsa.pubdans 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.
- Ouvrir Visual Studio Code (ou Codium) et cliquer sur l'icône Source Control à gauche
- Clone Project
- Insérer l'adresse du répertoire git en version SSH (format
git@code.federation-openspacemakers.com/projet/sous-projet.git) - Sélectionner un dossier sur votre machine dans lequel cloner le répertoire
- Après le téléchargement, vous pouvez ouvrir le projet dans VSCode directement
