Installer MariaDB via Docker : voici comment procéder

Docker est idéal pour le dé­ploie­ment rapide de MariaDB. Vous té­lé­char­gez d’abord une image adaptée. Ensuite, vous con­fi­gu­rez et démarrez le conteneur avec les pa­ra­mètres souhaités. Ainsi, vous testez ou dé­ve­lop­pez in­dé­pen­dam­ment du système hôte dans un en­vi­ron­ne­ment contrôlé.

Avantages des en­vi­ron­ne­ments MariaDB Docker

Docker offre une méthode simple pour déployer MariaDB dans des en­vi­ron­ne­ments isolés. Vous pouvez ra­pi­de­ment lancer des instances et tester dif­fé­rentes versions in­dé­pen­dam­ment. Cela vous permet de gagner du temps, d’éviter les conflits avec des ins­tal­la­tions locales et de créer des con­di­tions re­pro­duc­tibles pour le dé­ve­lop­pe­ment et les tests.

Prérequis

Avant de commencer, assurez-vous que les prérequis suivants sont remplis :

• Docker est installé et en cours d’exécution sur votre système
• Accès à une ligne de commande (Terminal, Po­wer­Shell, etc.) avec des droits admin
• Optionnel pour MariaDB : Docker Compose, pour des con­fi­gu­ra­tions plus complexes

Ins­tal­la­tion de MariaDB dans Docker : guide étape par étape

Découvrez ci-dessous comment installer MariaDB en quelques étapes dans Docker. La manière de con­fi­gu­rer Docker en amont est détaillée dans notre tutoriel Docker.

Étape 1 : installer Docker

Si vous n’avez pas encore installé Docker, vous pouvez le con­fi­gu­rer via le script d’ins­tal­la­tion officiel :

curl -sSL https://get.docker.com/ | sh

Sous Windows ou macOS, il est re­com­mandé d’utiliser Docker Desktop. Après une ins­tal­la­tion réussie, vérifiez son bon fonc­tion­ne­ment avec :

docker --version

La sortie devrait afficher un numéro de version, par exemple Docker version 27.5.1, build cb74dfcd. Si c’est le cas, vous avez cor­rec­te­ment configuré Docker.

Étape 2 : té­lé­char­ger l’image MariaDB

Main­te­nant, té­lé­char­gez l’image Docker MariaDB of­fi­cielle depuis Docker Hub. Celle-ci contient une instance de MariaDB en­tiè­re­ment pré­con­fi­gu­rée.

docker pull mariadb:latest

Si vous préférez une version spé­ci­fique, vous pouvez également la spécifier ex­pli­ci­te­ment, par exemple :

docker pull mariadb:10.11

Vous pouvez ensuite vérifier toutes les images stockées lo­ca­le­ment avec la commande suivante :

docker images

La ligne avec mariadb et le tag cor­res­pon­dant devrait ap­pa­raître dans la liste.

Étape 3 : démarrer le conteneur MariaDB dans Docker

Créez main­te­nant le conteneur. Pour cela, utilisez la commande :

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d -p 3306:3306 mariadb:latest

• --name mariadb-container : attribue un nom au conteneur, sous lequel il peut être référencé dans le système.
• -e MYSQL_ROOT_PASSWORD=password : définit le mot de passe root de la base de données MariaDB. Vous en aurez besoin plus tard pour vous connecter.
• -d : démarre le conteneur en arrière-plan (mode détaché), per­met­tant ainsi de libérer votre console.
• -p 3306:3306 : connecte le port par défaut de la base de données du conteneur au même port sur votre système local, afin que vous puissiez y accéder via des clients.

Après avoir exécuté cette commande, Docker devrait démarrer le conteneur. Pour en vérifier l’état, saisissez :

docker ps

Dans la liste des con­te­neurs en cours d’exécution, mariadb-container devrait ap­pa­raître avec le statut Up. Si le conteneur ne fonc­tionne pas comme prévu, vous pouvez consulter les fichiers log avec :

