Instanzen erstellen und verwalten

Voraussetzungen

• Sie haben ein STACKIT-Kundenkonto: Kundenkonto erstellen
• Sie haben ein STACKIT-Benutzerkonto: Benutzerkonto erstellen
• Sie haben ein STACKIT-Projekt: Projekt erstellen

Instanzeigenschaften

Unabhängig von der Methode, die Sie zum Erstellen und Verwalten einer Instanz wählen, gibt es gemeinsame Eigenschaften einer STACKIT MariaDB-Instanz.

Allgemeine Informationen

Instanzname

Mit dem Instanznamen legen Sie den Anzeigenamen für Ihre Instanz fest.

MariaDB-Version

Mit der MariaDB-Version bestimmen Sie, welche MariaDB-Version zum Einsatz kommt. STACKIT aktualisiert die MariaDB-Hauptversion entsprechend den Veröffentlichungen von MariaDB mit einer angemessenen Verzögerung für die Implementierung. Gegebenenfalls werden einige Versionen übersprungen. Lesen Sie die Release Notes für Abkündigungshinweise und Ankündigungen neuer Versionen. Aus Sicherheitsgründen wird STACKIT MariaDB-Versionen abkündigen, wenn diese ihren EOL-Status erreichen. Darüber hinaus spielt STACKIT aus Sicherheitsgründen Minor-Updates ein.

Edition

Wählen Sie die Edition aus, die zu Ihrem Workload passt. Es ist sicher, mit einem kleineren Flavor zu beginnen und später zu einem größeren zu wechseln. Abhängig von der gewählten MariaDB-Version sind einige Editionen nicht verfügbar. Eine Edition bestimmt die Anzahl der Knoten, vCPUs, den Speicher und die Festplattengröße. Eine detaillierte Referenz der verfügbaren Editionen finden Sie unter Servicepläne von MariaDB.

Anzahl der Knoten

Mit der Anzahl der Knoten können Sie die horizontale Skalierung und Hochverfügbarkeit bestimmen. Horizontale Skalierung erhöht die Verfügbarkeit und die Leseleistung. Die Single-Edition (1 Knoten) bietet keine horizontale Skalierung. Eine Replica-Edition (3 Knoten) bietet horizontale Skalierung und erreicht somit Hochverfügbarkeit.

Expand

Anwendungsfall	Edition
Entwicklung	Single (1 Knoten)
Produktion (normal)	Replica (3 Knoten)

Anzahl der vCPUs

Mit der Anzahl der vCPUs bestimmen Sie, wie viel Rechenleistung jeder Knoten Ihrer Instanz hat. Folgen Sie der Anleitung Planung Ihrer MariaDB-Instanz, um die beste Option für Ihren Workload zu finden.

Speicher

Mit der Speicher-Einstellung bestimmen Sie, wie viel RAM jeder Knoten Ihrer Instanz hat. Folgen Sie der Anleitung Planung Ihrer MariaDB-Instanz, um herauszufinden, wie Sie die beste Option für Ihren Workload finden.

Festplattengröße

Mit der Festplattengröße bestimmen Sie die Größe des zugrunde liegenden Speichers. Die kleinste Option beträgt 10 GB. Sie können diese Größe sicher wählen und die Festplatte später durch Ändern der Edition vergrößern.

Sie können die MariaDB-Edition jederzeit herauf- oder herabstufen. Bitte beachten Sie, dass Sie die Festplattengröße nicht herabstufen können. Bei allen möglichen Vorgängen wird es zu einer Downtime kommen.

Benutzerdefinierte Parameter

Festplatten-Schwellenwert

MariaDB-Instanzen sind anfällig für Situationen mit vollem Speicher. Um dies zu verhindern, bietet STACKIT MariaDB eine Fallschirm-Funktion. Sie stoppt die Datenbank, wenn ein vordefinierter Schwellenwert für die Festplattennutzung (in Prozent) erreicht ist. Mit dieser Einstellung definieren Sie diesen Schwellenwert. Sie können diese Funktion praktisch deaktivieren, indem Sie 100% als Schwellenwert definieren.

ACL

Mit den ACL-Einträgen steuern Sie, welche Quell-IPs eine Verbindung zu Ihrer Instanz herstellen dürfen. Beachten Sie, dass dies eine zusätzliche Sicherheitsebene ist und die Notwendigkeit einer ordnungsgemäßen Authentifizierung und bewährter Sicherheitspraktiken nicht ersetzt. Es gibt zwei vordefinierte Einträge: 193.148.160.0/19 und 45.129.40.0/21. Diese stellen sicher, dass Sie von STACKIT-Cloud-Diensten aus auf Ihre Instanz zugreifen können. Wenn Sie aus dem öffentlichen Netz auf Ihre Instanz zugreifen möchten, müssen Sie die IPv4-Adresse oder das Subnetz des Clients hinzufügen. Die Einträge folgen der CIDR-Notation. Wenn Sie eine einzelne IP-Adresse zulassen möchten (z. B. einen einzelnen Host), setzen Sie 32 als Subnetz-Parameter. Um beispielsweise einen Host mit der Quell-IPv4-Adresse 93.229.84.137 zuzulassen, fügen Sie 93.229.84.137/32 als ACL-Eintrag hinzu. Derzeit können Sie keine IPv6-Adressen hinzufügen.

