Instanz konfigurieren

Memorystore for Valkey unterstützt eine Teilmenge der Valkey-Konfigurationsparameter, die Sie ändern können, um das Verhalten Ihrer Instanz anzupassen.

Konfigurationsänderungen erfordern keinen Neustart der Instanz und unterbrechen den Dienst nicht. Memorystore for Valkey speichert Ihre Änderungen sofort. Wenn die Instanz neu gestartet wird, bleiben Ihre Konfigurationsänderungen erhalten. Nach dem Erstellen einer Instanz können Sie die änderbaren Konfigurationsparameter aktualisieren. Weitere Informationen finden Sie unter Unterstützte Instanzkonfigurationen.

Hinweis

Stellen Sie sicher, dass die aktuelle Version des Google Cloud CLI installiert ist. Verwenden Sie den gcloud components update Befehl, um eine vorhandene Installation zu aktualisieren.

Konfigurationsparameter ansehen

Verwenden Sie den gcloud memorystore instances describe Befehl, um Konfigurationsparameter anzusehen.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz
  • REGION_ID: die Region, in der sich die Instanz befindet

Beispiel:

gcloud memorystore instances describe my-instance --location=us-central1

Wenn Sie keine Konfigurationsparameter von ihren Standardwerten ändern, werden die Parameter nicht in der Ausgabe angezeigt.

Konfigurationsparameter beim Erstellen einer Instanz festlegen

Verwenden Sie den
gcloud memorystore instances create Befehl mit dem --engine-configs Flag, um beim Erstellen einer Instanz einen Konfigurationsparameter festzulegen.

gcloud memorystore instances create INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--node-type=NODE_TYPE \
--mode=MODE \
--shard-count=SHARD_COUNT \
--engine-configs=CONFIG_NAME=CONFIG_VALUE

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz, die Sie erstellen.
  • REGION_ID: die Region, in der sich die Instanz befinden soll.
  • PROJECT_ID: Ihre Projekt-ID.

  • NODE_TYPE: der Knotentyp für die Instanz.

  • MODE: gibt an, ob Sie eine Instanz mit aktiviertem oder deaktiviertem Cluster modus erstellen. Wenn Sie dieses Feld weglassen, erstellt Memorystore for Valkey standardmäßig eine Instanz mit aktiviertem Clustermodus. Weitere Informationen finden Sie unter Clustermodus aktivieren und deaktivieren.

  • SHARD_COUNT: die Anzahl der Shards in Ihrer Instanz. Die Anzahl der Shards bestimmt die Gesamtarbeitsspeicherkapazität zum Speichern von Instanzdaten.

    Wenn der ausgewählte Modus „Clustermodus deaktiviert“ ist, können Sie nur einen Shard für Ihre Instanz angeben. Weitere Informationen finden Sie unter Instanz- und Knotenspezifikation.

  • CONFIG_NAME: der Name des Konfigurationsparameters, den Sie festlegen möchten.

  • CONFIG_VALUE: der Wert des Parameters, den Sie festlegen.

Beispiel:

Beispiel für aktivierten Clustermodus

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --shard-count=3 --engine-configs=maxmemory-policy=allkeys-lru

Beispiel für deaktivierten Clustermodus

  gcloud memorystore instances create my-instance --location=us-east1 --project=my-project --node-type=highmem-medium --mode=cluster-disabled --shard-count=1 --engine-configs=maxmemory-policy=allkeys-lru

Konfigurationsparameter aktualisieren

Verwenden Sie den
gcloud memorystore instances update Befehl mit dem --update-engine-configs Flag, um einen Konfigurationsparameter für eine vorhandene Instanz zu aktualisieren.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--update-engine-configs=CONFIG_NAME=CONFIG_VALUE

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz
  • REGION_ID: die Region, in der sich die Instanz befindet
  • PROJECT_ID: Ihre Projekt-ID
  • CONFIG_NAME: der Name des Konfigurationsparameters, den Sie aktualisieren möchten
  • CONFIG_VALUE: der neue Wert des Parameters

Beispiel:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --update-engine-configs=maxmemory-policy=allkeys-lru

Weitere Informationen dazu, welche Konfigurationsparameter Sie aktualisieren können, finden Sie unter Änderbare Konfigurationsparameter.

Konfigurationsparameter zurücksetzen

Verwenden Sie den
gcloud memorystore instances update Befehl mit dem --remove-engine-configs Flag, um einen Konfigurationsparameter auf den Standardwert zurückzusetzen.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--remove-engine-configs=CONFIG_NAME

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz
  • REGION_ID: die Region, in der sich die Instanz befindet
  • PROJECT_ID: Ihre Projekt-ID
  • CONFIG_NAME: der Name des Konfigurationsparameters, den Sie auf den Standardwert zurücksetzen möchten

Beispiel:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --remove-engine-configs=maxmemory-policy

Alle Konfigurationsparameter zurücksetzen

Verwenden Sie den
gcloud memorystore instances update Befehl mit dem --clear-engine-configs Flag, um alle Konfigurationsparameter auf ihre Standardwerte zurückzusetzen.

gcloud memorystore instances update INSTANCE_ID \
--location=REGION_ID \
--project=PROJECT_ID \
--clear-engine-configs

Ersetzen Sie die folgenden Werte:

  • INSTANCE_ID: die ID der Instanz
  • REGION_ID: die Region, in der sich die Instanz befindet
  • PROJECT_ID: Ihre Projekt-ID

Beispiel:

gcloud memorystore instances update my-instance --location=us-east1 --project=my-project --clear-engine-configs