HealthCheck

Présentation

Le mécanisme de healthcheck n'est pas une nouveauté dans Docker... Présent depuis la version 1.12 ce mécanisme reste pourtant peu utilisé...

Tout d'abord l'instruction HEALTHCHECK , c'est quoi ?

Elle indique à Docker comment tester votre container pour vérifier qu'il fonctionne toujours correctement ( Oui oui, j'ai réussi à vous traduire la documentation officielle ) :

The HEALTHCHECK instruction tells Docker how to test a container to check that it is still working. This can detect cases such as a web server that is stuck in an infinite loop and unable to handle new connections, even though the server process is still running.

Nous avions déjà pu voir comment relancer automatiquement un container dont le processus principal ( vous savez le programme qui prend le PID 1 dans votre container ) ne fonctionne plus, et ceci à l'aide de l'instruction restart.

Mais voilà, dans votre malheur le PID 1 de votre instance est toujours actif mais pourtant il ne remplit plus son rôle :

Par exemple nginx est toujours UP mais il ne dessert plus vos pages correctement et/ou vous remonte une erreur 404/503 !


Dans ce moment là, plusieurs solutions :

Healthcheck

Il est possible de déclarer un HEALTHCHECK de deux façons :

Plutôt que de long discours, voyons par l'exemple la différence entre ces deux types de déclarations.

 

Dans un dockerfile

Voici un exemple de fichier Dockerfile qui va construire une image custom du CMS Ghost:

FROM ghost:3

RUN apt update && apt install curl -y \
        && rm -rf /var/lib/apt/lists/*
        
HEALTHCHECK --interval=1m --timeout=30s --retries=3 CMD curl --fail http://localhost:2368 || exit 1

🚩 Alors oui il est nécessaire d'installer curl qui n'est pas présent dans l'image. Pour les personnes qui souhaitent pousser la réflexion plus loin, voici un article très intéressant. 🚩

Voici la liste des options qu'il est possible d'ajouter avant CMD :

--interval=DUREE (default: 30s)
--timeout=DUREE (default: 30s)
--start-period=DUREE (default: 0s)
--retries=N (default: 3)

Ghost étant une application web, l'utilisation de curl ou wget comme commande de vérification vient immédiatement à l'esprit.

Ici on vérifie qu'une page web est présente et renvoie un code de retour 200 à l'adresse http://localhost:2368.

On va pouvoir construire notre image :

$ docker build -t ghost:healthcheck .

Et lancer notre container :

$ docker run -d --name some-ghost -p 2368:2368 ghost:healthcheck

On peut vérifier l'état de notre avec la commande docker ps :

$ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS                           PORTS                    NAMES
a3435a4d95fd        ghost:healthcheck   "docker-entrypoint.s…"   3 seconds ago       Up 1 second (health: starting)   0.0.0.0:2368->2368/tcp   some-ghost

L'instruction HEALTHCHECK peut renvoyer 3 codes de retour :

0: success - the container is healthy and ready for use
1: unhealthy - the container is not working correctly
2: reserved - do not use this exit code

Vous allez constaster visuellement de votre côté, 3 états possibles :

On peut constater lors de mon docker ps que notre container est toujours en cours de démarrage : nous avons eu un retour starting.

Vérifions de nouveau quelques secondes plus tard :

$ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED              STATUS                        PORTS                    NAMES
a3435a4d95fd        ghost:healthcheck   "docker-entrypoint.s…"   About a minute ago   Up About a minute (healthy)   0.0.0.0:2368->2368/tcp   some-ghost

Il est donc relativement simple d'ajouter ce mécanisme à votre image !

Toutefois le principal problème lié à cette méthode, est que la vérification est alors générique. Il peut être nécessaire de rendre vos checks plus "personnels", par container.

Il existe d'ailleurs un second inconvénient : votre image n'est peut-être tout simplement pas prévu "seulement" pour Docker. Kubernetes intègre par exemple ses propres mécanismes, et vous souhaiterez probablement les utiliser...

 

Dans un docker-compose

Dans ce cas, vous pouvez réaliser la même vérification dans le fichier docker-compose.

🚩 Pour cet exemple, je vais tout de même construire une image. Sans HEALTHCHECK, mais avec l'installation de curl 🚩 :

FROM ghost:3

RUN apt update && apt install curl -y \
        && rm -rf /var/lib/apt/lists/*

et donc construire cette image :

$ docker build -t ghost:curl .

Les instructions sont similaires à la méthode vu précédemment :

version: '3.8'
services:
    ghost:
        image: ghost:curl
        ports:
            - 2368:2368
        healthcheck:
            test: ["CMD", "curl -f http://localhost:2368 || exit 1"]
            timeout: 30s
            interval: 1m
            retries: 3

Le fonctionnement est identique à celui que nous venons de voir lors d'une utilisation de l'instruction au sein d'un fichier Dockerfile. ( ouf 😂 )

Enfin sachez qu'il est tout simplement possible de désactiver dans votre docker-compose un healthcheck créé dans une image à l'aide de l'instruction suivante :

healthcheck:
  disable: true

 

Source : grottedubarbu.fr