Aller au contenu principal

Déployer MariaDB en 5 minutes

Ce guide vous accompagne dans la création de votre premier cluster MariaDB depuis la console Hikube, jusqu'à la première connexion avec le client mysql (ou mariadb).

Objectifs​

À la fin de ce guide, vous aurez :

  • Un cluster MariaDB déployé dans votre projet Hikube
  • Un utilisateur disposant des droits sur une base applicative
  • Une connexion fonctionnelle avec un client MySQL

Prérequis​

  • Un compte Hikube et un projet disposant de quotas suffisants (CPU, mémoire, stockage)
  • Le client mysql ou mariadb installé sur votre poste, si vous souhaitez tester une connexion depuis Internet

Étape 1 : Créer le cluster​

  1. Connectez-vous à la console Hikube et sélectionnez votre projet.
  2. Dans le menu latéral, ouvrez DB & Messaging → MariaDB. La page Clusters MariaDB s'affiche.
  3. Cliquez sur Créer un cluster. L'assistant Créer un cluster MariaDB s'ouvre.

Étape 2 : Configurer et valider​

L'assistant comporte cinq étapes : Général, Configuration, Utilisateurs, Vérification et Résumé.

Général​

Saisissez le Nom du cluster, par exemple demo-mariadb (3 à 16 caractères : minuscules, chiffres et tirets ; commence par une lettre, se termine par une lettre ou un chiffre).

Configuration​

ChampValeur conseillée pour ce guideRemarque
Version MariaDB11.8Versions proposées : 10.6, 10.11, 11.4, 11.8
Préconfiguration (Preset)Small (1 CPU, 512Mi)Non modifiable après création
Taille du disque (Go)10Capacité de stockage par nœud
Nombre de réplicas1 (Standalone)3 ou 5 pour la haute disponibilité ; non modifiable après création
Accès externeActivéNécessaire pour vous connecter depuis votre poste

Le bandeau en haut de l'assistant affiche le Coût estimé et l'impact sur les quotas du projet.

remarque

N'activez l'Accès externe que si vous en avez besoin : il expose la base de données sur l'Internet public.

Utilisateurs​

Ajoutez au moins un utilisateur :

  1. Nom de l'utilisateur : par exemple app-user (minuscules, chiffres et tirets).
  2. Rôle : Administrateur ou Lecture seule.
  3. Cliquez sur Ajouter.

Vérification​

Relisez le récapitulatif (Version, Preset, Volume de données, Réplicas, Exposition externe, Coût estimé, Utilisateurs à créer), puis cliquez sur Déployer.

Étape 3 : Vérifier l'état​

L'étape Résumé confirme la création (« Création terminée ! »). Cliquez sur Terminer pour ouvrir la page du cluster.

StatutSignification
En créationLe cluster est en cours de provisionnement
Prêt / ActifLe cluster est opérationnel
Erreur / ÉchecLe provisionnement a échoué

Résultat attendu : après quelques minutes, le statut passe à Prêt. La page affiche la Version MariaDB, les Réplicas, la Taille allouée et la Préconfiguration.

Étape 4 : Récupérer les identifiants et donner accès à une base​

Identifiants​

L'étape Résumé de l'assistant affiche, dans Identifiants des utilisateurs, le Mot de passe de chaque utilisateur et la Chaîne de connexion interne (<hôte>:3306) lorsque l'accès externe est activé.

attention

Copiez ces mots de passe immédiatement : ils ne seront plus affichés. En cas de perte, générez-en un nouveau depuis la section Utilisateurs (Actions → Changer le mot de passe).

L'adresse reste consultable dans la carte Connexion et réseau de la page du cluster, champ Hôte (Host).

Accès à une base applicative​

Le rôle choisi dans l'assistant s'applique à la base système mysql. Pour créer une base applicative et y donner accès :

  1. Dans la section Utilisateurs, ouvrez le menu Actions de app-user et choisissez Gérer les accès.
  2. Sous Accès spécifiques (Bases de données), cliquez sur Ajouter.
  3. Saisissez le Nom de la base, par exemple myapp (minuscules, chiffres et tirets), et choisissez les Droits Administrateur (Admin).
  4. Cliquez sur Enregistrer. La base myapp est créée si elle n'existe pas.

Étape 5 : Connexion et tests​

mysql -h <hôte> -P 3306 -u app-user -p myapp

Saisissez le mot de passe, puis vérifiez la connexion :

SELECT VERSION();
CREATE TABLE test (id INT AUTO_INCREMENT PRIMARY KEY, message VARCHAR(100));
INSERT INTO test (message) VALUES ('Bonjour Hikube');
SELECT * FROM test;

Résultat attendu :

+----+----------------+
| id | message        |
+----+----------------+
|  1 | Bonjour Hikube |
+----+----------------+
astuce

Le client mariadb accepte les mêmes options : mariadb -h <hôte> -P 3306 -u app-user -p myapp.

Étape 6 : Dépannage rapide​

Le champ Hôte (Host) affiche « Non défini »​

L'Accès externe est désactivé, ou l'adresse IP publique n'est pas encore attribuée. Activez-le via Modifier si besoin, puis patientez quelques instants.

Access denied for user​

Mot de passe erroné, ou utilisateur sans accès sur la base indiquée. Vérifiez la colonne Bases de données de la liste des utilisateurs et ajoutez l'accès via Gérer les accès.

Le bouton Suivant reste inactif​

  • À l'étape Configuration : le cluster dépasse les quotas du projet.
  • À l'étape Utilisateurs : ajoutez au moins un utilisateur.

Le cluster reste en Erreur​

Contactez le support en indiquant le nom du projet et du cluster.

Étape 7 : Nettoyage​

  1. Ouvrez la page du cluster (DB & Messaging → MariaDB → nom du cluster).
  2. Cliquez sur Supprimer le cluster.
  3. Saisissez le nom exact du cluster dans le champ Nom de la ressource à confirmer, puis cliquez sur Supprimer définitivement.
attention

Cette action supprime le cluster MariaDB et toutes les données associées. Elle est irréversible.

Résumé​

Vous avez créé depuis la console :

  • Un cluster MariaDB dans votre projet
  • Un utilisateur et une base applicative
  • Un accès externe et une connexion avec le client mysql