Concetti — MariaDB
Architettura
MariaDB su Hikube è un servizio gestito. MariaDB è un fork di MySQL compatibile con i suoi client e il suo protocollo. Ogni cluster creato dalla console è un insieme replicato composto da un primary e da eventuali repliche. Appartiene a un progetto e consuma la quota di tale progetto.
Terminologia
| Termine | Descrizione |
|---|---|
| Cluster MariaDB | Istanza gestita creata dalla console, composta da un primary e da eventuali repliche. |
| Progetto | Spazio isolato che raggruppa le sue risorse e a cui è associata la quota. |
| Primary | Nodo principale che accetta letture e scritture. |
| Replica | Nodo in sola lettura, sincronizzato dal primary tramite la replica binlog. |
| Preset | Profilo di risorse (CPU, memoria) assegnato a ogni nodo del cluster. |
| Accesso esterno | Opzione che espone il cluster su Internet tramite un indirizzo IP pubblico. |
| Ruolo | Diritto di un utente su un database: Administrator o Read-only. |
Replica e alta disponibilità
Il cluster utilizza la replica binlog di MariaDB:
- Il primary scrive tutte le modifiche nel binary log
- Le repliche consumano il binlog e applicano le modifiche
- In caso di guasto del primary, la piattaforma promuove automaticamente una replica
Il Number of replicas si sceglie al momento della creazione:
| Valore proposto | Utilizzo |
|---|---|
| 1 (Standalone) | Sviluppo, test |
| 3 (Max High Availability) | Produzione |
| 5 (Ultra High Availability) | Produzione critica |
Il numero di repliche e il preset non possono essere modificati dopo la creazione. Per cambiarli, contatti il supporto.
Il passaggio manuale del primary (switchover) non è proposto nella console; contatti il supporto.
Utenti, database e ruoli
La pagina di un cluster MariaDB comprende una sezione Users; non esiste una scheda dedicata ai database. I diritti si assegnano database per database: ogni accesso associa un Database name a dei Rights, Administrator (Admin) o Read-only. Administrator concede tutti i privilegi sul database (ALL, con diritto di delega), Read-only il diritto SELECT. Concedere un accesso su un database che non esiste ancora lo crea. Non esiste un ruolo globale: un utente ha accesso solo ai database che gli sono assegnati.
- Alla creazione del cluster, il passaggio Users della procedura guidata chiede per ogni utente un Database applicativo e un Role.
- In seguito, Create a user e Manage Access permettono di assegnare uno o più accessi. Un utente salvato senza accessi non ha diritti su alcun database.
- La colonna Databases dell'elenco degli utenti mostra ogni database con il ruolo, ad esempio
myapp (Administrator).
I database di sistema mysql, information_schema, performance_schema e sys non possono ricevere accessi: la console mostra «“mysql” is a system database: choose an application database.» e l'API rifiuta la richiesta. Non possono nemmeno essere creati né eliminati.
La procedura guidata di creazione del cluster assegnava in precedenza a ogni utente un ruolo sul database di sistema mysql, che contiene gli account e i diritti del server: un accesso Administrator su questo database consente di modificare i diritti di tutti gli utenti, un accesso Read-only di leggere gli hash delle password. Per questi utenti, apra Actions → Manage Access: la riga mysql vi appare in errore. La rimuova, aggiunga se necessario il database applicativo dell'utente, quindi faccia clic su Save.
La password di un utente è generata dalla piattaforma e mostrata una sola volta. In caso di smarrimento, ne generi una nuova con Change Password.
Regole di denominazione
| Elemento | Regola |
|---|---|
| Nome del cluster | Da 3 a 16 caratteri: lettere minuscole, cifre e trattini; inizia con una lettera, termina con una lettera o una cifra |
| Nome utente | Da 3 a 16 caratteri: lettere minuscole, cifre e trattini; inizia con una lettera, termina con una lettera o una cifra. Alcuni nomi, come admin o root, sono riservati |
| Nome del database | Da 1 a 63 caratteri: lettere minuscole, cifre e trattini; inizia con una lettera, termina con una lettera o una cifra. I database di sistema mysql, information_schema, performance_schema e sys sono rifiutati |
I trattini bassi (_) non sono accettati né nei nomi dei database né nei nomi utente.
Preset
Il Preset definisce la capacità assegnata a ogni nodo del cluster. I preset riprendono le taglie delle macchine virtuali delle serie u1, s1 e m1: un preset ha le stesse risorse della VM con lo stesso nome. Fa fede l'elenco mostrato dalla procedura guidata:
| Preset | CPU | Memoria |
|---|---|---|
u1.medium | 1 | 4Gi |
u1.large | 2 | 8Gi |
u1.xlarge | 4 | 16Gi |
u1.2xlarge | 8 | 32Gi |
u1.4xlarge | 16 | 64Gi |
u1.8xlarge | 32 | 128Gi |
s1.small | 1 | 2Gi |
s1.medium | 2 | 4Gi |
s1.large | 4 | 8Gi |
s1.xlarge | 8 | 16Gi |
s1.2xlarge | 16 | 32Gi |
s1.4xlarge | 32 | 64Gi |
m1.large | 2 | 16Gi |
m1.xlarge | 4 | 32Gi |
m1.2xlarge | 8 | 64Gi |
m1.4xlarge | 16 | 128Gi |
m1.8xlarge | 32 | 256Gi |
La procedura guidata non preseleziona alcun preset: ne scelga uno per proseguire. Ogni opzione indica le sue risorse, ad esempio « u1.medium — 1 CPU / 4Gi ». Se l'elenco non può essere caricato, la procedura guidata mostra « The preset list could not be loaded. Try again later or contact support. »
Un cluster creato con un vecchio preset (nano, micro, small, medium, large, xlarge o 2xlarge) lo conserva e funziona come prima: il modulo Edit lo mostra così com'è e lo salva senza modifiche. Poiché il preset non può essere modificato dopo la creazione, contatti il supporto per questa modifica. Se le risorse di un cluster sono state fissate al di fuori del suo preset, il modulo lo indica con la menzione « (override) ».
La definizione di risorse CPU/memoria libere non è proposta nella console; contatti il supporto.
Accesso di rete
- Host interno: sempre assegnato, visualizzato nella zona Internal del riquadro Connection and network. Punta al server che accetta le scritture ed è raggiungibile dalle VM e dai cluster Kubernetes dello stesso progetto, non da un altro progetto né da Internet.
- Accesso esterno disattivato (impostazione predefinita): il cluster non è esposto su Internet. La zona External mostra Disabled.
- Accesso esterno attivato: la piattaforma assegna un indirizzo IP pubblico, mostrato nella zona External. La porta è la porta MySQL standard,
3306.
Backup e ripristino
I cluster MariaDB si salvano verso un bucket S3 del progetto e si ripristinano dalla scheda Backups della loro pagina, con il servizio di backup. Consulti Configurare i backup e Ripristinare un backup.
Quota e costo
La procedura guidata mostra l'Estimated cost e l'impatto del cluster sulla quota del progetto. Se il cluster supera la quota disponibile, il pulsante Next resta inattivo.
| Parametro | Valore |
|---|---|
| Versioni | 10.6, 10.11, 11.4, 11.8; dopo la creazione, solo aggiornamento di versione |
| Repliche | 1, 3 o 5 |
| Dimensione del disco | Da 1 a 4.096 GB, entro il limite della quota di storage del progetto; dopo la creazione, solo aumento |
Per approfondire
- Panoramica: presentazione del servizio
- Avvio rapido: creare il suo primo cluster