Key Value Store-Instanz erstellen und verwalten

Voraussetzungen

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

Instanzeigenschaften

Unabhängig von der Methode, die Sie zum Erstellen und Verwalten einer Instanz wählen, gibt es gemeinsame Eigenschaften für eine Key Value Store-Instanz.

Allgemeine Informationen

Instanzname

Der Instanzname legt den lesbaren Anzeigenamen für Ihre Instanz fest.

Instanzversion

Diese Einstellung bestimmt, welche Key Value Store-Version für Ihre Instanz bereitgestellt wird.

STACKIT aktualisiert die Hauptversion (Major Version) gemäß den offiziellen Releases von Valkey mit einer angemessenen Verzögerung für Tests und Implementierung. STACKIT überspringt bestimmte Nebenversionen (Minor Versions). Lesen Sie die Release Notes für Abkündigungshinweise und Ankündigungen aktualisierter Versionen.

Aus Sicherheitsgründen kündigt STACKIT Key Value Store-Versionen ab, wenn sie ihren End-of-Life-Status (EOL) erreichen. Zudem wendet STACKIT kleinere Updates aus Sicherheitsgründen automatisch an.

Plan

Wählen Sie den Plan, der am besten zu Ihrer Arbeitslast (Workload) passt. Es ist sicher, mit einem kleineren Plan zu beginnen und später auf einen größeren zu upgraden. Abhängig von der gewählten Key Value Store-Version sind bestimmte Pläne möglicherweise nicht verfügbar.

Ein Plan bestimmt die Anzahl der Knoten, vCPUs, RAM und die Speichergröße. Eine detaillierte Referenz der verfügbaren Pläne finden Sie unter Pläne für Key Value Store.

Anzahl der Knoten

Die Anzahl der Knoten bestimmt Ihre horizontale Skalierung und Hochverfügbarkeit (High Availability, HA). Horizontale Skalierung erhöht die Verfügbarkeit und die Leseleistung. Der Single-Plan (1 Knoten) bietet keine horizontale Skalierung. Ein Replica-Plan (3 Knoten) bietet horizontale Skalierung und erreicht dadurch Hochverfügbarkeit.

Anwendungsfall	Plan
Entwicklung	Single (1 Knoten)
Produktion	Replica (3 Knoten)

Anzahl der vCPUs

Die Anzahl der vCPUs bestimmt, wie viel Rechenleistung jeder Knoten Ihrer Instanz hat. Folgen Sie der Anleitung Key Value Store-Instanz planen, um die beste Option für Ihre Arbeitslast zu finden.

Arbeitsspeicher (RAM)

Die RAM-Einstellung bestimmt, wie viel Arbeitsspeicher jeder Knoten Ihrer Instanz hat. Folgen Sie der Anleitung Key Value Store-Instanz planen, um die beste Option für Ihre Arbeitslast zu finden.

Speicherkapazität (Disk size)

Die Speicherkapazität bestimmt die Kapazität des zugrunde liegenden Speichers. Die kleinste Option beträgt 10 GB. Sie können mit dieser Größe beginnen und den Speicher später durch ein Upgrade des Plans vergrößern.

Sie können die Rechenressourcen Ihres Plans jederzeit upgraden und downgraden. Bitte beachten Sie, dass Sie die Speicherkapazität nicht verkleinern (downgraden) können. Alle Skalierungsvorgänge führen zu einer kurzen Ausfallzeit (Downtime).

Benutzerdefinierte Parameter

Speicherschwellenwert (Disk threshold)

Datenbankinstanzen sind anfällig für Situationen, in denen der Speicherplatz vollständig belegt ist. Um dies zu verhindern, bietet STACKIT eine Notfallfunktion (Parachute Feature). Sie stoppt die Datenbank automatisch, wenn ein vordefinierter Speichernutzungsschwellenwert (in Prozent) erreicht wird.

Diesen Schwellenwert legen Sie mit dieser Einstellung fest. Sie können diese Funktion deaktivieren, indem Sie den Schwellenwert auf 100 % setzen.

ACL

Einträge in der Access Control List (ACL) steuern, welche Quell-IP-Adressen sich mit Ihrer Instanz verbinden können. Dies ist eine zusätzliche Sicherheitsebene und ersetzt nicht die Notwendigkeit einer ordnungsgemäßen Authentifizierung und von Best Practices für die Sicherheit.

