|
|
[:arrow_backward: Accueil](Home) | [Gestion de son compte :arrow_forward:](Gestion%20de%20son%20compte)
|
|
|
|
|
|
[[_TOC_]]
|
|
|
|
|
|
## Première connexion
|
|
|
|
|
|
À la première connexion à Gitlab, vous serez invité à accepter les conditions générales d'utilisation. Merci d'apporter une attention particulière au paragraphe sur la "Propriété intellectuelle", notamment sur les licences.
|
|
|
|
|
|
Ensuite, votre compte est automatiquement créé. Vous pouvez y accéder avec le menu en haut à droite en cliquant sur le lien _Edit Profile_ :
|
|
|
|
|
|
![image](uploads/5f7aff8dc0a68373a0c922aead327ac3/image.png)
|
|
|
|
|
|
Les informations suivantes ont été automatiquement renseignées sur la base des informations transmises par Janus :
|
|
|
|
|
|
* Full name (nom et prénom)
|
|
|
* Email (adresse mail utilisée pour l'authentification Janus)
|
|
|
* Username (identifiant interne, soit de type prenom.nom, soit identifiant opaque pour les comptes plus récents)
|
|
|
|
|
|
Par défaut, vous n'êtes membre d'aucun projet ni d'aucun groupe, mais [vous pouvez en créer](Gestion%20des%20groupes%20et%20des%20projets).
|
|
|
|
|
|
## Groupes et projets
|
|
|
|
|
|
### Projet
|
|
|
|
|
|
Pour gérer un code source avec git, il faut le mettre dans un projet Gitlab. Tous les utilisateurs peuvent créer des projets.
|
|
|
|
|
|
Un projet est constitué par défaut de :
|
|
|
|
|
|
* dépôt du code (avec [gestion des branches et des tags](Gestion%20des%20branches%20et%20des%20tags))
|
|
|
* gestion des issues que l'on peut catégoriser avec des libellés et regrouper dans des _milestones_
|
|
|
* gestion des merge-requests (voir [gestion des branches et des tags](Gestion%20des%20branches%20et%20des%20tags))
|
|
|
* [Intégration continue](Mise%20en%20place%20de%20l'int%C3%A9gration%20continue) (nécessite un runner)
|
|
|
* un Wiki
|
|
|
* des _Snippets_ (morceaux de code ou de texte non forcément liés au code source, comme des pense-bêtes)
|
|
|
|
|
|
Chaque projet doit appartenir à un groupe parent.
|
|
|
|
|
|
Chaque utilisateur a son propre groupe personnel dans lequel il peut créer ses projets. Ce groupe porte le nom de l'identifiant interne de l'utilisateur dans Gitlab, donc soit du type prenom.nom.x, soit un identifiant opaque sur 8 caractères pour les comptes plus récents.
|
|
|
|
|
|
Il est possible de modifier cet identifiant (appelé _username_) avec [une procédure](Gestion-de-son-compte#modification-du-username).
|
|
|
|
|
|
### Groupe
|
|
|
|
|
|
Un groupe peut contenir d'autres groupes, et des projets.
|
|
|
|
|
|
Dans Gitlab, la gestion des droits se fait en ajouter des utilisateurs en tant que membres de groupes ou de projets, avec un [rôle particulier](https://docs.gitlab.com/ee/user/permissions.html) (Developer, Reporter, ...)
|
|
|
|
|
|
Gitlab gère la hiérarchie de ces droits. Un membre d'un groupe est également membre des sous-groupes et projet de ce groupe.
|
|
|
|
|
|
## _Repository_ d'un projet
|
|
|
|
|
|
### Création d'un projet
|
|
|
|
|
|
La création d'un projet se fait en cliquant sur le bouton :heavy_plus_sign: disponible dans la barre d'outils :
|
|
|
|
|
|
![image](uploads/7d67093ea45f3d1f518b431603d23e52/image.png)
|
|
|
|
|
|
Il est alors proposé de créer soit un projet vierge, soit un projet basé sur des _templates_ proposés par Gitlab, ou alors d'importer un export d'un projet depuis une autre instance de Gitlab.
|
|
|
|
|
|
Il est ensuite demandé la visibilité du projet :
|
|
|
|
|
|
- _Private_ : le projet n'est accessible qu'aux personnes authentifiées et membres de ce projet (ou d'un groupe parent)
|
|
|
- _Internal_ : le contenu du projet est accessible à toute personne authentifiée
|
|
|
- _Public_ : le projet est accessible aux personnes non authentifiée
|
|
|
|
|
|
### Code source et clone d'un projet
|
|
|
|
|
|
Une fois le projet créé, s'il est vierge, alors des instructions sont affichées afin de guider le développeur à initier et pousser du code dans ce projet.
|
|
|
|
|
|
De manière générale, le code source d'un projet est accessible via le lien _Repository > Files_ à gauche :
|
|
|
|
|
|
![image](uploads/ff17a79a39fd86c1ba22a239cb172769/image.png)
|
|
|
|
|
|
Le bouton _Clone_ permet de cloner le projet en local :
|
|
|
|
|
|
![image](uploads/0543cdc2413fcf35341842e7e0bbfe08/image.png)
|
|
|
|
|
|
Il est à noter que seul le protocole HTTPS est disponible. Il n'est pas possible de faire du _Git over SSH_.
|
|
|
|
|
|
### Liste des commits
|
|
|
|
|
|
La liste des commits est accessible via _Repository > Commits_ :
|
|
|
|
|
|
![image](uploads/52e83d56478e25fc519f0f8e7d6528b4/image.png)
|
|
|
|
|
|
On peut visualiser les commits d'une branche ou d'un tag donné. Chaque commit est un lien qui envoie vers une page listant les modifications apportées par ce commit (nombre de fichiers modifiés, nombre d'ajout ou suppression de lignes, _diff_ des modifications, ...).
|
|
|
|
|
|
Le bouton _Options_ permet d'effectuer des actions avancées (cherry-pick, revert, ...) ou de récupérer les modifications au format _diff_ ou _patch_ :
|
|
|
|
|
|
![image](uploads/ae40851e4e08ecf6aa4d60ae51301292/image.png)
|
|
|
|
|
|
### Liste des branches et des tags
|
|
|
|
|
|
De la même manière, la liste des branches et des tags est disponible dans le menu _Repository > Branches_ et _Repository > Tags_.
|
|
|
|
|
|
### Wiki
|
|
|
|
|
|
Chaque projet possède par défaut un wiki, accessible par le menu _Wiki_ à gauche. Il est à noter que le wiki est également un dépôt Git, accessible via le bouton _Clone repository_ :
|
|
|
|
|
|
![image](uploads/8b7e678afd224ffd4cfeddf9251fd705/image.png)
|
|
|
|
|
|
L'url dépôt est du type \`<https://src.koda.cnrs/fr/mon/groupe/projet.wiki.git>.
|
|
|
|
|
|
### Snippets
|
|
|
|
|
|
Les snippets permettent de stocker du texte (morceaux de code, notes, penses-bêtes, ...) au niveau du projet, sans que cela ne fasse partie du code source du projet. Les snippets sont accessibles par le menu _Snippets_ à gauche.
|
|
|
|
|
|
Il est à noter que les snippets ont également trois niveaux de visibilité : _Private_, _Internal_ et _Public_.
|
|
|
|
|
|
## Liens utiles
|
|
|
|
|
|
- [Liste des commandes git fréquentes](https://about.gitlab.com/images/press/git-cheat-sheet.pdf)
|
|
|
- [Documentation officielle Git](https://git-scm.com/book/en/v2)
|
|
|
- [Alias de commandes Git](https://snyk.io/blog/10-git-aliases-for-faster-and-productive-git-workflow/)
|
|
|
- [En cas de mauvaise manipulation Git](https://ohshitgit.com/)
|
|
|
|
|
|
---
|
|
|
|
|
|
[:arrow_backward: Accueil](Home) | [Gestion de son compte :arrow_forward:](Gestion%20de%20son%20compte) |
|
|
\ No newline at end of file |