Distribuire MariaDB in 5 minuti
Questa guida la accompagna nella creazione del suo primo cluster MariaDB dalla console Hikube, fino alla prima connessione con il client mysql (o mariadb).
Obiettivi
Al termine di questa guida, avrà:
- Un cluster MariaDB distribuito nel suo progetto Hikube
- Un utente con i diritti su un database applicativo
- Una connessione funzionante con un client MySQL
Prerequisiti
- Un account Hikube e un progetto con quota sufficiente (CPU, memoria, storage)
- Il client
mysqlomariadbinstallato sul suo computer, se desidera testare una connessione da Internet
Passo 1: Creare il cluster
- Acceda alla console Hikube e selezioni il suo progetto.
- Nel menu laterale, apra DB & Messaging → MariaDB. Viene visualizzata la pagina MariaDB Clusters.
- Faccia clic su Create a cluster. Si apre la procedura guidata Create a MariaDB cluster.
Passo 2: Configurare e confermare
La procedura guidata comprende cinque passaggi: General, Configuration, Users, Summary e Finish.
General
Inserisca il Cluster Name, ad esempio demo-mariadb (da 3 a 16 caratteri: lettere minuscole, cifre e trattini; inizia con una lettera, termina con una lettera o una cifra).
Configuration
| Campo | Valore consigliato per questa guida | Nota |
|---|---|---|
| MariaDB Version | 11.8 | Versioni proposte: 10.6, 10.11, 11.4, 11.8 |
| Preset | s1.small — 1 CPU / 2Gi | Nessun preset è preselezionato; non modificabile dopo la creazione |
| Disk size (GB) | 10 | Capacità di storage per nodo |
| Number of replicas | 1 (Standalone) | 3 o 5 per l'alta disponibilità; non modificabile dopo la creazione |
| External access | Attivato | Necessario per connettersi dal suo computer |
Il banner nella parte superiore della procedura guidata mostra l'Estimated cost e l'impatto sulla quota del progetto.
Attivi l'External access solo se ne ha bisogno: espone il database sull'Internet pubblico.
Users
Aggiunga almeno un utente:
- Username: ad esempio
app-user(lettere minuscole, cifre e trattini). - Database: il database applicativo su cui si applica il ruolo dell'utente, ad esempio
myapp(lettere minuscole, cifre e trattini). Viene creato se non esiste. I database di sistemamysql,information_schema,performance_schemaesyssono rifiutati. - Role: Administrator per questa guida, oppure Read-only.
- Faccia clic su Add.
Summary
Rilegga il riepilogo (Version, Preset, Data volume, Replicas, External exposure, Estimated cost, Users to create), quindi faccia clic su Create cluster.
Passo 3: Verificare lo stato
Il passaggio Finish conferma la creazione (« Creation complete! »). Faccia clic su Finish per aprire la pagina del cluster.
| Stato | Significato |
|---|---|
| Creating | Il cluster è in fase di provisioning |
| Ready | Il cluster è operativo |
| Error | La piattaforma non è riuscita ad applicare la creazione o l'ultima modifica del cluster |
Risultato atteso: dopo alcuni minuti, lo stato passa a Ready. La pagina mostra la MariaDB Version, le Replicas, l'Allocated Size e il Preset.
Passo 4: Recuperare le credenziali e concedere l'accesso a un database
Credenziali
Il passaggio Finish della procedura guidata mostra, in User Credentials, la Password di ogni utente e la Internal Connection String (<host>:3306) quando l'accesso esterno è attivato.
Copi subito queste password: non verranno più mostrate. In caso di smarrimento, ne generi una nuova dalla sezione Users (Actions → Change Password).
Il riquadro Connection and network della pagina del cluster mostra i suoi indirizzi in due zone, ciascuna con un pulsante di copia:
- Internal, From the project's resources only: l'host interno, sempre presente, e la porta (
3306). È raggiungibile dalle VM e dai cluster Kubernetes dello stesso progetto, senza accesso esterno; - External, From the Internet: l'indirizzo pubblico, quando l'External Access è attivato.
Accesso al database applicativo
Il database myapp indicato al passaggio Users è stato creato, e l'utente vi dispone del ruolo scelto: nella sezione Users della pagina del cluster, la colonna Databases mostra myapp (Administrator). Per dargli accesso ad altri database, apra il menu Actions dell'utente e scelga Manage Access (consulti Gestire utenti e database).
Passo 5: Connessione e test
Dalla sua postazione, utilizzi l'indirizzo della zona External:
mysql -h <host> -P 3306 -u app-user -p myapp
Da una VM o da un cluster Kubernetes del progetto, utilizzi l'host della zona Internal: mysql -h <host-interno> -P 3306 -u app-user -p myapp.
Inserisca la password, quindi verifichi la connessione:
SELECT VERSION();
CREATE TABLE test (id INT AUTO_INCREMENT PRIMARY KEY, message VARCHAR(100));
INSERT INTO test (message) VALUES ('Bonjour Hikube');
SELECT * FROM test;
Risultato atteso:
+----+----------------+
| id | message |
+----+----------------+
| 1 | Bonjour Hikube |
+----+----------------+
Il client mariadb accetta le stesse opzioni: mariadb -h <host> -P 3306 -u app-user -p myapp.
Passo 6: Risoluzione rapida dei problemi
La zona External mostra « Disabled » o « Waiting for allocation… »
« Disabled »: l'External Access è disattivato. Lo attivi tramite Edit se deve connettersi da Internet; dal progetto, utilizzi l'host della zona Internal. « Waiting for allocation… »: l'indirizzo pubblico non è ancora stato assegnato, attenda qualche istante.
L'host interno non si risolve da una VM
Copi il nome completo della zona Internal, senza abbreviarlo. Su Debian 13, il nome non si risolve senza configurazione: vedere Raggiungere un servizio gestito del progetto.
Access denied for user
Password errata, oppure utente senza accesso al database indicato. Verifichi la colonna Databases dell'elenco degli utenti e aggiunga l'accesso tramite Manage Access.
Il pulsante Next resta inattivo
- Nel passaggio Configuration: il cluster supera la quota del progetto.
- Nel passaggio Users: aggiunga almeno un utente, con il suo Database.
Il cluster passa in stato Error
La piattaforma non è riuscita ad applicare la creazione o l'ultima modifica del cluster. Contatti il supporto indicando il nome del progetto e del cluster.
Passo 7: Pulizia
- Apra la pagina del cluster (DB & Messaging → MariaDB → nome del cluster).
- Faccia clic su Delete cluster.
- Inserisca il nome esatto del cluster nel campo Resource name to confirm, quindi faccia clic su Permanently delete.
Questa azione elimina il cluster MariaDB e tutti i dati associati. È irreversibile.
Riepilogo
Dalla console ha creato:
- Un cluster MariaDB nel suo progetto
- Un utente e un database applicativo
- Un accesso esterno e una connessione con il client
mysql