Um sicherzustellen, dass Sie von anderen STACKIT-Cloud-Diensten auf Ihre Instanz zugreifen können, müssen Sie die öffentlichen IP-Bereiche von STACKIT zu Ihrer ACL hinzufügen. Da sich diese Bereiche im Laufe der Zeit ändern können, können Sie die aktuellste Liste dynamisch über die STACKIT CLI abrufen:

stackit auth login
stackit curl "[https://iaas.api.stackit.cloud/v2/networks/public-ip-ranges](https://iaas.api.stackit.cloud/v2/networks/public-ip-ranges)"

Sie erhalten eine JSON-Antwort, die die aktuellen CIDR-Blöcke gruppiert nach Regionen enthält. Fügen Sie die cidr-Werte, die für die Region Ihrer Instanz relevant sind, zu Ihren ACL-Einträgen hinzu.

{
  "items": [
    {
      "cidr": "192.214.160.0/19",
      "region": "eu01"
    },
    {
      "cidr": "193.148.164.0/22",
      "region": "eu01"
    },
    // ... weitere IP-Bereiche ...
    {
      "cidr": "9.206.0.0/22",
      "region": "eu02"
    }
  ]
}

Wenn Sie aus dem öffentlichen Internet auf Ihre Instanz zugreifen möchten, müssen Sie die IPv4-Adresse oder das Subnetz Ihres Clients hinzufügen. Die Einträge folgen der CIDR-Notation. Wenn Sie eine einzelne IP-Adresse zulassen möchten (zum Beispiel einen einzelnen Host), legen Sie 32 als Subnetzparameter fest. Beispiel: Um einem Host mit der Quell-IPv4-Adresse 93.229.84.137 Zugriff zu gewähren, fügen Sie 93.229.84.137/32 als ACL-Eintrag hinzu.

Das Hinzufügen von IPv6-Adressen wird nicht unterstützt.

Setzen Sie 0.0.0.0/0 nicht als ACL-IP-Adresse ein, da Ihre Instanz dadurch für den Zugriff von jeder beliebigen IP-Adresse im Internet geöffnet wird.

Instanz erstellen

Eine übergreifende Verwaltung zwischen STACKIT Portal/CLI und Cloud Foundry ist nicht möglich. Lesen Sie Service-Isolierung zwischen STACKIT Portal/CLI und Cloud Foundry, um weitere Informationen zu erhalten.

STACKIT CLI

Serviceplan und Speicherklasse auswählen

Bestimmen Sie zunächst, welchen Plan Sie benötigen. Die verfügbaren Pläne hängen von der gewählten Version ab. Um eine Liste der verfügbaren Pläne zu erhalten, führen Sie Folgendes aus:

stackit key-value-store plans

Eigenschaften für Ihre Instanz auswählen

Flag	Optionen	Standard	Optional
--name	my-keyvalue-instance
--plan-id	Siehe Pläne für Key Value Store
--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

Erfahren Sie mehr über die Optionen bei den Plänen für Key Value Store.

Befehl zur Erstellung ausführen

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

stackit key-value-store instance create --name <name> --plan-id <plan-id> --version <version> --acl <acl>

Nach Ausführung des Befehls müssen Sie durch Eingabe von 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: 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71

Beispiel

Erstellen einer Instanz mit den minimal erforderlichen Flags:

stackit key-value-store instance create --name my-keyvalue-instance --plan-id 3849f72f-99cc-4e2c-afda-700d66ef08f2

STACKIT Portal

1. Navigieren Sie im STACKIT Portal zu Key Value Store.
2. Wählen Sie in der oberen Leiste Key Value Store erstellen. Siehe Instanzeigenschaften für ein besseres Verständnis aller Optionen.
3. Nachdem Sie die Instanz konfiguriert haben, sehen Sie zur Kostenkontrolle die Preisschätzung auf der rechten Seite. Um die Erstellung abzuschließen, klicken Sie auf Kostenpflichtig bestellen. Das System fügt Ihre neu erstellte Instanz zur Liste Ihrer Key Value Store-Instanzen hinzu.
4. Nach einigen Sekunden wechselt der Instanzstatus zu Aktiv. Ihre Key Value Store-Instanz ist einsatzbereit.

Cloud Foundry CLI

1. Melden Sie sich zuerst an Ihrem STACKIT-Projekt-Endpunkt an. Lesen Sie Interaktion mit Cloud Foundry für Hilfe bei der Anmeldung.