Setzen Sie 0.0.0.0/0 nicht als ACL-IP, da dann von jeder beliebigen IP aus auf Ihre Instanz zugegriffen werden kann.

Eine Instanz erstellen

Um eine Instanz zu erstellen, rufen Sie zunächst das STACKIT Portal auf und melden Sie sich an.

STACKIT CLI

Flavor und Speicherklasse wählen

Zuerst müssen Sie bestimmen, welche Edition Sie benötigen. Die verfügbaren Editionen hängen von der gewählten Version ab. Um eine Liste der verfügbaren Editionen zu erhalten, führen Sie aus:

stackit mariadb plans

Eigenschaften für Ihre neue Instanz wählen

Expand

Flag	Optionen	Standard	Optional
name	meine-mariadb-instanz
plan-id	Siehe Servicepläne von MariaDB
version	10.6, 10.11	10.11	x
acl	IPv4 und Netz in CIDR-Notation	193.148.160.0/19 45.129.40.0/21 45.135.244.0/22 192.214.174.229/32 192.214.176.140/32	x

Sie können auch einen Blick auf die Servicepläne von MariaDB werfen, um mehr über die verfügbaren Editionen zu erfahren.

Erstellungsbefehl ausführen

Um Ihre Instanz zu erstellen, führen Sie den folgenden Befehl aus:

stackit mariadb instance create --name <name> --plan-id <plan-id> --version <version --acl <acl>

Nach Ausführung des Befehls müssen Sie mit „y” bestätigen.

Wenn die Instanz erfolgreich erstellt wurde, gibt die CLI die Instanz-ID zurück:

Created instance for project "Test-Projekt-28-07-2025". Instance ID: 1226c9a1-62cd-4ec1-bf42-7b15d54c00d9

Beispiele

Erstellen Sie eine Instanz mit minimalen Flags:

stackit mariadb instance create --name my-mariadb-instance --plan-id ddf1b3f5-c559-4869-83ad-72264655132c

STACKIT Portal

1. Klicken Sie in der Seitenleiste auf MariaDB.

2. Klicken Sie in der Leiste am oberen Rand auf MariaDB erstellen.

   Siehe Instanzeigenschaften für ein besseres Verständnis aller Optionen.

3. Nachdem Sie alles nach Ihren Bedürfnissen konfiguriert haben, erstellen Sie Ihre Instanz.

   Zur Kostenkontrolle sehen Sie auf der rechten Seite eine Preisschätzung. Um die Instanz endgültig zu erstellen, klicken Sie auf Kostenpflichtig bestellen. Das System fügt Ihre neu erstellte Instanz zur Liste Ihrer MariaDB-Instanzen hinzu. Nach wenigen Sekunden ändert sich Ihr Instanzstatus von Ausstehend … auf Aktiv. Herzlichen Glückwunsch, Ihre MariaDB-Instanz ist bereit und läuft!

Cloud Foundry CLI

1. Um die Cloud Foundry CLI zu verwenden, müssen Sie sich zunächst an Ihrem STACKIT-Projekt-Endpunkt anmelden. Lesen Sie Interaktion mit Cloud Foundry, um Hilfe bei der Anmeldung zu erhalten.

2. Erstellen Sie den MariaDB-Dienst mit dem cf-Befehl:

   Expand

   Parameter	Bedeutung	Beispiel
   mariadb-plan	Eine verfügbare Edition für Ihre Instanz. Siehe Servicepläne für MariaDB, um mehr über verfügbare Editionen zu erfahren.	mariadb-1.2.10-replica
   individual-service-name	Der Name Ihres Dienstes. Sie können diesen frei wählen.	my-cf-mariadb-service

   cf create-service appcloud-mariadb1011 [mariadb-plan] [individual-service-name]

   Beispiel:

   cf create-service appcloud-mariadb1011 mariadb-1.2.10-replica my-cf-mariadb-service

   Übergreifende Verwaltung zwischen STACKIT Portal/CLI und Cloud Foundry ist nicht möglich

   Lesen Sie Dienstisolierung zwischen STACKIT Portal/CLI und Cloud Foundry, um weitere Informationen zu erhalten.

Eine Instanz anzeigen

STACKIT CLI

Um eine Instanz anzuzeigen, führen Sie den Befehl mit den folgenden Parametern aus:

Expand

Argument	Beschreibung
INSTANCE_ID	Instanz-ID der Instanz, die Sie abfragen möchten

stackit mariadb instance describe <INSTANCE_ID>

Beispielhafte Ausgabe:

