Usine logicielle

1. Application à compiler

Dans ce qui suit, l’application Flask du chapitre précédent sera intégrée dans un repository GitLab.

Le seul ajout viendra du fichier .gitlab-ci.yml qui définira le lancement de la compilation des éléments du dépôt Git.

2. Mécanisme de pipeline GitLab

Le fichier .gitlab-ci.yml est un fichier au format YAML qui se trouve à la racine du dépôt. Il contient des instructions à utiliser pour construire les éléments du dépôt Git.

À chaque changement, le pipeline de déploiement est déclenché et s’appuie sur un gestionnaire de tâches (Runner).

Comme le fichier .gitlab-ci.yml est stocké avec le code, il devient possible de compiler de vieilles versions du logiciel ou de maintenir des versions différentes en fonction des branches Git.

3. Adresse et contenu du dépôt

Le dépôt GitLab d’exemple est disponible à l’adresse suivante : https://gitlab.com/yannig.perre/flask-healthcheck

La récupération du contenu de ce dépôt se fait à l’aide de la commande suivante :

$ git clone https://gitlab.com/yannig.perre/flask-healthcheck.git 

À la racine de ce dépôt, vous pourrez trouver les éléments suivants :

4. Structure du fichier .gitlab-ci.yml

Par défaut, un fichier de construction GitLab contient trois phases :

Ces phases seront exécutées dans cet ordre et le rattachement à ces phases se fait à l’aide du mot-clé stage au niveau d’une tâche (job).

Une tâche est une déclaration de YAML pouvant contenir les champs suivants :

Ci-dessous un exemple de déclaration d’une tâche my-task lancée durant la phase build :

my-task: 
   stage:...

1. À propos de Jenkins

Dans ce qui va suivre, le logiciel Jenkins sera mis en place dans Kubernetes.

Des exemples seront mis en œuvre afin de créer un pipeline de construction d’images Docker ainsi qu’un mécanisme de mise à jour automatique.

Tout comme pour GitLab, ce chapitre n’a pas pour vocation de présenter de fond en comble le fonctionnement de Jenkins. Il s’agit plutôt d’un guide pour quelqu’un ayant déjà une première expérience sur le sujet.

Pour plus de détails, n’hésitez pas consulter le site de Jenkins à l’adresse suivante : https://jenkins.io

2. Installation de Jenkins

$ helm repo add jenkins https://charts.jenkins.io 

controller: 
 ingress: 
   enabled: true 
   apiVersion: "networking.k8s.io/v1" 
   annotations:  
     kubernetes.io/tls-acme: "true" 
     cert-manager.io/cluster-issuer:...

1. Prérequis

Pour les exemples qui vont suivre, le dépôt Git https://github.com/Yannig/eni-kubernetes.git sera utilisé. Charge à vous de changer l’adresse pour pointer vers un dépôt Git lui appartenant.

2. Présentation du mécanisme de déploiement continu

Dans Jenkins, un pipeline de déploiement continu est un programme écrit en Groovy qui va piloter le déroulement d’un déploiement. Un déploiement se déroule généralement de la manière suivante :

Le pipeline d’exemple reprendra ces grandes phases.

Schéma de principe du pipeline de déploiement continu

L’application à construire est stockée dans le sous-répertoire flask-healthcheck. Cette application est une application Flask qui dispose d’un fichier Dockerfile.

Cette image sera stockée sur le registre public de Docker sous le nom yannig/flask-healthcheck. 

3. Stockage des identifiants Docker

Afin de pouvoir pousser l’image compilée sur Docker Hub, un secret sera créé dans l’espace de noms de Jenkins.

$ kubectl create secret docker-registry docker-hub-cred \ 
  --docker-server=docker.io \ 
  --namespace=jenkins \       
  --docker-username=yannig \ 
  --docker-password=xxx 

4. Création de l’environnement develop

Afin de mettre à jour en continu une version de l’application, l’espace de noms develop sera créé avec un déploiement de test.

$ kubectl create ns develop 

$ kubectl -n develop create deployment \ 
              --image yannig/flask-healthcheck:latest test 

5. Création du pipeline