2. Erstellen Sie die Instanz mit dem cf-Befehl:

   Parameter	Bedeutung	Beispiel
   key-value-plan	Ein verfügbarer Plan für Ihre Instanz. Siehe Servicepläne für Key Value Store.	keyvalue-1.2.10-replica
   individual-service-name	Der benutzerdefinierte Name Ihres Dienstes. Sie können diesen frei wählen.	my-cf-keyvalue-service

   Befehl:

   cf create-service appcloud-keyvalue8 [key-value-plan] [individual-service-name]

   Beispiel:

   cf create-service appcloud-keyvalue8 keyvalue-1.2.10-replica my-cf-keyvalue-service

Instanz anzeigen

STACKIT CLI

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

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

Befehl:

stackit key-value-store instance describe <INSTANCE_ID>

Beispielausgabe:

ID                    │ 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
NAME                  │ my-keyvalue-instance
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION TYPE   │ create
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
LAST OPERATION STATE  │ succeeded
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
PLAN ID               │ 3849f72f-99cc-4e2c-afda-700d66ef08f2
──────────────────────┼───────────────────────────────────────────────────────────────────────────────────────
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. Navigieren Sie im STACKIT Portal zu Key Value Store.
2. Wählen Sie die Instanz, die Sie anzeigen möchten.

Cloud Foundry CLI

1. Melden Sie sich zuerst an Ihrem STACKIT-Projekt-Endpunkt an. Lesen Sie Interaktion mit Cloud Foundry für Hilfe bei der Anmeldung.

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

   Dienste auflisten:

   cf services | grep keyvalue

   Details eines Dienstes anzeigen:

   cf service [service-name]

Instanz bearbeiten

Pläne, die die Speicherkapazität betreffen, können nur vergrößert, aber nicht verkleinert werden.

STACKIT CLI

Sie können die folgenden Eigenschaften einer Instanz bearbeiten: acl, plan und version. Eine Referenz für diese Flags finden Sie im Abschnitt Instanz erstellen.

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

Flags	Datentyp	Einheit
--acl	Array von Strings
--plan-id	String	-
--plan-name	String	-
--version	String	-

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

stackit key-value-store instance update <INSTANCE_ID> --<Flag-Name> <Flag-Wert>

Beispiel

stackit key-value-store instance update 1737d9b7-ad6d-4a86-807a-bae5c5f5ed71 --plan-id 8309378b-3f85-403a-bf42-525d07cfdf78

STACKIT Portal

Um den Plan zu ändern, gehen Sie wie folgt vor:

1. Navigieren Sie im STACKIT Portal zu Key Value Store.
2. Wählen Sie die Instanz, die Sie bearbeiten möchten.
3. Im Bereich Pläne sehen Sie die Übersicht. Wählen Sie einen Plan und gehen Sie auf Ändern.
4. Wählen Sie im Pop-up-Fenster Kostenpflichtig bestellen.
5. Warten Sie, bis die Datenbank wieder den Status Aktiv hat.

Um ACL und den Speicherschwellenwert zu ändern, gehen Sie wie folgt vor:

1. Navigieren Sie im STACKIT Portal zu Key Value Store.
2. Wählen Sie die Instanz, die Sie bearbeiten möchten.
3. Gehen Sie in der Übersicht im Bereich Benutzerdefinierte Parameter auf Bearbeiten.
4. Nehmen Sie Ihre Änderungen vor und gehen Sie auf Speichern.
5. Warten Sie, bis die Datenbank wieder den Status Aktiv hat.

Instanz löschen

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

Eine übergreifende Verwaltung zwischen STACKIT Portal/CLI und Cloud Foundry ist nicht möglich. Lesen Sie Service-Isolierung zwischen STACKIT Portal/CLI und Cloud Foundry, um weitere Informationen zu erhalten.

STACKIT CLI

Um eine Instanz zu löschen, führen Sie aus:

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

Befehl:

stackit key-value-store instance delete <INSTANCE_ID>

Sie erhalten die folgende Ausgabe:

Deleted instance "my-keyvalue-instance"

STACKIT Portal

1. Navigieren Sie im STACKIT Portal zu Key Value Store.
2. Wählen Sie im Drei-Punkte-Menü der Instanz Löschen.
3. Geben Sie den genauen Namen der Instanz ein und bestätigen Sie mit Löschen.

Cloud Foundry CLI

1. Melden Sie sich zuerst an Ihrem STACKIT-Projekt-Endpunkt an. Lesen Sie Interaktion mit Cloud Foundry für Hilfe bei der Anmeldung.

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

   cf delete-service [service-name]