Mixed updates

.gitlab-ci.yml

@@ -3,6 +3,8 @@ pages:
     - pages, docker
   image: boileaum/debian-jupyter
   script:
+    - pip3 --no-cache-dir install bash_kernel
+    - python -m bash_kernel.install
     - mkdir public
     - ./make_slides.sh
   artifacts:

README.md

 # TP GitLab CI
 
-## Execution du notebook jupyter
+Le contenu de cette session pratique est publié sur cette [page](https://boileau.pages.math.unistra.fr/tp-gitlab-ci/).
+
+### Execution du notebook jupyter
 
 - [Installer Anaconda](https://www.anaconda.com/download) pour disposer de `jupyter-notebook`
 - Ajouter le support du noyau bash :

tp-gitlab-ci.ipynb

@@ -735,16 +735,199 @@
    "source": [
     "### Provoquez des erreurs\n",
     "\n",
-    "Modifier les fichiers\n",
+    "Modifier les fichiers pour provoquer des erreurs.\n",
+    "Notez que le test n'est pas exécuté si le build échoue."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
+   "source": [
+    "## Exo3 : Docker pour gérer les dépendances\n",
     "\n",
+    "À `helloworld`, on ajoute un programme en python `rosenbrock.py` qui calcule la [fonction de Rosenbrock](https://fr.wikipedia.org/wiki/Fonction_de_Rosenbrock). Ce programme nécessite [`pythran`](http://pythran.readthedocs.io/), un traducteur de python vers C++ qui permet d'accélérer le code python.\n",
+    "Cet exercice a pour but d'illustrer la gestion des dépendances de compilation avec les conteneurs Docker dans une chaîne GitLab CI.\n",
     "\n",
-    "- de build : notez que le test n'est pas exécuté\n",
-    "- de test : le\n"
+    "Pour le reproduire, il est nécessaire de :\n",
+    "1. créer un compte sur [DockerHub](https://hub.docker.com/)\n",
+    "2. y créer un dépôt vierge intitulé `rosen`\n",
+    "3. que Docker soit installé sur la machine qui héberge le runner (c'est le cas pour le runner partagé de ce TP)."
    ]
   },
   {
    "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "Dans votre clone local, basculez sur `exo3`"
+   ]
+  },
+  {
+   "cell_type": "code",
+   "execution_count": 68,
    "metadata": {},
+   "outputs": [
+    {
+     "name": "stdout",
+     "output_type": "stream",
+     "text": [
+      "No local changes to save\n",
+      "Already on 'exo3'\n",
+      "Your branch is up-to-date with 'origin/exo3'.\n"
+     ]
+    }
+   ],
+   "source": [
+    "cd $TPDIR\n",
+    "git stash  # si vous avez des modifications non enregistrées dans exo2\n",
+    "git checkout exo3"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Entête et étape préliminaire du fichier `.gitlab-ci.yml`\n",
+    "\n",
+    "```yaml\n",
+    "stages:\n",
+    "  - build\n",
+    "  - test\n",
+    "  - release\n",
+    "\n",
+    "variables:\n",
+    "  CONTAINER_TEST_IMAGE: boileaum/rosen:$CI_COMMIT_REF_NAME\n",
+    "  CONTAINER_RELEASE_IMAGE: boileaum/rosen:latest\n",
+    "\n",
+    "before_script:\n",
+    "  - echo $DOCKERHUB_PASSWD | docker login -u boileaum --password-stdin\n",
+    "[...]\n",
+    "```\n",
+    "\n",
+    "Pour faire marcher l'exercice :\n",
+    "1. Remplacez `boileaum` par votre `username` sur DockerHub.\n",
+    "2. Sur GitLab dans `Settings > CI / CD > Secret variables`, créez une variable `DOCKERHUB_PASSWD` qui contient le mot de passe de votre compte DockerHub."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Etape de `build` :\n",
+    "\n",
+    "```yaml\n",
+    "[...]\n",
+    "b:docker:\n",
+    "  stage: build\n",
+    "  tags:\n",
+    "    - shell, docker\n",
+    "  script:\n",
+    "    - docker build --pull -t $CONTAINER_TEST_IMAGE -f ./docker/Dockerfile-rosen .\n",
+    "    - docker push $CONTAINER_TEST_IMAGE\n",
+    "[...]\n",
+    "```\n",
+    "\n",
+    "- on construit l'image de test à partir du fichier `./docker/Dockerfile-rosen`\n",
+    "- on pousse cette image sur DockerHub\n",
+    "\n",
+    "> **Note :** l'image `Dockerfile-rosen` est basée sur l'image construite avec `./docker/Dockerfile-pythran` et qui contient les dépendances."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Etapes de `test`\n",
+    "\n",
+    "```yaml\n",
+    "[...]\n",
+    "t:helloworld:\n",
+    "  stage: test\n",
+    "  tags:\n",
+    "    - shell, docker\n",
+    "  script:\n",
+    "    - docker pull $CONTAINER_TEST_IMAGE\n",
+    "    - docker run $CONTAINER_TEST_IMAGE /bin/bash -c 'python test_helloworld.py'\n",
+    "[...]\n",
+    "```\n",
+    "\n",
+    "- on tire l'image de test\n",
+    "- on lance les tests unitaires"
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Etape de livraison\n",
+    "\n",
+    "```yaml\n",
+    "\n",
+    "[...]\n",
+    "r:docker:\n",
+    "  stage: release\n",
+    "  tags:\n",
+    "    - shell, docker\n",
+    "  script:\n",
+    "    - docker pull $CONTAINER_TEST_IMAGE\n",
+    "    - docker tag $CONTAINER_TEST_IMAGE $CONTAINER_RELEASE_IMAGE\n",
+    "    - docker push $CONTAINER_RELEASE_IMAGE\n",
+    "  only:\n",
+    "    - exo3\n",
+    "[...]\n",
+    "```\n",
+    "\n",
+    "On ne fait que tirer l'image de test validée, la renommer, la pousser vers DockerHub."
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "subslide"
+    }
+   },
+   "source": [
+    "### Pipeline complet\n",
+    "\n",
+    "\n",
+    "![](pipeline.png)\n",
+    "\n",
+    "Comme le montre ce schéma, l'exécution de différents jobs d'une même étape peut être réalisée en parallèle par différents runners.\n",
+    "\n",
+    "Plus d'information "
+   ]
+  },
+  {
+   "cell_type": "markdown",
+   "metadata": {
+    "slideshow": {
+     "slide_type": "slide"
+    }
+   },
    "source": [
     "## Récupérer un artifact"
    ]