Configura un'istanza

Memorystore for Valkey supporta un sottoinsieme dei parametri di configurazione di OSS Valkey che puoi modificare per personalizzare il comportamento dell'istanza.

Le modifiche alla configurazione non richiedono il riavvio dei nodi e vengono salvate se un nodo viene riavviato. Dopo aver creato un'istanza, puoi aggiornare i parametri di configurazione modificabili.

Per saperne di più sui parametri di configurazione modificabili, consulta Configurazioni delle istanze supportate.

Prima di iniziare

Assicurati di aver installato l'ultima versione di Google Cloud CLI eseguendo gcloud components update.

Visualizza i parametri di configurazione

Per visualizzare i parametri di configurazione utilizzando Google Cloud CLI, esegui il comando gcloud memorystore instances describe, sostituendo variables con i valori appropriati.

Non puoi visualizzare i parametri di configurazione quando esegui il comando gcloud memorystore instances describe, a meno che tu non modifichi un parametro di configurazione rispetto al valore predefinito.

gcloud memorystore instances describe instance-id --location=region-id

Esempio:

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

Impostare un parametro di configurazione durante la creazione dell'istanza

Per impostare un parametro di configurazione durante la creazione di un'istanza, esegui il comando gcloud memorystore instances create con il flag --engine-configs, sostituendo variables con i valori appropriati.

gcloud memorystore instances create instance-id \
--location=region-id \
--project=project-id \
--node-type=node-type \
--shard-count=shard-count \
--mode=MODE
--engine-configs=config-name=config-value \

Sostituisci quanto segue:

  • instance-id è l'ID dell'istanza Memorystore for Valkey che stai creando.
  • region-id è la regione in cui vuoi posizionare l'istanza.
  • project-id è l'ID progetto.

  • node-type è il tipo di nodo scelto. I valori accettati sono:

    • shared-core-nano
    • standard-small
    • highmem-medium
    • highmem-xlarge

  • shard-count determina 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 è Cluster Mode Disabled, puoi specificare un solo shard per l'istanza. Per ulteriori informazioni, consulta Specifica di istanze e nodi.

  • mode determina se l'istanza è abilitata o disabilitata in modalità cluster. Se questo campo viene omesso, l'istanza utilizza per impostazione predefinita la modalità cluster abilitata. Per saperne di più, vedi Attivare e disattivare la modalità cluster.

  • config-name è il parametro di configurazione da modificare.

  • config-value è l'impostazione scelta corrispondente al parametro che stai configurando.

Ad esempio:

Esempio di modalità cluster abilitata

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

Esempio di modalità cluster disabilitata

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

Aggiorna un parametro di configurazione

Per aggiornare un parametro di configurazione per un'istanza esistente, esegui il comando gcloud memorystore instances update con il flag --update-engine-configs, sostituendo variables con i valori appropriati.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--update-engine-configs=config-name=config-value

Esempio:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --update-engine-configs=maxmemory-policy=allkeys-lru

Reimpostare un parametro di configurazione

Per ripristinare il valore predefinito di un parametro di configurazione, esegui il comando gcloud memorystore instances update con il flag --remove-engine-configs, sostituendo variables con i valori appropriati.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--remove-engine-configs=config-name

Esempio:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --remove-engine-configs=maxmemory-policy

Cancella parametri di configurazione

Per cancellare tutti i parametri di configurazione e ripristinare i valori predefiniti, esegui il comando gcloud memorystore instances update con il flag --clear-engine-configs, sostituendo variables con i valori appropriati.

gcloud memorystore instances update instance-id \
--location=region-id \
--project=project-id \
--clear-engine-configs

Esempio:

gcloud memorystore instances update foo --location=us-east1 --project=test-proj --clear-engine-configs