Configura un'istanza

Memorystore for Valkey supporta un sottoinsieme dei parametri di configurazione di Valkey che puoi modificare per personalizzare il comportamento della tua istanza.

Le modifiche alla configurazione non richiedono il riavvio dell'istanza e non interrompono il servizio. Memorystore for Valkey salva immediatamente le modifiche. Se l'istanza viene riavviata, mantiene le modifiche alla configurazione. Dopo aver creato un'istanza, puoi aggiornare i parametri di configurazione modificabili. Per saperne di più, consulta Configurazioni di istanze supportate.

Prima di iniziare

Assicurati di installare l'ultima versione di Google Cloud CLI. Per aggiornare un'installazione esistente, utilizza il gcloud components update comando.

Visualizzare i parametri di configurazione

Per visualizzare i parametri di configurazione, utilizza il gcloud memorystore instances describe comando.

gcloud memorystore instances describe INSTANCE_ID --location=REGION_ID

Assicurati di sostituire quanto segue:

  • INSTANCE_ID: l'ID dell'istanza
  • REGION_ID: la regione in cui si trova l'istanza

Ad esempio:

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

Se non modifichi i parametri di configurazione rispetto ai valori predefiniti, questi non vengono visualizzati nell'output.

Impostare un parametro di configurazione quando crei un'istanza

Per impostare un parametro di configurazione quando crei un'istanza, utilizza il
gcloud memorystore instances create comando con il --engine-configs flag.

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

Assicurati di sostituire quanto segue:

  • INSTANCE_ID: l'ID dell'istanza che stai creando.
  • REGION_ID: la regione in cui vuoi che si trovi l'istanza.
  • PROJECT_ID: il tuo ID progetto.

  • NODE_TYPE: il tipo di nodo per l'istanza.

  • MODE: indica se stai creando un'istanza con modalità cluster abilitata o con modalità cluster disabilitata. Se ometti questo campo, per impostazione predefinita Memorystore for Valkey crea un'istanza con modalità cluster abilitata. Per saperne di più, consulta Abilitare e disabilitare la modalità cluster.

  • SHARD_COUNT: il numero di shard nella tua istanza. Il numero di shard determina la capacità di memoria totale per l'archiviazione dei dati dell'istanza.

    Se la modalità selezionata è Modalità cluster disabilitata, puoi specificare un solo shard per l'istanza. Per saperne di più, consulta Specifiche di istanze e nodi.

  • CONFIG_NAME: il nome del parametro di configurazione che vuoi impostare.

  • CONFIG_VALUE: il valore del parametro che stai impostando.

Ad esempio:

Esempio di modalità cluster abilitata

  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

Esempio di modalità cluster disabilitata

  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

Aggiornare un parametro di configurazione

Per aggiornare un parametro di configurazione per un'istanza esistente, utilizza il
gcloud memorystore instances update comando con il --update-engine-configs flag.

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

Assicurati di sostituire quanto segue:

  • INSTANCE_ID: l'ID dell'istanza
  • REGION_ID: la regione in cui si trova l'istanza
  • PROJECT_ID: il tuo ID progetto
  • CONFIG_NAME: il nome del parametro di configurazione che vuoi aggiornare
  • CONFIG_VALUE: il nuovo valore del parametro

Ad esempio:

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

Per saperne di più sui parametri di configurazione che puoi aggiornare, consulta Parametri di configurazione modificabili.

Reimpostare un parametro di configurazione

Per reimpostare un parametro di configurazione sul valore predefinito, utilizza il
gcloud memorystore instances update comando con il --remove-engine-configs flag.

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

Assicurati di sostituire quanto segue:

  • INSTANCE_ID: l'ID dell'istanza
  • REGION_ID: la regione in cui si trova l'istanza
  • PROJECT_ID: il tuo ID progetto
  • CONFIG_NAME: il nome del parametro di configurazione che vuoi reimpostare sul valore predefinito

Ad esempio:

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

Reimpostare tutti i parametri di configurazione

Per reimpostare tutti i parametri di configurazione sui valori predefiniti, utilizza il
gcloud memorystore instances update comando con il --clear-engine-configs flag.

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

Assicurati di sostituire quanto segue:

  • INSTANCE_ID: l'ID dell'istanza
  • REGION_ID: la regione in cui si trova l'istanza
  • PROJECT_ID: il tuo ID progetto

Ad esempio:

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