Update notebook

e2c4b96e · Matthieu Boileau · 2315ea2b · e2c4b96e
Commit e2c4b96e authored 7 years ago by Matthieu Boileau
--- a/tp-gitlab-ci.ipynb
+++ b/tp-gitlab-ci.ipynb
@@ -179,7 +179,7 @@
   "source": [
    "## Enregistrer  un nouveau runner\n",
    "\n",
-    "> Si `gitlab-runner` n'est pas installé sur votre machine, rdv à la section **Utiliser un runner partagé**\n",
+    "> Si `gitlab-runner` n'est pas installé sur votre machine, rdv à la section **Exo1**\n",
    "\n",
    "Engistrer un runner consiste à créer un nouveau runner associé à un projet.\n",
    "Si vous n'êtes pas administrateur du GitLab, il s'agit forcément d'un runner spécifique. Celui-ci se trouve dans \n",
@@ -337,6 +337,27 @@
    }
   },
   "source": [
+    "### Si vous souhaitez utiliser un runner partagé\n",
+    "\n",
+    "Dans la rubrique :\n",
+    "\n",
+    "```\n",
+    "Settings > CI / CD > Runners settings\n",
+    "```\n",
+    "\n",
+    "Notez la présence de plusieurs runners partagés dont `clu1-tp-gitlab-ci` qui porte les tags `shell` et `docker` mais pas `specific`. Pour cibler ce runner, retirer le tag `specific` du fichier `.gitlab-ci.yml`"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Déclenchez une action d'intégration continue\n",
+    "\n",
    "Modifiez la ligne de script, par exemple:"
   ]
  },
