Configura un'istanza

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

Le modifiche alla configurazione non richiedono il riavvio dell'istanza e vengono salvate se l'istanza viene riavviata. Puoi aggiornare i parametri di configurazione modificabili dopo aver creato un'istanza.

Per ulteriori informazioni sui parametri di configurazione modificabili, consulta Configurazioni delle istanze supportate.

Prima di iniziare

Assicurati di aver installato la versione più recente del client CLI Google Cloud 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 vedere i parametri di configurazione quando esegui il comando gcloud memorystore instances describe, a meno che non modifichi un parametro di configurazione dal relativo 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

    Per ulteriori dettagli sui tipi di nodi e sulle configurazioni delle istanze, consulta la specifica di istanze e nodi.

  • shard-count determina il numero di shard nell'istanza. Il numero di shard determina la capacità totale della memoria per l'archiviazione dei dati dell'istanza. Se selezioni la modalità Modalità cluster disabilitata, puoi specificare un solo shard per l'istanza. Per ulteriori informazioni, consulta la specifica di istanze e nodi.

  • mode determina se l'istanza è in modalità cluster abilitata o disabilitata. Se questo campo viene omesso, per impostazione predefinita l'istanza è impostata su Modalità cluster abilitata. Per ulteriori informazioni, 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

Aggiornare 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 reimpostare un parametro di configurazione sul valore predefinito, 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

Cancellare i parametri di configurazione

Per reimpostare tutti i parametri di configurazione sui 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