Wiki FOSM - Contributions [fr]

Gitlab

2020-05-14T18:01:59Z

Tid : /* Procédure */

==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==
[[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

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 [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.
[[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.
[[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.

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]] 
#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]]
 
[[Fichier:Ssh-keygen.png|vignette|ssh-keygen]]

Gitlab

2020-05-14T18:01:02Z

Tid : /* Procédure */

==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==
[[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

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 [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.
[[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.
[[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.

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]] 
#Ouvrir l'application '''Git for Windows'''
#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>}}}
#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]]
 
[[Fichier:Ssh-keygen.png|vignette|ssh-keygen]]

Gitlab

2020-05-14T17:59:25Z

Tid : /* Procédure */

==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==
[[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

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 [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.
[[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.
[[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.

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]] 
#Ouvrir l'application '''Git for Windows'''
#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>}}}
#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:Ssh-keygen.png|vignette|ssh-keygen]]

Fichier:Écran Visual Studio Code.png

2020-05-14T17:57:20Z

Tid :

VSCode Source Control

Fichier:Ssh-keygen.png

2020-05-14T17:49:19Z

Tid :

Commande ssh-keygen

Gitlab

2020-05-14T17:47:23Z

Tid :

==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==
[[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

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 [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.
[[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.
[[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.

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'''
# Cliquez sur '''Gérer les fonctionnalités facultatives'''.
# Installer '''OpenSSH (Client)'''[[Fichier:OpenSSH install.png|alt=OpenSSH|vignette|Installation de OpenSSH]] 
# Ouvrir l'application '''Git for Windows'''
# Dans le terminal exécuter la commande {{{ssh-keygen.exe}}} en confirmant tout en cliquant "Entrée". Cette commande aura crée un dossier nommé {{{.ssh}}} dans votre dossier utilisateurs {{{C:/Users/<username>}}}

Gitlab

2020-05-14T17:45:37Z

Tid :

==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==
[[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

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 [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.
[[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.
[[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.

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'''
# Cliquez sur '''Gérer les fonctionnalités facultatives'''.
# Installer '''OpenSSH (Client)'''[[Fichier:OpenSSH install.png|alt=OpenSSH|vignette|Installation de OpenSSH]] 
# Ouvrir l'application '''Git for Windows'''
# Dans le terminal exécuter la commande {{ssh-keygen.exe}} en confirmant tout en cliquant "Entrée". Cette commande aura crée un dossier nommé {{.ssh}} dans votre dossier utilisateurs {{C:/Users/<username>}}

Fichier:OpenSSH install.png

2020-05-14T17:41:52Z

Tid :

Prise d'écran pour montrer comment installer OpenSSH