ID                   │ 1226c9a1-62cd-4ec1-bf42-7b15d54c00d9
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
NAME                 │ my-mariadb-instance
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION TYPE  │ create
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION STATE │ succeeded
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
PLAN ID              │ ddf1b3f5-c559-4869-83ad-72264655132c
─────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
ACL                  │ 193.148.160.0/19,45.129.40.0/21,45.135.244.0/22,192.214.174.229/32,192.214.176.140/32

STACKIT Portal

1. Klicken Sie in der Seitenleiste auf MariaDB.
2. Klicken Sie auf die Instanz, die Sie anzeigen möchten.

Cloud Foundry CLI

1. Um die Cloud Foundry CLI zu verwenden, müssen Sie sich zunächst an Ihrem STACKIT-Projekt-Endpunkt anmelden. Lesen Sie Interaktion mit Cloud Foundry, um Hilfe bei der Anmeldung zu erhalten.

2. Listen Sie die MariaDB-Dienste auf und sehen Sie sich Details mit dem cf-Befehl an:

   Dienste auflisten

   cf services | grep mariadb

   Details eines Dienstes anzeigen

   cf service [service-name]

Eine Instanz bearbeiten

STACKIT CLI

Sie können die folgenden Eigenschaften einer Instanz bearbeiten: acl, plan und version. Eine Referenz zu diesen Flags finden Sie unter Eine Instanz erstellen.

Die MariaDB-Editionen, die den Speicher betreffen, können nur heraufgestuft werden.

Expand

Argument	Beschreibung
INSTANCE_ID	Instanz-ID der Instanz, die Sie abfragen möchten

Expand

Flags	Datentyp	Einheit
acl	Array of strings
plan-id	String	-
plan-name	String	-
version	String	-

Um die Instanz zu bearbeiten, führen Sie den folgenden Befehl aus:

stackit mariadb instance update <INSTANCE_ID> --<Flag Name> <Flag Value>

Beispiel

stackit mariadb instance update 8db6a0f2-2b93-43f3-be54-464ee5a9fbed --plan-id ddf1b3f5-c559-4869-83ad-72264655132c

STACKIT Portal

Um die Edition zu bearbeiten:

1. Klicken Sie in der Seitenleiste auf MariaDB.
2. Klicken Sie auf die Instanz, die Sie bearbeiten möchten.
3. Klicken Sie im Bereich Edition auf den Link der ausgewählten Edition neben Name der Edition.
4. Klicken Sie neben der gewünschten Edition auf Ändern.
5. Klicken Sie im Popup-Dialog auf Kostenpflichtig bestellen.
6. Warten Sie, bis die Datenbank wieder Aktiv ist.

Um die ACL und den Festplatten-Schwellenwert zu ändern:

1. Klicken Sie in der Seitenleiste auf MariaDB.
2. Klicken Sie auf die Instanz, die Sie bearbeiten möchten.
3. Klicken Sie im Bereich Benutzerdefinierte Parameter auf Bearbeiten.
4. Nehmen Sie Ihre Änderungen vor und klicken Sie auf Speichern.
5. Warten Sie, bis die Datenbank wieder Aktiv ist.

Eine Instanz löschen

STACKIT CLI

Sie können eine Instanz löschen, wenn sie sich im Zustand READY befindet. Nach Ausführung dieses Befehls kann der Vorgang nicht rückgängig gemacht werden. Um eine Instanz zu löschen, führen Sie aus:

Expand

Argument	Beschreibung
INSTANCE_ID	Instanz-ID der Instanz, die Sie abfragen möchten

stackit mariadb instance delete <INSTANCE_ID>

Sie erhalten die folgende Ausgabe:

Deleted instance "meine-MariaDB-Instanz"

STACKIT Portal

Sie können eine Instanz löschen, wenn sie sich im Zustand Aktiv befindet. Sie können einen Löschvorgang nicht rückgängig machen.

1. Klicken Sie in der Seitenleiste auf MariaDB.
2. Klicken Sie im Bereich der Instanz, die Sie löschen möchten, auf das Symbol mit den drei Punkten.
3. Klicken Sie auf Löschen.
4. Geben Sie den Namen der Instanz ein und bestätigen Sie mit Löschen.

Cloud Foundry CLI

1. Um die Cloud Foundry CLI zu verwenden, müssen Sie sich zunächst an Ihrem STACKIT-Projekt-Endpunkt anmelden. Lesen Sie Interaktion mit Cloud Foundry, um Hilfe bei der Anmeldung zu erhalten.

2. Löschen Sie einen Dienst mit dem cf-Befehl:

   Dienste auflisten

   cf delete-service [service-name]

   Übergreifende Verwaltung zwischen STACKIT Portal/CLI und Cloud Foundry ist nicht möglich

   Lesen Sie Dienstisolierung zwischen STACKIT Portal/CLI und Cloud Foundry, um weitere Informationen zu erhalten.