MariaDB in 5 Minuten bereitstellen
Diese Anleitung begleitet Sie bei der Erstellung Ihres ersten MariaDB-Clusters in der Hikube-Konsole bis zur ersten Verbindung mit dem Client mysql (oder mariadb).
Ziele
Am Ende dieser Anleitung verfügen Sie über:
- Einen MariaDB-Cluster, der in Ihrem Hikube-Projekt bereitgestellt ist
- Einen Benutzer mit Rechten auf einer Anwendungsdatenbank
- Eine funktionierende Verbindung mit einem MySQL-Client
Voraussetzungen
- Ein Hikube-Konto und ein Projekt mit ausreichenden Quotas (CPU, Arbeitsspeicher, Speicher)
- Den Client
mysqlodermariadbauf Ihrem Rechner, falls Sie eine Verbindung aus dem Internet testen möchten
Schritt 1: Den Cluster erstellen
- Melden Sie sich in der Hikube-Konsole an und wählen Sie Ihr Projekt aus.
- Öffnen Sie im Seitenmenü DB & Messaging → MariaDB. Die Seite MariaDB Clusters wird angezeigt.
- Klicken Sie auf Create a cluster. Der Assistent Create a MariaDB cluster öffnet sich.
Schritt 2: Konfigurieren und bestätigen
Der Assistent umfasst fünf Schritte: General, Configuration, Users, Summary und Finish.
General
Geben Sie den Cluster Name ein, zum Beispiel demo-mariadb (3 bis 16 Zeichen: Kleinbuchstaben, Ziffern und Bindestriche; beginnt mit einem Buchstaben, endet mit einem Buchstaben oder einer Ziffer).
Configuration
| Feld | Empfohlener Wert für diese Anleitung | Hinweis |
|---|---|---|
| MariaDB Version | 11.8 | Angebotene Versionen: 10.6, 10.11, 11.4, 11.8 |
| Preset | s1.small — 1 CPU / 2Gi | Kein Preset ist vorausgewählt; nach der Erstellung nicht änderbar |
| Disk size (GB) | 10 | Speicherkapazität pro Knoten |
| Number of replicas | 1 (Standalone) | 3 oder 5 für Hochverfügbarkeit; nach der Erstellung nicht änderbar |
| External access | Aktiviert | Erforderlich, um sich von Ihrem Rechner aus zu verbinden |
Das Banner oben im Assistenten zeigt die Estimated cost und die Auswirkung auf die Quotas des Projekts an.
Aktivieren Sie den External access nur, wenn Sie ihn benötigen: Er macht die Datenbank im öffentlichen Internet verfügbar.
Users
Fügen Sie mindestens einen Benutzer hinzu:
- Username: zum Beispiel
app-user(Kleinbuchstaben, Ziffern und Bindestriche). - Database: die Anwendungsdatenbank, auf die sich die Rolle des Benutzers bezieht, zum Beispiel
myapp(Kleinbuchstaben, Ziffern und Bindestriche). Sie wird erstellt, falls sie nicht existiert. Die Systemdatenbankenmysql,information_schema,performance_schemaundsyswerden abgelehnt. - Role: Administrator für diese Anleitung, oder Read-only.
- Klicken Sie auf Add.
Summary
Prüfen Sie die Zusammenfassung (Version, Preset, Data volume, Replicas, External exposure, Estimated cost, Users to create) und klicken Sie dann auf Create cluster.
Schritt 3: Status prüfen
Der Schritt Finish bestätigt die Erstellung („Creation complete!“). Klicken Sie auf Finish, um die Seite des Clusters zu öffnen.
| Status | Bedeutung |
|---|---|
| Creating / Provisioning | Der Cluster wird bereitgestellt |
| Ready | Der Cluster ist betriebsbereit |
| Error | Die Plattform konnte die Erstellung oder die letzte Änderung des Clusters nicht anwenden |
Erwartetes Ergebnis: Nach einigen Minuten wechselt der Status zu Ready. Die Seite zeigt die MariaDB Version, die Replicas, die Allocated Size und das Preset an.
Schritt 4: Zugangsdaten abrufen und Zugriff auf eine Datenbank gewähren
Zugangsdaten
Der Schritt Finish des Assistenten zeigt unter User Credentials das Password jedes Benutzers und, wenn der externe Zugriff aktiviert ist, den Internal Connection String (<host>:3306) an.
Kopieren Sie diese Passwörter sofort: Sie werden nicht mehr angezeigt. Bei Verlust generieren Sie im Abschnitt Users ein neues (Actions → Change Password).
Die Karte Connection and network auf der Seite des Clusters zeigt die Adressen des Clusters in zwei Bereichen an, jeweils mit einer Kopierschaltfläche:
- Internal, From the project's resources only: der interne Host, immer vorhanden, und der Port (
3306). Er ist von den VMs und Kubernetes-Clustern desselben Projekts aus erreichbar, ohne externen Zugriff; - External, From the Internet: die öffentliche Adresse, wenn der External Access aktiviert ist.
Zugriff auf die Anwendungsdatenbank
Die im Schritt Users angegebene Datenbank myapp wurde erstellt, und der Benutzer verfügt dort über die gewählte Rolle: Im Abschnitt Users der Cluster-Seite zeigt die Spalte Databases myapp (Administrator) an. Um ihm Zugriff auf weitere Datenbanken zu geben, öffnen Sie das Menü Actions des Benutzers und wählen Sie Manage Access (siehe Benutzer und Datenbanken verwalten).
Schritt 5: Verbindung und Tests
Von Ihrem Rechner aus verwenden Sie die Adresse aus dem Bereich External:
mysql -h <host> -P 3306 -u app-user -p myapp
Von einer VM oder einem Kubernetes-Cluster des Projekts aus verwenden Sie den Host aus dem Bereich Internal: mysql -h <internal-host> -P 3306 -u app-user -p myapp.
Geben Sie das Passwort ein und prüfen Sie dann die Verbindung:
SELECT VERSION();
CREATE TABLE test (id INT AUTO_INCREMENT PRIMARY KEY, message VARCHAR(100));
INSERT INTO test (message) VALUES ('Bonjour Hikube');
SELECT * FROM test;
Erwartetes Ergebnis:
+----+----------------+
| id | message |
+----+----------------+
| 1 | Bonjour Hikube |
+----+----------------+
Der Client mariadb akzeptiert dieselben Optionen: mariadb -h <host> -P 3306 -u app-user -p myapp.
Schritt 6: Schnelle Fehlerbehebung
Der Bereich External zeigt „Disabled“ oder „Waiting for allocation…“ an
„Disabled“: Der External Access ist ausgeschaltet. Aktivieren Sie ihn über Edit, wenn Sie sich aus dem Internet verbinden müssen; aus dem Projekt verwenden Sie den Host aus dem Bereich Internal. „Waiting for allocation…“: Die öffentliche Adresse ist noch nicht zugewiesen, warten Sie einige Augenblicke.
Der interne Host wird von einer VM aus nicht aufgelöst
Kopieren Sie den vollständigen Namen aus dem Bereich Internal, ohne ihn zu kürzen. Unter Debian 13 wird der Name ohne Konfiguration nicht aufgelöst: siehe Einen verwalteten Dienst des Projekts erreichen.
Access denied for user
Falsches Passwort, oder der Benutzer hat keinen Zugriff auf die angegebene Datenbank. Prüfen Sie die Spalte Databases der Benutzerliste und fügen Sie den Zugriff über Manage Access hinzu.
Die Schaltfläche Next bleibt inaktiv
- Im Schritt Configuration: Der Cluster überschreitet die Quotas des Projekts.
- Im Schritt Users: Fügen Sie mindestens einen Benutzer mit seiner Database hinzu.
Der Cluster wechselt in den Status Error
Die Plattform konnte die Erstellung oder die letzte Änderung des Clusters nicht anwenden. Wenden Sie sich an den Support und geben Sie dabei den Namen des Projekts und des Clusters an.
Schritt 7: Bereinigung
- Öffnen Sie die Seite des Clusters (DB & Messaging → MariaDB → Name des Clusters).
- Klicken Sie auf Delete cluster.
- Geben Sie den exakten Namen des Clusters in das Feld Resource name to confirm ein und klicken Sie dann auf Permanently delete.
Diese Aktion löscht den MariaDB-Cluster und alle zugehörigen Daten. Sie ist unwiderruflich.
Zusammenfassung
Sie haben in der Konsole Folgendes erstellt:
- Einen MariaDB-Cluster in Ihrem Projekt
- Einen Benutzer und eine Anwendungsdatenbank
- Einen externen Zugriff und eine Verbindung mit dem Client
mysql