@@ -399,7 +420,7 @@
   "cell_type": "markdown",
   "metadata": {
    "slideshow": {
-     "slide_type": "subslide"
+     "slide_type": "-"
    }
   },
   "source": [
@@ -411,9 +432,13 @@
  },
  {
   "cell_type": "markdown",
-   "metadata": {},
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
   "source": [
-    "### Provoquer une erreur\n",
+    "### Provoquez une erreur\n",
    "\n",
    "Dans `.gitlab-ci.yml`, introduisez une erreur dans une des lignes du script et observer l'effet dans `CI / CD > Pipelines` après avoir pousser les modifications.\n",
    "\n",

 %% Cell type:markdown id: tags:
 ### Journée X/Stra-Dev Intégration continue
 21 novembre 2017
 ---
 # L'intégration continue avec GitLab
 ![image.png](tanuki.png)
 ## *Session pratique*
 ---
 Matthieu Boileau - <matthieu.boileau@math.unistra.fr>
 *Contenu sous licence [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0)*
 %% Cell type:markdown id: tags:
 # GitLab CI
 GitLab CI propose une chaîne complète d'intégration continue intégrée à son système de forge logicielle.
 ![](cicd_pipeline_infograph.png)
 <span style="font-size:0.7em;"><https://docs.gitlab.com/ee/ci/README.html></span>
 **Les avantages :**
 - la simplicité de mise en oeuvre
 - la robustesse d'une solution intégrée
 %% Cell type:markdown id: tags:
 ## Le gitlab runner
 ### Introduction
 - `gitlab-runner` est un démon installé sur une machine destinée à exécuter les tâches d'intégration continue.
 - Pour chaque *runner* enregistré, `gitlab-runner` écoute l'instance de gitlab correspondante dans l'attente d'une tâche
 - Cette tâche est déclenchée par des évènements (`push`, `merge`, etc.) sur le projet avec lequel il est lié
 - Ce lien est créé à l'enregistrement du *runner* par un token associé au projet.
 [**Doc en ligne**](https://docs.gitlab.com/ce/ci/runners/#shared-vs-specific-runners)
 %% Cell type:markdown id: tags:
 ### Runners : *shared* vs *specific*
 - *shared* : n'importe quel projet peut s'en servir. Seul l'administrateur du GitLab peut enregistrer des runners partagés.
 - *specific* : seul le créateur du runner peut s'en servir dans d'autres projets
 > **Attention** : les runners partagés sont pratiques mais peuvent présenter des [problèmes de sécurité](https://docs.gitlab.com/ee/ci/runners/README.html#be-careful-with-sensitive-information).
 ### Runners : *locked* vs *unlocked runners*
 - *locked* : le runner ne peut être utilisé que pour le projet avec lequel il est lié
 - *unlocked* : le créateur du runner peut l'utiliser dans ses autres projets
 %% Cell type:markdown id: tags:
 ### Installer `gitlab-runner`
 La **[procédure](https://docs.gitlab.com/runner/install/)** dépend du système d'exploitation.
 %% Cell type:markdown id: tags:
 ## Fork du TP
 Faire un *fork* du projet sur votre compte GitLab en allant sur la page d'accueil du projet
 ![fork.png](fork.png)
 ou en suivant [ce lien](https://git.unistra.fr/m.boileau/tp-gitlab-ci/forks/new).
 %% Cell type:markdown id: tags:
 ## Clone du TP
 %% Cell type:markdown id: tags:
 - Pour paramétrer les commandes de ce notebook, positionner les variables d'environnement suivantes :
 %% Cell type:code id: tags:
 ``` bash
 export USERNAME="m.boileau"  # votre login sur git.unistra.fr
 export TPDIR=$HOME         # le répertoire où vous souhaitez installer le TP
 ```
 %% Cell type:markdown id: tags:
 - Cloner localement votre projet
 %% Cell type:code id: tags:
 ``` bash
 cd $TPDIR
 git clone git@git.unistra.fr:$USERNAME/tp-gitlab-ci.git
 ```
 %% Cell type:markdown id: tags:
 ## Enregistrer  un nouveau runner
-> Si `gitlab-runner` n'est pas installé sur votre machine, rdv à la section **Utiliser un runner partagé**
+> Si `gitlab-runner` n'est pas installé sur votre machine, rdv à la section **Exo1**
 Engistrer un runner consiste à créer un nouveau runner associé à un projet.
 Si vous n'êtes pas administrateur du GitLab, il s'agit forcément d'un runner spécifique. Celui-ci se trouve dans
 votre projet, rubrique :
 ```
 Settings > CI / CD > Runners settings
 ```
 %% Cell type:markdown id: tags:
 Dans le terminal, maintenant :
 %% Cell type:code id: tags:
 ``` bash
 export CI_SERVER_URL=https://git.unistra.fr/  # Do not change for this session
 export RUNNER_NAME=a_runner_for_$USERNAME
 export REGISTRATION_TOKEN=xxx  # Replace by the value provided by the runner setting page
 export REGISTER_NON_INTERACTIVE=true
 #gitlab-runner register --executor shell        # sous MacOS
 #sudo gitlab-runner register --executor shell   # sous Linux
 ```
 %% Cell type:markdown id: tags:
 Ou bien lancez la commande en mode interactif et en suivant pas à pas la [procédure](http://docs.gitlab.com/runner/register/#registering-runners):
 ```
 gitlab-runner register       # sous MacOS
 sudo gitlab-runner register  # sous Linux
 ```
 %% Cell type:markdown id: tags:
 - Retournez sur la page de paramètrage des runners
 - Repérez votre nouveau runner
 - Editez-le et ajouter les tags `specific, shell`
 Votre runner est maintenant prêt à travailler. Nous allons le tester en lui soumettant une tâche GitLab CI déclenchée par un `git push` sur votre projet.
 %% Cell type:markdown id: tags:
 ## Exo1 : helloworld en bash
 ### Mettre en place une action d'intégration continue
 Aller dans le répertoire racine du clone local de votre projet et basculer sur la branche `exo1`
 %% Cell type:code id: tags:
 ``` bash
 cd $TPDIR
 cd tp-gitlab-ci
 ```
 %% Cell type:code id: tags:
 ``` bash
 git pull
 git checkout exo1
 ```
 %% Cell type:markdown id: tags:
 Repérer le fichier `.gitlab-ci.yml`
 %% Cell type:code id: tags:
 ``` bash
 ls -al
 ```
 %% Cell type:markdown id: tags:
 L'éditer avec l'éditeur de votre choix
 %% Cell type:code id: tags:
 ``` bash
 cat .gitlab-ci.yml
 ```
 %% Cell type:markdown id: tags:
 - `helloworld` indique le nom du job d'intégration continue
 - `tags` permet de sélectionner des runners sur la base de mot-clés
 - `scripts` correspond aux lignes de commande `bash` que vous souhaitez exécuter
 %% Cell type:markdown id: tags:
+### Si vous souhaitez utiliser un runner partagé
+Dans la rubrique :
+```
+Settings > CI / CD > Runners settings
+```
+Notez la présence de plusieurs runners partagés dont `clu1-tp-gitlab-ci` qui porte les tags `shell` et `docker` mais pas `specific`. Pour cibler ce runner, retirer le tag `specific` du fichier `.gitlab-ci.yml`
+%% Cell type:markdown id: tags:
+### Déclenchez une action d'intégration continue
 Modifiez la ligne de script, par exemple:
 %% Cell type:code id: tags:
 ``` bash
 echo '    - echo "bonjour, monde"' >> .gitlab-ci.yml
 cat .gitlab-ci.yml
 ```
 %% Cell type:markdown id: tags:
 Enregistrez avec git
 %% Cell type:code id: tags:
 ``` bash
 git add .gitlab-ci.yml
 git commit -m "Update .gitlab-ci.yml"
 ```
 %% Cell type:markdown id: tags:
 Pousser vos modifications
 %% Cell type:code id: tags:
 ``` bash
 git push
 ```
 %% Cell type:markdown id: tags:
 Sur GitLab, observez l'exécution de votre job dans la rubrique de votre projet :
 ```
 CI / CD > Pipelines
 ```
 %% Cell type:markdown id: tags:
-### Provoquer une erreur
+### Provoquez une erreur
 Dans `.gitlab-ci.yml`, introduisez une erreur dans une des lignes du script et observer l'effet dans `CI / CD > Pipelines` après avoir pousser les modifications.
 > **Note :** les fichiers peuvent s'éditer directement dans GitLab.