Persister la BD

Au cas où vous ne l'auriez pas remarqué, votre liste de tâches est vide à chaque fois que vous lancez le conteneur. Pourquoi cela ? Dans cette partie, vous plongerez dans le fonctionnement du conteneur.

Le système de fichiers du conteneur

Quand un conteneur s'exécute, il utilise les diverses couches d'une image pour son système de fichiers. Chaque conteneur obtient aussi son propre "espace de travail" pour créer/mettre à jour/supprimer des fichiers. Tous les changements ne seront pas vus dans un autre conteneur, même s'ils utilisent la même image.

Voir cela en pratique

Pour voir cela en action, vous allez démarrer deux conteneurs. Dans un conteneur, vous créerez un fichier. Dans l'autre conteneur, vous vérifierez si ce même fichier existe.

1. Démarrez un conteneur Alpine et créez un nouveau fichier dedans.

   $ docker run --rm alpine touch greeting.txt
   

   Tip

   Toutes les commandes que vous spécifiez après le nom de l'image (dans ce cas, alpine) sont exécutées à l'intérieur du conteneur. Dans ce cas, la commande touch greeting.txt place un fichier nommé greeting.txt sur le système de fichiers du conteneur.

2. Exécutez un nouveau conteneur Alpine et utilisez la commande stat pour vérifier si le fichier existe.

   $ docker run --rm alpine stat greeting.txt
   

   Vous devriez voir une sortie similaire à la suivante qui indique que le fichier n'existe pas dans le nouveau conteneur.

   stat: can't stat 'greeting.txt': No such file or directory
   

Le fichier greeting.txt créé par le premier conteneur n'existait pas dans le second conteneur. C'est parce que la "couche supérieure" inscriptible de chaque conteneur est isolée. Même si les deux conteneurs partageaient les mêmes couches sous-jacentes qui composent l'image de base, la couche inscriptible est unique à chaque conteneur.

Volumes de conteneur

Avec l'expérience précédente, vous avez vu que chaque conteneur démarre à partir de la définition d'image à chaque fois qu'il démarre. Bien que les conteneurs puissent créer, mettre à jour et supprimer des fichiers, ces changements sont perdus quand vous supprimez le conteneur et Docker isole tous les changements à ce conteneur. Avec les volumes, vous pouvez changer tout cela.

Les Volumes fournissent la capacité de connecter des chemins spécifiques du système de fichiers du conteneur de retour à la machine hôte. Si vous montez un répertoire dans le conteneur, les changements dans ce répertoire sont aussi vus sur la machine hôte. Si vous montez ce même répertoire à travers les redémarrages de conteneur, vous verriez les mêmes fichiers.

Il y a deux types principaux de volumes. Vous utiliserez finalement les deux, mais vous commencerez avec les montages de volume.

Persister les données de tâches

Par défaut, l'application de tâches stocke ses données dans une base de données SQLite à /etc/todos/todo.db dans le système de fichiers du conteneur. Si vous n'êtes pas familier avec SQLite, ne vous inquiétez pas ! C'est simplement une base de données relationnelle qui stocke toutes les données dans un seul fichier. Bien que ce ne soit pas le meilleur pour les applications à grande échelle, cela fonctionne pour les petites démos. Vous apprendrez comment basculer vers un moteur de base de données différent plus tard.

Avec la base de données étant un seul fichier, si vous pouvez persister ce fichier sur l'hôte et le rendre disponible au conteneur suivant, il devrait pouvoir reprendre là où le dernier s'est arrêté. En créant un volume et en l'attachant (souvent appelé "montage") au répertoire où vous avez stocké les données, vous pouvez persister les données. Comme votre conteneur écrit dans le fichier todo.db, il persistera les données vers l'hôte dans le volume.

Comme mentionné, vous allez utiliser un montage de volume. Pensez à un montage de volume comme un seau opaque de données. Docker gère complètement le volume, y compris l'emplacement de stockage sur le disque. Vous devez seulement vous rappeler le nom du volume.

Créer un volume et démarrer le conteneur

Vous pouvez créer le volume et démarrer le conteneur en utilisant la CLI ou l'interface graphique de Docker Desktop.

Vérifier que les données persistent

1. Une fois que le conteneur démarre, ouvrez l'application et ajoutez quelques éléments à votre liste de tâches.

   

2. Arrêtez et supprimez le conteneur pour l'application de tâches. Utilisez Docker Desktop ou docker ps pour obtenir l'ID puis docker rm -f <id> pour le supprimer.

3. Démarrez un nouveau conteneur en utilisant les étapes précédentes.

4. Ouvrez l'application. Vous devriez voir vos éléments encore dans votre liste.

5. Allez-y et supprimez le conteneur quand vous avez fini de vérifier votre liste.

Vous avez maintenant appris comment persister les données.

Plonger dans le volume

Beaucoup de personnes demandent fréquemment "Où Docker stocke-t-il mes données quand j'utilise un volume ?" Si vous voulez savoir, vous pouvez utiliser la commande docker volume inspect.

$ docker volume inspect todo-db

Vous devriez voir une sortie comme la suivante :

[
    {
        "CreatedAt": "2019-09-26T02:18:36Z",
        "Driver": "local",
        "Labels": {},
        "Mountpoint": "/var/lib/docker/volumes/todo-db/_data",
        "Name": "todo-db",
        "Options": {},
        "Scope": "local"
    }
]

Le Mountpoint est l'emplacement réel des données sur le disque. Notez que sur la plupart des machines, vous devrez avoir un accès root pour accéder à ce répertoire depuis l'hôte.

Résumé

Dans cette section, vous avez appris comment persister les données de conteneur.

Informations connexes :

• Référence CLI docker
• Volumes

Étapes suivantes

Ensuite, vous apprendrez comment vous pouvez développer votre application plus efficacement en utilisant les montages de liaison.