Vai al contenuto principale

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 mysql o mariadb installato sul suo computer, se desidera testare una connessione da Internet

Passo 1: Creare il cluster​

  1. Acceda alla console Hikube e selezioni il suo progetto.
  2. Nel menu laterale, apra DB & Messaging → MariaDB. Viene visualizzata la pagina MariaDB Clusters.
  3. 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​

CampoValore consigliato per questa guidaNota
MariaDB Version11.8Versioni proposte: 10.6, 10.11, 11.4, 11.8
Presets1.small — 1 CPU / 2GiNessun preset è preselezionato; non modificabile dopo la creazione
Disk size (GB)10Capacità di storage per nodo
Number of replicas1 (Standalone)3 o 5 per l'alta disponibilità; non modificabile dopo la creazione
External accessAttivatoNecessario per connettersi dal suo computer

Il banner nella parte superiore della procedura guidata mostra l'Estimated cost e l'impatto sulla quota del progetto.

nota

Attivi l'External access solo se ne ha bisogno: espone il database sull'Internet pubblico.

Users​

Aggiunga almeno un utente:

  1. Username: ad esempio app-user (lettere minuscole, cifre e trattini).
  2. 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 sistema mysql, information_schema, performance_schema e sys sono rifiutati.
  3. Role: Administrator per questa guida, oppure Read-only.
  4. 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.

StatoSignificato
CreatingIl cluster è in fase di provisioning
ReadyIl cluster è operativo
ErrorLa 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.

avviso

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 |
+----+----------------+
suggerimento

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​

  1. Apra la pagina del cluster (DB & Messaging → MariaDB → nome del cluster).
  2. Faccia clic su Delete cluster.
  3. Inserisca il nome esatto del cluster nel campo Resource name to confirm, quindi faccia clic su Permanently delete.
avviso

Questa azione elimina il cluster MariaDB e tutti i dati associati. È irreversibile.


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