From 57272ff64bfff817c3c92383b7244f16a15149d7 Mon Sep 17 00:00:00 2001 From: Armand Bahi <armand.bahi@veremes.com> Date: Wed, 21 Nov 2018 14:29:28 +0100 Subject: [PATCH] Ajout section notions gitlab --- gitlab/index.rst | 4 +--- gitlab/{ => notions_git}/compte_gitlab.md | 16 ++++++++-------- gitlab/{ => notions_git}/depot_gitlab.md | 10 +++++----- gitlab/notions_git/index.rst | 9 +++++++++ gitlab/{ => notions_git}/objets_gitlab.md | 10 +++++----- 5 files changed, 28 insertions(+), 21 deletions(-) rename gitlab/{ => notions_git}/compte_gitlab.md (90%) rename gitlab/{ => notions_git}/depot_gitlab.md (94%) create mode 100644 gitlab/notions_git/index.rst rename gitlab/{ => notions_git}/objets_gitlab.md (95%) diff --git a/gitlab/index.rst b/gitlab/index.rst index 1312f76..b95f120 100644 --- a/gitlab/index.rst +++ b/gitlab/index.rst @@ -4,9 +4,7 @@ GitLab .. toctree:: :maxdepth: 2 - objets_gitlab - compte_gitlab - depot_gitlab + notions_git architecture_projets correctifs_evolutions applications_vitis diff --git a/gitlab/compte_gitlab.md b/gitlab/notions_git/compte_gitlab.md similarity index 90% rename from gitlab/compte_gitlab.md rename to gitlab/notions_git/compte_gitlab.md index 7321c52..6d60475 100644 --- a/gitlab/compte_gitlab.md +++ b/gitlab/notions_git/compte_gitlab.md @@ -8,23 +8,23 @@ Chaque compte est unique et authendifié par l'identifiant du compte corresponda Je vais ci-après vous détailler les sections les plus importantes, pour éditer ces paramètres, il suffit de cliquer sur son profil (bouton en haut à droite) puis aller sur **Settings** - + ## 1. Profile Dans la partie profile nous pouvons éditer notre adresse mail, notre photo etc... - + GitLab n'est pas entièrement traduit en Français et parfois on peut se perdre avec les termes techniques, mon conseil si vous arrivez à lire l'anglais technique est de passer l'interface en anglais. - + ## 2. Notifications GitLab va vous envoyer des notifications par email en fonction de votre implication dans les différents projets, vous pouvez paramétrer le niveau de notifications que nous allez recevoir directement dans cette section. - + ## 3. SSH keys @@ -40,13 +40,13 @@ Pour cela il faut cliquer sur le bouton en situé à droite de votre profil, pui Une fois ceci fait deux fichiers auront étés générés id_rsa qui correspond à la clé privée **que vous ne devez communiquer sous aucun prétexte** et id_rsa.pub qui est la clé publique que vous fournirez aux différents services. - + ### 3.2. Enregistrer la clé Une fois que vous avez généré votre paire de clés, copiez le contenu de la clé publique (id_rsa.pub) et collez-le dans le champ Key, enfin donnez un nom à votre clé (exemple : Ordinateur Armand) puis ajoutez-la. - + Vous pouvez maintenant utiliser GitKraken sans taper votre mot de passe à nouveau. @@ -54,8 +54,8 @@ Vous pouvez maintenant utiliser GitKraken sans taper votre mot de passe à nouve Ici vous pourrez modifier la couleur de votre interface et surtout décider de quelle page s'affiche quand vous arrivez sur GitLab. - + J'ai moi même décidé d'afficher **Your Groups** en page d'accueil de manière à arriver sur la liste des groupes dans lesquels je suis impliqué. - + diff --git a/gitlab/depot_gitlab.md b/gitlab/notions_git/depot_gitlab.md similarity index 94% rename from gitlab/depot_gitlab.md rename to gitlab/notions_git/depot_gitlab.md index 65213f9..4b9b6db 100644 --- a/gitlab/depot_gitlab.md +++ b/gitlab/notions_git/depot_gitlab.md @@ -2,7 +2,7 @@ Les dépôts agissent comme des conteneurs de fichiers et permettent le versionnement, chaque dépôt est représenté par un lien unique proposé en HTTPS et SSH qui permettra d'effectuer un clone local du projet. - + ## 1. Créer un dépôt @@ -12,17 +12,17 @@ La deuxième chose importante quand on crée un dépôt c'est sa visibilité en Chaque dépôt doit contenir un fichier README.md contenant une description du projet car ce sera la page d'accueil des visiteurs. - + ## 2. Paramétrer le dépôt Une fois le dépôt crée on accède à la page suivante, on peut déjà le cloner pour alimenter ses fichiers mais nous allons tout d'abord le paramétrer. Pour cela il suffit de se rendre dans la section **Settings** - + Cette section est divisée en plusieurs parties que nous détaillerons pour la plupart ci-après. - + ### 2.1. General #### 2.1.1 General project @@ -57,7 +57,7 @@ Cette partie permettra de mettre en place des Web-hooks pour lier le projet à u Dans cette section il est important de ce pencher sur la partie **Protected branches**, c'est ici que nous déciderons des branches à protéger. - + Il est **fortement conseillé** de protéger les branches **master** et **next_version** de telle sorte que les développeurs ne puissent pas commiter directement dessus, pour apporter leurs modifications les développeurs devront créer des branches puis des merge requests pour que la personne en charge du projet valide les modifications. diff --git a/gitlab/notions_git/index.rst b/gitlab/notions_git/index.rst new file mode 100644 index 0000000..b64514e --- /dev/null +++ b/gitlab/notions_git/index.rst @@ -0,0 +1,9 @@ +Notions GitLab +==================================== + +.. toctree:: + :maxdepth: 2 + + objets_gitlab + compte_gitlab + depot_gitlab diff --git a/gitlab/objets_gitlab.md b/gitlab/notions_git/objets_gitlab.md similarity index 95% rename from gitlab/objets_gitlab.md rename to gitlab/notions_git/objets_gitlab.md index cdce49e..ddbdb33 100644 --- a/gitlab/objets_gitlab.md +++ b/gitlab/notions_git/objets_gitlab.md @@ -9,7 +9,7 @@ Sur GitLab les projets peuvent êtres répartis par groupes, ces derniers vont a On peut accéder à la liste des groupes en cliquant sur le bouton **Groups** présent dans la barre suppérieure. On y distingue **Your groups** pour retourner les groupes sur lesquels l'utilisateur contribue et **Explore groups** pour visualiser les groupes de l'utilisateur plus les groupes publics. - + ### 1.2. Droits @@ -19,14 +19,14 @@ Une fois dans le dépôt on distinguera les droits donnés au travers du groupe Vous trouverez plus de détails sur les différents droits dans la section correspondante de ce document. - + ## 2. Dépôts Les dépôts agissent comme des conteneurs de fichiers et permettent le versionnement, chaque dépôt est représenté par un lien unique proposé en HTTPS et SSH qui permettra d'effectuer un clone local du projet. - + ### 2.1. Branches @@ -50,13 +50,13 @@ Quand le responsable de projet décide d'effectuer une tache il pourra lier l'is Les labels agiront comme des tags pour classifier les issues (bug, évolution etc..) on peut définir les labels à utiliser dans le dépôt ainsi que dans les groupes. - + ### 2.5. Milestones Un milestone est un ensemble d'issues à effectuer pour une version/projet, il permet entre autres de suivre l'avancement du projet. - + ## 3. Droits -- GitLab