docker logs mariadb-container

Les logs per­met­tent d’iden­ti­fier d’éven­tuelles erreurs de con­fi­gu­ra­tion.

Étape 4 : accéder à MariaDB

Dès que le conteneur MariaDB Docker fonc­tionne, vous pouvez accéder à la base de données avec un client com­pa­tible MySQL comme l’outil MySQL standard ou des outils gra­phiques comme DBeaver, HeidiSQL ou Beekeeper Studio.

Sur la ligne de commande, vous pouvez ainsi utiliser la commande suivante :

mysql -h 127.0.0.1 -P 3306 -u root -p

Vous serez invité à saisir le mot de passe. Entrez celui que vous avez défini avec MYSQL_ROOT_PASSWORD.

Si tout fonc­tionne, vous accéderez à la console MariaDB. Là, vous pouvez exécuter des commandes SQL comme d’habitude :

SHOW DATABASES;

Vous verrez les bases par défaut et pourrez créer vos propres bases ou tables.

Étape 5 : sécuriser les données per­sis­tantes avec des volumes

Par défaut, les données dans le conteneur sont tem­po­raires. Pour sécuriser vos données lors de re­dé­mar­rages ou de chan­ge­ments de conteneur, il est re­com­mandé d’utiliser un volume :

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password -d \
    -v mariadb_data:/var/lib/mysql \
    -p 3306:3306 mariadb:latest

-v mariadb_data:/var/lib/mysql crée un volume Docker nommé mariadb_data et le lie au ré­per­toire où MariaDB stocke ses données.

Vous pouvez afficher les volumes stockés à tout moment avec la commande suivante :

docker volume ls

Avec la commande suivante, vous pouvez ensuite inspecter le contenu d’un volume :

docker volume inspect mariadb_data

Étape 6 : gérer MariaDB avec Docker Compose

Pour des con­fi­gu­ra­tions plus complexes, vous pouvez utiliser Docker Compose. Pour cela, créez un fichier docker-compose.yml avec le contenu suivant :

version: '3.1'
services:
    mariadb:
        image: mariadb:latest
        container_name: mariadb-compose
        environment:
            MYSQL_ROOT_PASSWORD: password
            MYSQL_DATABASE: example_db
        ports:
            - "3306:3306"
        volumes:
            - mariadb_data:/var/lib/mysql
volumes:
    mariadb_data:

Démarrez l’en­vi­ron­ne­ment avec :

docker-compose up -d

MariaDB fonc­tionne désormais en arrière-plan, avec un stockage per­sis­tant et une base de données pré­con­fi­gu­rée.

Étape 7 : arrêter, démarrer et supprimer un conteneur

Avec Docker, la gestion des con­te­neurs est très simple. Vous pouvez arrêter ou re­dé­mar­rer à tout moment le conteneur MariaDB Docker sans perte de données, à condition d’utiliser des volumes. Voici les commandes à utiliser.

Arrêter un conteneur :

docker stop mariadb-container

Démarrer un conteneur :

docker start mariadb-container

Supprimer un conteneur :

docker rm mariadb-container

Supprimer un conteneur avec le volume :

docker rm -v mariadb-container

Étape 8 : re­dé­mar­rage au­to­ma­tique du conteneur

Pour que votre conteneur MariaDB Docker redémarre au­to­ma­ti­que­ment après un re­dé­mar­rage du système hôte, vous pouvez définir la politique de reboot :

docker run --name mariadb-container -e MYSQL_ROOT_PASSWORD=password \
    -v mariadb_data:/var/lib/mysql \
    -p 3306:3306 \
    --restart unless-stopped \
    -d mariadb:latest

--restart unless-stopped garantit que le conteneur démarre au­to­ma­ti­que­ment après un re­dé­mar­rage du système, sauf si vous l’aviez arrêté ma­nuel­le­ment.